Appearance
阶段一:需求探索与确认
这一阶段做什么
这一阶段的目标是:在写代码之前,先把要做什么想清楚、说清楚、写下来。
OpenFlow 提供两个工具来完成这件事:头脑风暴(Brainstorm)和正式需求(Feature)。前者可选,后者必须。
头脑风暴:目标还不清楚时用
头脑风暴是纯对话,不生成任何正式文档。它适合你只有一个模糊方向、但还没想清楚具体要做什么的场景。
打个比方:你想去旅游,但还没想好去哪、去几天、预算多少。这时候需要的是探索和比较,而不是立刻订机票。
在项目里,类似的情况是:"我觉得用户反馈系统不太好,但不确定是改流程、改界面、还是加个新功能。"——这时候用头脑风暴。
当你对 AI 说"先 brainstorm",它会通过对话帮你拆解想法、比较方案、缩小范围。
正式需求:目标确定了,但怎么做还没定
当方向已经明确——"我要做 X"——就该进入正式需求阶段了。这个阶段会产出两份正式文档:设计文档(design.md)和行为文档(behavior.md),作为后续所有工作的依据。
继续刚才的比方:现在你决定了去日本东京,但要考虑怎么去、带什么、住哪里、行程怎么安排。目标已经确定,但方案还需要设计。
在项目里,类似的情况是:"我要给应用加一个用户资料页。"——做什么已经清楚,但涉及哪些模块、有哪些约束、怎么验证做对了,这些需要正式设计。
操作步骤
第 1 步:起步
方向不明确:运行
/openflow-brainstorm并描述你的模糊想法,比如:text/openflow-brainstorm 我觉得用户反馈系统不太好,但不确定是改流程、改界面、还是加个新功能。AI 会通过对话帮你梳理。
方向已明确:跳过头脑风暴,直接进入下一步。
第 2 步:进入正式需求
text
/openflow-feature 添加用户资料页运行后,AI 会:
- 逐步提问:一次只问一个问题,帮你把目标、约束、非目标说清楚。
- 扫描已有约束:自动读取
docs/current/和docs/decisions/,把项目的现有事实和架构决策纳入设计。 - 生成文档:确认信息足够后,生成
design.md和behavior.md,通常保存在docs/changes/{日期}-{需求名}/。
第 3 步:检查文档
重要的事说三遍:检查文档!检查文档!检查文档!
AI 生成的文档必须由你确认。这两份文档是后续所有工作的依据——开发计划照着它拆任务,质量门照着它验证,集成测试照着它写用例。
design.md:重点看目标(Goals)、非目标(Non-Goals)和约束条件(Constraints)是否准确。
behavior.md:这份文档是专门写给人类看的,也是后续集成测试的依据。逐条检查 Given/When/Then 行为描述是否符合你的预期。如果出现函数名、变量名、文件路径等实现细节,要求 AI 重写——行为文档只描述用户能看到的结果。
如果需求比较复杂,可以让 AI 审查两份文档的约束是否充分,有没有遗漏关键边界。
常见情况
| 情况 | 怎么处理 |
|---|---|
| 想法太大,一次做不完 | AI 会帮你拆分范围,把一次变更控制在可验证的边界内 |
| 头脑风暴后发现方向变了 | 正常现象,继续探索即可,头脑风暴不产生正式文档 |
| 不确定要不要进正式需求 | 继续对话澄清,不用急着运行 /openflow-feature |
| 项目已有文档和约束 | AI 会自动扫描并纳入设计,你不需要手动整理 |
阶段产出
完成这一阶段后,你的项目会多出:
docs/changes/{日期}-{需求名}/design.md— 设计文档docs/changes/{日期}-{需求名}/behavior.md— 行为文档
这两份文档是后续所有工作的依据:开发计划照着它拆任务,质量门照着它验证,归档照着它追溯。
下一步:阶段二:开发计划与实现 →