| name | flow-brainstorming |
| description | 在 /flow-init 阶段强制触发，用于捕捉需求的原始意图、探索方案、记录决策。确保后续流程有明确的北极星可追溯。 |
Flow Brainstorming - 需求头脑风暴
Overview
将用户的模糊想法转化为清晰的设计规格，通过自然对话捕捉原始意图。
核心原则：需求的原始意图是整个开发流程的「北极星」，后续每个阶段都应能追溯并验证是否偏离。
The Iron Law
NO FLOW EXECUTION WITHOUT BRAINSTORM ALIGNMENT
每个后续 flow-* 阶段开始前，必须确认与 BRAINSTORM.md 一致。
The Process
Phase 1: Understanding the Idea
一次问一个问题，不要用多个问题压垮用户：
- 检查项目现状（文件、文档、最近提交）
- 问问题来细化想法：
- 优先多选题（更容易回答）
- 一个消息只问一个问题
- 如果话题需要更多探索，分成多个问题
- 聚焦理解：目的、约束、成功标准
问题示例：
这个需求主要解决什么问题？
A) 新增功能
B) 修复现有问题
C) 性能优化
D) 重构/技术债
Phase 2: Exploring Approaches
- 提出 2-3 种不同方案，说明取舍
- 给出你的推荐方案及理由
- 让用户做决策
方案呈现格式：
### 方案 A: {名称} ⭐ 推荐
**描述**: ...
**优势**: ...
**劣势**: ...
**适用场景**: ...
### 方案 B: {名称}
...
Phase 3: Presenting the Design
一旦理解了要构建什么：
- 分段呈现设计（每段 200-300 字）
- 每段后询问是否正确
- 涵盖：架构、组件、数据流、错误处理、测试
- 准备好返回澄清
Phase 4: Documentation
将验证过的设计写入 BRAINSTORM.md：
devflow/requirements/${REQ}/BRAINSTORM.md
必须包含：
- 原始需求（用户原话，一字不改）
- 核心问题定义
- 成功标准
- 约束条件
- 方案探索（2-3种）
- 最终决策及理由
Key Principles
| 原则 | 说明 |
|---|
| 一次一个问题 | 不要用多个问题压垮用户 |
| 多选题优先 | 比开放问题更容易回答 |
| YAGNI 无情 | 从所有设计中移除不必要的功能 |
| 探索替代方案 | 在确定前总是提出 2-3 种方案 |
| 增量验证 | 分段呈现设计，验证每段 |
| 灵活应变 | 有不明白的地方就返回澄清 |
Rationalization Prevention
| Excuse | Reality |
|---|
| "需求已经很清楚了" | Brainstorm 确保没有遗漏假设 |
| "用户赶时间，跳过吧" | 头脑风暴节省的是后续返工时间 |
| "这是小需求" | 小需求也有核心问题和成功标准 |
| "方案很明显" | 明显的选择也需要记录理由 |
| "已经讨论过了" | 口头讨论不是文档，没有追溯性 |
| "先做再说" | 先想清楚再做，节省 3 倍时间 |
Red Flags - STOP
如果你发现自己：
- 跳过问问题直接开始做
- 用户说"我知道要什么"就不问了
- 没有记录方案取舍就选定
- 没有写 BRAINSTORM.md 就进入下一阶段
STOP。返回正确流程。
Integration with CC-DevFlow
flow-init 阶段
Entry Gate:
- 解析 REQ-ID 和标题
- 触发 flow-brainstorming skill
Brainstorm Phase:
1. 问问题理解需求（一次一个）
2. 探索 2-3 种方案
3. 确认最终方案
4. 输出 BRAINSTORM.md
Exit Gate:
- 验证 BRAINSTORM.md 存在
- 验证包含必要章节
后续 flow-* 阶段
Entry Gate 添加:
step: Brainstorm Alignment Check
- read: devflow/requirements/${REQ}/BRAINSTORM.md
- verify:
- 原始问题是否仍然是解决目标？
- 选定方案是否仍然适用？
- 约束条件是否发生变化？
- if 发现偏离:
- ask_user: "发现与原始意图偏离，是否更新 BRAINSTORM.md？"
- action: 记录偏离原因，更新文档
Output Template
参见 .claude/docs/templates/BRAINSTORM_TEMPLATE.md
[PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
