Codex design-doc-interviewer:用问答写产品和工程设计文档
EnglishCodex 安装步骤
- 打开包含 GitHub 固定提交的 Hashbrown 工作副本,保留 `.codex/skills/design-doc-interviewer/` 下的模板和问题库。
- 在仓库根目录启动 Codex,输入 `$design-doc-interviewer`。如果该工作区未发现项目技能,把完整技能目录复制到仓库根目录 `.agents/skills/` 后再选择。
中文摘要
用几轮结构化问答把初步想法整理成设计文档。它先检查仓库已有的设计约定,再逐步澄清用户体验、数据、边界条件、测试和发布要求。
SKILL.md 中文导读
可复现示例
在 Hashbrown 工作副本中输入 `$design-doc-interviewer`,以给 Angular 聊天组件增加空状态为题。说明访客尚未发送消息时要展示引导文案,并回答何时隐藏引导。工作步骤
- 确认设计文档的读者、对应包和文档格式。
- 逐轮回答少量编号问题,并记录尚未确认的决定。
- 核对测试、异常情况和成功标准后,把设计文档保存到 `design/{package}/`。
验收方法
得到归入目标包设计目录的文档,写清首次进入、发送首条消息、清空会话三种状态的行为和验收条件。
GitHub 原文 · 更新日期
适用环境
Codex 和 Hashbrown 仓库的固定版本。需要确认要归档文档的包名和 `design/` 中已有的约定。
常见问题
暂时答不上来某个问题怎么办?
可以把它列为待确认项,继续完成已经有依据的设计段落。