超级能力（Superpowers）

概述

超级能力（Superpowers）是一套完整的软件开发方法论，为 AI 智能体提供结构化、可重复的开发工作流。该方法论源自 obra/superpowers 项目，将软件开发过程划分为 7 个核心阶段，每个阶段均配备专属技能与检查点，以确保产出高质量、可维护的代码。

核心工作流

超级能力遵循严格的七阶段工作流，所有阶段均为强制性，不可跳过：

1. 头脑风暴（Brainstorming）

触发条件：任何开发任务启动时自动激活。 目标：通过提问厘清用户的真实需求，探索多种实现方案，并产出可验证的设计文档。 关键操作：

• 追问用户真正希望达成的目标（而非仅停留在表面需求）
• 探索多种设计方案及其权衡取舍
• 将设计方案拆解为可读性强的片段（每段不超过 200 字）
• 生成设计文档并保存至 design.md
• 获取用户对设计文档的正式确认（sign-off）

2. 设计验证（Design Validation）

触发条件：头脑风暴阶段完成后。 目标：确保设计方案完整、可行，且符合用户预期。 关键操作：

• 向用户逐段展示设计方案供审阅
• 针对每段提问：“该部分内容是否清晰？”
• 确认技术可行性及各项约束条件
• 记录用户反馈并更新设计文档

3. 实施规划（Implementation Planning）

触发条件：设计验证通过后。 目标：将设计方案分解为可执行、粒度精细的开发任务。 关键操作：

• 制定详细任务清单，每项任务耗时控制在 2–5 分钟内
• 每项任务须明确包含：精确文件路径、完整代码内容、验证步骤
• 严格遵循 YAGNI（You Aren't Gonna Need It）与 DRY（Don't Repeat Yourself）原则
• 生成规划文档并保存至 plan.md

4. 测试驱动开发（Test-Driven Development, TDD）

触发条件：实施阶段自动激活。 目标：强制执行“红–绿–重构”（Red-Green-Refactor）循环。 关键操作：

• 首先编写一个失败的测试（Red）
• 编写最简代码使该测试通过（Green）
• 进行重构，保持代码整洁
• 删除所有在测试编写前编写的代码
• 每个功能均需严格遵循此循环

5. 子智能体驱动开发（Subagent-Driven Development）

触发条件：规划文档获批后。 目标：利用子智能体并行或串行执行开发任务。 关键操作：

• 为每项任务创建独立的全新子智能体
• 实行两阶段评审：先核查是否符合规范，再评估代码质量
• 在批量执行过程中设置人工检查点
• 一旦子智能体偏离既定计划，立即中止并上报

6. 代码审查（Code Review）

触发条件：任务间歇期或全部任务完成后。 目标：确保代码符合规划要求与质量标准。 关键操作：

• 依据规划文档逐项审查代码
• 按严重程度报告问题：阻断级（Critical）、严重级（Major）、轻微级（Minor）
• 阻断级问题必须修复后方可继续后续流程
• 生成审查报告并保存至 review.md

7. 完成开发分支（Finishing Development Branch）

触发条件：所有任务完成后。 目标：干净利落地收尾整个开发周期。 关键操作：

• 验证全部测试用例均已通过
• 向用户呈现后续选项：合并分支、创建 PR、保留分支、废弃分支
• 清理工作区（workspace）
• 生成最终报告

核心原则

1. 测试驱动开发（TDD）

• 始终优先编写测试
• 严格执行红–绿–重构循环
• 测试既是验证手段，也是设计与文档工具

2. 系统化优于临时应对（Systematic over Ad-Hoc）

• 依循既定流程，而非凭直觉猜测
• 每一项决策均有明确依据
• 全面记录所有假设与决策过程

3. 降低复杂度（Complexity Reduction）

• 追求简洁是首要目标
• 移除一切非必要代码
• 优先选择最简单但可行的解决方案

4. 重实证而非空谈（Evidence over Claims）

• 以可验证结果代替主观宣称
• 借助测试证明功能正确性
• 以数据支撑关键决策

技能触发机制

超级能力是一项强制性工作流，而非可选建议。当检测到以下任一情形时，对应技能必须立即激活：

1. 用户提及开发/编程相关事项 → 启动头脑风暴（Brainstorming）
2. 设计方案完成 → 启动实施规划（Implementation Planning）
3. 开始编写代码 → 启动测试驱动开发（TDD）
4. 任务需并行处理 → 启动子智能体驱动开发（Subagent-Driven Development）
5. 代码编写完成 → 启动代码审查（Code Review）
6. 项目整体完成 → 启动收尾流程（Finishing）

交付物

各阶段均产出标准化文档，以保障全程可追溯性：

示例工作流

用户请求：“帮我构建一个待办事项（todo）应用”

1. 头脑风暴：询问具体需求（Web 还是移动端？是否需要身份认证？数据如何存储？）
2. 设计：生成 UI 设计稿、架构图、API 接口定义
3. 规划：拆解为若干子任务：初始化项目结构、实现身份认证模块、构建 CRUD 功能、添加前端界面
4. TDD：为每个功能预先编写测试用例
5. 子智能体：分派多个子智能体并行开发不同模块
6. 审查：分别审查各模块的代码质量
7. 收尾：合并代码，生成部署文档

故障排查

问题：子智能体偏离既定计划 解决方案：立即中止执行，分析偏差原因，调整计划或重新分派任务

问题：测试用例失败 解决方案：退回“红”阶段，分析失败原因，修正测试或代码

问题：需求发生变更 解决方案：返回头脑风暴阶段，重新评估设计方案

参考资源

有关详细工作流指南与最佳实践，请参阅 references/workflow.md 和 references/best_practices.md。

资源

本技能内置了用于组织不同类型内容的资源目录：

scripts/

可直接执行的代码（Python/Bash 等），用于完成特定操作。

其他技能中的示例：

• PDF 技能：fill_fillable_fields.py、extract_form_field_info.py —— PDF 文档处理工具
• DOCX 技能：document.py、utilities.py —— 文档处理 Python 模块

适用场景：Python 脚本、Shell 脚本，或任何用于自动化、数据处理或执行特定操作的可执行代码。

references/

面向上下文加载的文档与参考资料，用于指导智能体的推理与执行过程。

其他技能中的示例：

• 产品管理：communication.md、context_building.md —— 详尽的工作流指南
• BigQuery：API 参考文档与查询示例
• 金融领域：数据库 Schema 文档、公司政策文件

适用场景：深度技术文档、API 参考、数据库 Schema、综合指南，或工作中需随时查阅的各类详细信息。

assets/

不用于上下文加载，而是嵌入于最终输出产物中的文件。

其他技能中的示例：

• 品牌设计：PowerPoint 模板文件（.pptx）、Logo 图像文件
• 前端构建：HTML/React 项目脚手架目录
• 字体排印：字体文件（.ttf、.woff2）

适用场景：模板、脚手架代码、文档模板、图像、图标、字体，或任何需复制至最终输出的资源文件。

未使用的目录可直接删除；并非所有技能都需同时包含这三类资源。