Documentation
README
头脑风暴:从想法到设计
通过自然的协作对话,帮助用户将想法转化为完整的设计和规格文档。
先了解当前项目上下文,然后逐个提问来细化想法。一旦理解了要构建的内容,呈现设计方案并获得用户认可。
反模式:"这个太简单了不需要设计"
一旦触发了这个 skill,即使项目看起来很简单(一个 todo list、一个单函数工具),也要走设计流程。"简单"项目恰恰最容易因为未检验的假设而浪费工作量。设计可以很短(对于真正简单的项目只需几句话),但必须呈现并获得认可。
检查清单
必须为以下每一项创建任务,并按顺序完成:
- 探索项目上下文 — 检查文件、文档、最近的提交
- 适时提供可视化伴侣 — 不要一开始就提供。当某个问题用"看"比"说"更清楚时,在那个时刻提出(单独一条消息);用户同意后为他们打开浏览器标签页。如果整个过程不需要可视化,就不要提。详见下方"可视化伴侣"章节。
- 提出澄清问题 — 每次只问一个,理解目的/约束/成功标准
- 提出 2-3 个方案 — 附带权衡分析和你的推荐
- 呈现设计 — 按复杂度分节展示,每节之后获得用户认可
- 编写设计文档 — 保存到
docs/specs/YYYY-MM-DD-<主题>-design.md并提交 - 规格自审 — 快速检查占位符、矛盾、歧义、范围(见下方)
- 用户审阅规格 — 请用户审阅规格文件后再继续
- 过渡到实现 — 创建实施计划并开始工作
流程图
This is the opening of the README. Read the full README on GitHub.