Brainstorming - 流程控制架构分析

Brainstorming - 流程控制架构分析

核心发现

brainstorming技能通过三个相互关联的章节构建了完整的流程控制架构：

1. Checklist：9步强制流程的骨架
2. Process Flow：可视化决策逻辑的脉络
3. The Process：详细执行指南的血肉

这三个章节构成了一个三层架构的质量保证体系。

---

1. Checklist：强制性的9步流程

核心特点

• "MUST create a task for each"：每个步骤都必须创建任务
• "complete them in order"：必须按顺序完成
• 强制性的质量检查点：9个步骤包含3个关键审查点

9步流程的深度分析

# 流程的演进逻辑

阶段1：探索与理解 (步骤1-3)
1. **Explore project context** - 查看项目现状
2. **Offer visual companion** - 准备视觉工具（可选）
3. **Ask clarifying questions** - 一问一式理解需求

阶段2：设计与验证 (步骤4-5)  
4. **Propose 2-3 approaches** - 提出多种方案
5. **Present design** - 分块呈现设计，获得批准

阶段3：文档化与审查 (步骤6-8)
6. **Write design doc** - 写入设计文档并提交
7. **Spec self-review** - 自动自我审查
8. **User reviews written spec** - 用户审查

阶段4：过渡实现 (步骤9)
9. **Transition to implementation** - 调用writing-plans技能

关键设计原则

渐进式细化：

• 从宏观（项目上下文）到微观（具体设计）
• 从发散（多种方案）到收敛（最终设计）
• 从思考到文档化

强制性质量门控：

• 每个主要阶段结束都有审查点
• 3个关键批准点：设计批准、文档完成、用户确认
• 任何一步不通过都可以回到前一阶段

---

2. Process Flow：可视化的决策逻辑

流程图的精妙设计

digraph brainstorming {
    # 关键节点分析
    "Explore project context" [shape=box];  # 起点：项目探索
    "Visual questions ahead?" [shape=diamond];  # 条件判断：是否需要视觉
    "Ask clarifying questions" [shape=box];  # 核心：需求澄清
    "Propose 2-3 approaches" [shape=box];  # 方案设计
    "Present design sections" [shape=box];  # 设计呈现
    "User approves design?" [shape=diamond];  # 质量门控1
    "Write design doc" [shape=box];  # 文档化
    "Spec self-review" [shape=box];  # 自动审查
    "User reviews spec?" [shape=diamond];  # 质量门控2
    "Invoke writing-plans skill" [shape=doublecircle];  # 终点
    
    # 关键分支逻辑
    "User approves design?" -> "Present design sections" [label="no, revise"];  # 迭代循环
    "User reviews spec?" -> "Write design doc" [label="changes requested"];  # 文档迭代
    
    # 终点强制
    "The terminal state is invoking writing-plans";  # 明确终点
}

流程图的关键特性

1. 条件分支的精确控制：

• "Visual questions ahead?" - 可选的视觉伴侣路径
• 两个关键的质量判断节点

2. 迭代循环的设计：

• 设计阶段可以返回修改（no, revise）
• 文档阶段可以再次修改（changes requested）
• 允许必要的返工，但控制在合理范围内

3. 终点状态的强制：

• 明确说明终点必须是invoking writing-plans
• 禁止调用其他实现技能
• 确保流程的一致性

---

3. The Process：细节执行的完整指南

四大核心阶段详解

阶段1：Understanding the idea（理解阶段）

# 超越简单的需求收集
- 先检查项目状态（files, docs, recent commits）
- 评估scope：识别大型子系统的需求
- 项目分解能力：将大项目分解为独立的子项目
- 一问一式：每次只问一个问题
- 多选题优先：降低用户认知负担

关键洞察：

"Before asking detailed questions, assess scope"

--- 这体现了"预防胜于治疗"的设计哲学

阶段2：Exploring approaches（方案探索）

# 结构化的方案对比
- 提出2-3个不同方案
- 明确对比trade-offs（权衡）
- 推荐首选方案并解释理由
- 对话式呈现，不生硬

关键设计：

"Lead with your recommended option and explain why"

--- 先推荐再解释，提高效率同时保持透明

阶段3：Presenting the design（设计呈现）

# 分块渐进式呈现
- 按复杂性分块：简单几句话，复杂200-300词
- 每块后获得批准：增量式验证
- 覆盖核心要素：架构、组件、数据流、错误处理、测试
- 保持灵活性：可以返回澄清

阶段4：Design for isolation and clarity（设计原则）

# 高内聚低耦合的设计哲学
- 小单元，单一目的
- 明确定义的接口
- 独立可理解
- 独立可测试
- "文件过大=职责过多"的信号

---

三章节的协同效应

1. Checklist提供骨架

• 9个强制步骤确保不遗漏关键环节
• 任务创建机制确保进度追踪

2. Process Flow提供脉络

• 流程图可视化逻辑关系
• 明确分支和循环条件
• 强制终点状态

3. The Process提供血肉

• 每个步骤的详细执行指南
• 具体的最佳实践和技巧
• 深度的设计原则

三层架构的优势

层级	作用	价值
骨架（Checklist）	确保完整性	不会漏掉关键步骤
脉络（Process Flow）	确保逻辑性	步骤间的关系清晰
血肉（The Process）	确保质量性	每步都有具体方法

---

Superpowers的流程设计智慧

1. 渐进式复杂度控制

• 从简单到复杂
• 从发散到收敛
• 从模糊到明确

2. 质量内嵌而非事后检查

• 每个主要阶段都有质量检查
• 设计过程中就获得用户反馈
• 文档化前已经过多轮验证

3. 强制性与灵活性的平衡

• 步骤顺序是强制的
• 每步的内容是灵活的
• 迭代循环允许必要的修改

4. 认知负荷优化

• 一问一式降低认知负担
• 分块呈现避免信息过载
• 多选题优先提高回答效率

---

实际执行效果对比

无此结构化流程时

用户：我需要个登录功能
智能体：好的，我马上给你写代码...
# 结果：可能遗漏关键需求，设计不完整

有此结构化流程时

智能体：我需要先了解项目情况...
1. 探索项目上下文
2. 确认是否需要视觉化
3. 逐步澄清需求（你期望用什么认证方式？）
4. 提出2-3种方案对比
5. 分块呈现设计并获批准
6. 写入设计文档
7. 自查和用户审查
8. 调用writing-plans
# 结果：完整的设计，明确的需求，经过验证

---

总结：流程即质量

这三个章节的完美配合体现了Superpowers的核心设计哲学：

"好的流程产生好的结果"：

1. 完整性：9个步骤覆盖了从需求到设计的全过程
2. 质量性：多个检查点确保设计质量
3. 可控性：清晰的流程图让执行路径一目了然
4. 灵活性：允许必要的迭代，不僵化

这不是简单的步骤列表，而是一个经过深思熟虑的质量保证体系。每个设计都经过层层验证，每份文档都确保完整准确，每个项目都遵循相同的高标准。

通过强制性的流程、可视化的逻辑和详细的执行指南，Superpowers确保了brainstorming技能能够产出一致、高质量的设计结果。

---

文档版本 : 1.0
最后更新 : 2026-04-14
分析层次: 流程架构深度分析