核心用法
Brainstorming 是一个前置性设计技能,强制用于任何创造性工作(功能开发、组件构建、功能添加或行为修改)。它通过自然对话形式,将模糊的想法转化为完整的设计规范。
执行流程分为四个阶段:
1. 理解阶段:首先检查项目当前状态(文件、文档、最近提交),然后通过一次一个问题的方式逐步澄清需求。优先使用选择题降低用户认知负担,聚焦目标、约束条件和成功标准。
2. 探索阶段:主动提出 2-3 种不同方案并分析利弊,明确给出推荐选项及理由。
3. 设计呈现阶段:将设计方案拆分为 200-300 字的小节逐段展示,每段后征求确认。覆盖架构、组件、数据流、错误处理和测试等维度。
4. 后续动作:验证通过后将设计文档写入 docs/plans/,并可配合 superpowers:using-git-worktrees 和 superpowers:writing-plans 进入实现阶段。
显著优点
- 防止过早实现:强制设计先于编码,减少返工
- 降低认知负荷:"一次一问"原则避免信息过载
- 增量验证机制:分小节确认确保方向正确
- 内置最佳实践:YAGNI 原则、多方案对比、完整文档化
- 工具链集成:与 Git worktrees、计划编写技能无缝衔接
潜在局限
- 对话成本:简单变更可能显得流程冗长
- 同步依赖:需要用户持续交互,不适合异步批处理
- 上下文窗口消耗:长项目历史检查可能占用大量 tokens
- 无自动决策:过度依赖用户确认可能延缓进度
适合人群
- 需要系统化设计流程的中大型项目开发者
- 希望减少"需求理解偏差"的团队
- 追求代码可维护性的技术负责人
常规风险
- 流程僵化:若对所有变更严格执行可能降低效率,建议根据变更复杂度灵活调整
- 文档债务:生成的设计文档若未及时同步更新,易与实际代码脱节