Skip to content

阶段一:需求探索与确认

这一阶段做什么

这一阶段的目标是:在写代码之前,先把要做什么想清楚、说清楚、写下来。

OpenFlow 提供两个工具来完成这件事:头脑风暴(Brainstorm)和正式需求(Feature)。前者可选,后者必须。

头脑风暴:目标还不清楚时用

头脑风暴是纯对话,不生成任何正式文档。它适合你只有一个模糊方向、但还没想清楚具体要做什么的场景。

打个比方:你想去旅游,但还没想好去哪、去几天、预算多少。这时候需要的是探索和比较,而不是立刻订机票。

在项目里,类似的情况是:"我觉得用户反馈系统不太好,但不确定是改流程、改界面、还是加个新功能。"——这时候用头脑风暴。

当你对 AI 说"先 brainstorm",它会通过对话帮你拆解想法、比较方案、缩小范围。

正式需求:目标确定了,但怎么做还没定

当方向已经明确——"我要做 X"——就该进入正式需求阶段了。这个阶段会产出两份正式文档:设计文档(design.md)和行为文档(behavior.md),作为后续所有工作的依据。

继续刚才的比方:现在你决定了去日本东京,但要考虑怎么去、带什么、住哪里、行程怎么安排。目标已经确定,但方案还需要设计。

在项目里,类似的情况是:"我要给应用加一个用户资料页。"——做什么已经清楚,但涉及哪些模块、有哪些约束、怎么验证做对了,这些需要正式设计。

操作步骤

第 1 步:起步

  • 方向不明确:运行 /openflow-brainstorm 并描述你的模糊想法,比如:

    text
    /openflow-brainstorm 我觉得用户反馈系统不太好,但不确定是改流程、改界面、还是加个新功能。

    AI 会通过对话帮你梳理。

  • 方向已明确:跳过头脑风暴,直接进入下一步。

第 2 步:进入正式需求

text
/openflow-feature 添加用户资料页

运行后,AI 会:

  1. 逐步提问:一次只问一个问题,帮你把目标、约束、非目标说清楚。
  2. 扫描已有约束:自动读取 docs/current/docs/decisions/,把项目的现有事实和架构决策纳入设计。
  3. 生成文档:确认信息足够后,生成 design.mdbehavior.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 — 行为文档

这两份文档是后续所有工作的依据:开发计划照着它拆任务,质量门照着它验证,归档照着它追溯。

下一步:阶段二:开发计划与实现 →

Released under the MIT License.