用途
Brainstorming(头脑风暴)是一个把想法转化为完整设计与规格说明的构思技能。其说明明确指出:在任何创造性工作之前都必须使用它,包括创建功能、构建组件、添加功能或修改行为。它的目标是通过自然的协作式对话,帮助用户把模糊的想法逐步收敛为可实施的设计,并在进入实现之前完成规格确认。
主要能力
该技能围绕一个明确的清单流程组织工作,每项均需建立任务并按顺序完成:
- 探索项目上下文——查看文件、文档与近期提交。
- 提供视觉伴侣(若主题将涉及视觉问题)——该提示必须单独作为一条消息,不与澄清问题合并。
- 提出澄清问题——一次一个,理解目的、约束与成功标准。
- 提出 2-3 种方案——附带取舍与推荐意见。
- 呈现设计——按复杂度分段,每段后获取用户确认。
- 编写设计文档——保存到 docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md 并提交。
- 规格自查——快速内联检查占位符、矛盾、歧义与范围。
- 用户复核书面规格——请用户在继续前审阅规格文件。
- 转入实现——调用 writing-plans 技能创建实施计划。
流程还配有有向图说明,其中"用户确认设计"和"用户复核规格"均为分支判断点;若用户要求修改,则回到相应步骤;只有通过后才进入下一步。该流程的终态是调用 writing-plans,说明强调在头脑风暴之后唯一应调用的技能就是 writing-plans,不应调用 frontend-design、mcp-builder 或其他实现类技能。
使用方式
理解想法阶段:先检查项目当前状态(文件、文档、近期提交)。在提出细节问题前先评估范围:若请求描述了多个相互独立的子系统(例如"构建一个包含聊天、文件存储、计费和分析的平台"),应立即指出,而不是花问题去打磨一个需要先拆解的项目。若项目过大而无法放入单份规格,应先帮助用户拆分为子项目:独立部分是什么、如何关联、应按什么顺序构建;然后对第一个子项目走正常的设计流程。每个子项目都有自己的规格 → 计划 → 实现周期。对于范围合适的项目,则一次一个问题地提问以打磨想法,尽可能优先使用选择题,也允许开放式问题;每条消息只问一个问题,若某话题需要更多探索,则拆成多个问题。关注点在于理解目的、约束与成功标准。
探索方案阶段:提出 2-3 种不同方案及取舍,以对话方式给出推荐与理由,先给出推荐选项并解释原因。
呈现设计阶段:当确信已理解要构建的内容后呈现设计;每节按复杂度伸缩,简单则几句话,复杂则最多 200-300 字;每节后询问是否看起来正确。覆盖范围包括架构、组件、数据流、错误处理与测试。若某处不清楚,应准备好返回澄清。
隔离与清晰的设计原则:把系统拆成更小的单元,每个单元有单一明确用途,通过定义良好的接口通信,可被独立理解与测试。对每个单元都应能回答:它做什么、如何使用、依赖什么。如果别人不看内部实现就无法理解单元作用,或修改内部会破坏调用方,说明边界需要改进。更小、边界清晰的单元也更容易被 AI 处理——能在上下文中一次掌握的代码推理效果更好,文件聚焦时编辑更可靠;文件变大通常意味着它做了太多事。
在既有代码库中工作:先探索当前结构再提出改动,遵循既有模式。若既有代码的问题会影响本次工作(如文件过大、边界不清、职责纠缠),应把有针对性的改进纳入设计——就像优秀开发者会顺手改善其正在修改的代码。但不要提出无关的重构,要聚焦于服务当前目标。
设计之后
文档化:将验证过的设计(规格)写入 docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md(用户对规格位置的偏好可覆盖此默认值);若可用,使用 elements-of-style:writing-clearly-and-concisely 技能;把设计文档提交到 git。
规格自查:写完规格后以全新视角审视:占位符扫描(是否有 TBD、TODO、未完成章节或含糊需求,需修复);内部一致性(章节之间是否矛盾,架构是否与功能描述匹配);范围检查(是否足够聚焦于单个实施计划,还是需要拆解);歧义检查(是否有需求可被两种方式理解,若有则择一明确)。发现问题直接内联修复,无需重新审查。
用户复核关卡:规格审查循环通过后,请用户在继续前审阅书面规格,提示语为:"Spec written and committed to <path>. Please review it and let me know if you want to make any changes before we start writing out the implementation plan." 等待用户回应;若要求修改,则修改并重新运行规格审查循环;只有用户批准后才能继续。
实现:调用 writing-plans 技能创建详细实施计划。
关键原则
- 一次只问一个问题,不要一次抛出多个问题。
- 尽可能优先选择题,比开放式问题更易回答。
- 严格执行 YAGNI,从所有设计中移除不必要的功能。
- 始终在定稿前提出 2-3 种方案。
- 增量验证,每步获得确认后再前进。
- 保持灵活,遇到不清楚的地方返回澄清。
视觉伴侣
视觉伴侣是一个基于浏览器的辅助工具,用于在头脑风暴中展示模型图、示意图与视觉选项。它是一种工具而非模式;接受该伴侣意味着它可用于受益于视觉呈现的问题,但并不意味着每个问题都要走浏览器。
提供方式:当预判后续问题会涉及视觉内容(模型图、布局、图表)时,一次性征求同意,提示语为:"Some of what we're working on might be easier to explain if I can show it to you in a web browser. I can put together mockups, diagrams, comparisons, and other visuals as we go. This feature is still new and can be token-intensive. Want to try it? (Requires opening a local URL)"。该提示必须单独成条消息,不得与澄清问题、上下文总结或其他内容合并,消息中只包含该提示;等待用户回应后再继续,若拒绝则进行纯文本头脑风暴。
逐问题决策:即使用户接受,也要对每个问题单独决定走浏览器还是终端。判断标准是:用户看到它是否比读到它理解得更好。对本身就是视觉的内容(模型图、线框图、布局对比、架构图、并排视觉设计)使用浏览器;对文本内容(需求问题、概念选择、取舍清单、A/B/C/D 文本选项、范围决策)使用终端。关于 UI 主题的问题不自动等于视觉问题:"在这个语境里 personality 是什么意思"是概念问题,用终端;"哪种向导布局更好"是视觉问题,用浏览器。若用户同意使用伴侣,继续前先阅读详细指南:skills/brainstorming/visual-companion.md。
适用场景与限制
该技能适用于新功能构思、组件搭建、功能添加、行为修改等任何创造性工作之前的设计阶段,尤其适合需要与用户反复确认意图的项目。它明确反对"太简单所以不需要设计"的想法:每个项目都要走这个流程,待办清单、单函数工具、配置修改也不例外;简单项目的设计可以很短(真正简单的项目几句话即可),但仍必须呈现并获得批准。明显的限制与约束包括:说明中未提供收费、价格、平台支持等商业信息;其流程强制以调用 writing-plans 为终态;视觉伴侣属于新功能且可能较为消耗 token,并需要打开本地 URL。