aiskillstore/flow-brainstorming

Flow Brainstorming - 需求头脑风暴

Overview

将用户的模糊想法转化为清晰的设计规格，通过自然对话捕捉原始意图。

核心原则：需求的原始意图是整个开发流程的「北极星」，后续每个阶段都应能追溯并验证是否偏离。

The Iron Law

NO FLOW EXECUTION WITHOUT BRAINSTORM ALIGNMENT

每个后续 flow-* 阶段开始前，必须确认与 BRAINSTORM.md 一致。

The Process

Phase 1: Understanding the Idea

一次问一个问题，不要用多个问题压垮用户：

1. 检查项目现状（文件、文档、最近提交）
2. 问问题来细化想法：
   • 优先多选题（更容易回答）
   • 一个消息只问一个问题
   • 如果话题需要更多探索，分成多个问题
3. 聚焦理解：目的、约束、成功标准

问题示例：

这个需求主要解决什么问题？
A) 新增功能
B) 修复现有问题
C) 性能优化
D) 重构/技术债

Phase 2: Exploring Approaches

• 提出 2-3 种不同方案，说明取舍
• 给出你的推荐方案及理由
• 让用户做决策

方案呈现格式：

### 方案 A: {名称} ⭐ 推荐

**描述**: ...
**优势**: ...
**劣势**: ...
**适用场景**: ...

### 方案 B: {名称}
...

Phase 3: Presenting the Design

一旦理解了要构建什么：

1. 分段呈现设计（每段 200-300 字）
2. 每段后询问是否正确
3. 涵盖：架构、组件、数据流、错误处理、测试
4. 准备好返回澄清

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