简介与核心理念
brainstorming 技能被设计为所有创造性开发工作(如构建功能、组件或修改行为)的强制性前置关卡。它直接切中了“因未经检验的假设而导致工作浪费”的痛点,尤其是那些看似“微不足道”的任务。该技能的核心目标是通过结构化的协作对话,在编写任何代码之前,将模糊的想法转化为完全成型的设计和规范文档。
核心理念
坚持“先设计,后实现”。通过探索项目上下文、逐步澄清问题并强制输出标准规范文档,该技能有效防止了无效返工,确保最终架构与用户真实意图完全对齐。
安装与调用指南
https://github.com/obra/superpowers
工作流程解析 (SOP)
- 探索项目背景:强制要求 AI 在提问前先读取当前文件、文档和历史提交。这体现了“基于现有架构进行扩展”的务实逻辑。
- 提供视觉参考:针对涉及界面的问题,单独询问是否需要浏览器可视化辅助。这剥离了视觉确认与逻辑确认,降低了沟通成本。
- 单步澄清问题:严格限制 AI 每次只能问一个问题。这种设计避免了信息过载,确保每个约束条件都被深度挖掘。
- 提供多种方案:要求必须提出 2-3 种带有权衡分析的架构选项,打破了 AI 容易陷入“单一思维定势”的局限。
- 分段确认设计:将复杂设计拆解为小模块并逐一获取用户批准,建立了一个极度安全的渐进式确认机制。
- 撰写与自省规范:强制生成物理层面的 Markdown 设计文档,并在交付前进行“占位符与歧义”的自检,体现了极高的工程严谨性。
- 严格交接下一环节:工作流的终点必须是调用下一个规划技能(
writing-plans),设立了防止 AI 过早写代码的“硬性关卡(HARD-GATE)”。
技能设计评价
- 人类经验 SOP 化的亮点:通过设置强制性的前置流程,避免了过早进入代码实现阶段。其中“规范自检(Spec self-review)”步骤要求 AI 在交付前主动检查文档中的占位符和歧义,提升了输出质量。
- 潜在的局限性:严格要求“每次只问一个问题”可能会延长沟通时间。对于结构简单的微型需求,强制生成完整的 Markdown 设计文档会增加操作成本。
- 优质技能的评判标准:明确定义了反模式(Anti-Pattern),并为对话设置了确定性的状态机流程,通过流程控制有效限制了 AI 过早生成代码的倾向。