一：简介

Superpowers （https://github.com/obra/superpowers） 是一个为 AI 编程代理（如 Claude Code、Codex、OpenCode）打造的完整软件开发工作流系统。它的核心理念是：通过一套可组合的”技能”（Skills）和初始指令，让 AI 代理在编写代码时自动遵循最佳实践，而不是像”没有经验的初级工程师”那样随意行事。旨在解决“一句需求”， 从头脑风暴→写计划→执行计划！让AI编程助手秒变专业开发团队，自动遵循TDD测试驱动开发，一次通过零报错！真正实现代码质量质的飞跃。

包含的skill

1.1 核心设计哲学

• 测试驱动开发（TDD）：永远先写测试。没有看到测试失败，就不能确定测试是否真正测试了正确的行为。

• 系统化而非临时化：用流程替代猜测。每个技能都有明确的决策流程图（用 DOT/GraphViz 语法定义），作为”可执行规范”。

• 复杂度削减：以简洁为首要目标。技能中反复强调 YAGNI（You Aren’t Gonna Need It）原则，积极删除不必要的功能。

• 证据而非声明：在宣布任务完成之前，必须验证。看到测试通过，看到代码运行，而不是”我觉得应该可以了”。

1.2 技能库详解

项目包含 14 个核心技能，分为几大类别：

测试类

• test-driven-development：强制执行 RED-GREEN-REFACTOR 循环。核心规则是”先写测试失败的代码？删掉，重新来”，包含详细的反模式参考

调试类

• systematic-debugging：四阶段根因定位流程，整合了 root-cause-tracing（逆向追踪调用栈）、defense-in-depth（多层验证）、condition-based-waiting（基于条件的等待替代任意超时）等技术
• verification-before-completion：确保问题真正被修复

协作类

• brainstorming：苏格拉底式设计提炼
• writing-plans：详细实现计划
• executing-plans：批量执行与检查点
• dispatching-parallel-agents：并发子代理工作流
• requesting-code-review / receiving-code-review：代码审查的请求与响应
• using-git-worktrees：并行开发分支
• finishing-a-development-branch：合并/PR 决策工作流
• subagent-driven-development：两阶段审查的快速迭代

元技能

• using-superpowers：技能系统入门
• writing-skills：如何创建新技能（包含测试方法论）

1.3 总结

Superpowers 本质上是在回答一个问题：如何让 AI 代理像有经验的工程师一样工作，而不是像”会写代码但不懂工程”的实习生？

答案是：把最佳实践编码成可执行的、不可逃避的工作流。用流程图定义决策点，用测试验证行为，用子代理实现关注点分离，用两阶段审查确保质量。

这个项目对于想要提升 AI 编程效率和质量的开发者来说，是一个非常值得学习和使用的工具。

二：安装

支持Claude Code、Cursor 、Codex、OpenCode、Gemini CLI。

2.1 Claude Code

/plugin：查找安装插件


/reload-plugins：激活插件。

/help：检查是否安装成功。

• /superpowers:brainstorm - 头脑风暴
• /superpowers:write-plan - 写计划
• /superpowers:execute-plan - 执行计划

2.2 Cursor

Try in chat

Superpowers 插件本质上是一个“开发方法库 + 自动协作能力”，你现在可以这样用：

它包含什么

• Skills（技能）：一组可复用流程（TDD、调试、规划、代码评审等），可被我自动调用，也可你手动触发。
• Subagents（子代理）：专门执行某类任务的独立代理（你这套里有 code-reviewer）。
• Hooks（钩子）：会话级自动行为（当前有 sessionstart，会在会话开始时生效）。
• Rules（规则）：插件内置约束会自动应用，不需要你手动开关。
• Commands（命令）：可通过 / 调用；你现在看到的 brainstorm / execute-plan / write-plan 已标注为 deprecated，建议直接用对应 skill。

你如何触发

手动触发（推荐显式）：在输入框用 / 调技能或子代理
例：/superpowers:writing-plans（先产出实现计划）
例：/superpowers:test-driven-development（先写测试再实现）
例：/code-reviewer（做阶段性代码审查）
自动触发：你只要描述目标，我会按场景自动选择合适 skill（例如遇到报错走 systematic-debugging，做功能走 test-driven-development）。

典型工作流（最实用）

做新功能：writing-plans → test-driven-development → 实现 → verification-before-completion → requesting-code-review
排查问题：systematic-debugging → 定位根因 → 修复 → 验证
多任务并行：dispatching-parallel-agents（适合相互独立的任务）
分支收尾：finishing-a-development-branch（测试通过后决定 PR/合并/清理）

这套插件的关键价值

把“怎么做”标准化（不是只给答案，而是给可靠流程）。
在你忘记步骤时自动补齐（如先测后改、改后验证、提交前审查）。
适合中大型任务，能显著减少“修了又坏”的反复。

三：完整工作流程

Superpowers 构建了一个端到端的开发流程：

1. 头脑风暴（brainstorming）， 编写代码前激活。当你说”我想做一个 X 功能”时，AI 不会直接写代码。它会像苏格拉底式对话一样，一次问一个问题，帮你厘清真正的需求。设计方案分 200-300 字的小节呈现，每节都要你确认”看起来对吗”。通过提问细化粗略想法，探索替代方案，分模块展示设计方案供用户验证，并保存设计文档。

2. 使用 Git 工作树（using-git-worktrees）：设计方案通过批准后激活。在新分支创建独立工作区，完成项目初始化，验证干净的测试基线。

3. 编写计划（writing-plans） ，设计方案通过批准后激活。把设计拆解成 2-5 分钟的小任务。每个任务都有精确的文件路径、完整的代码片段、验证步骤。目标是让”一个没有判断力、没有项目背景、讨厌写测试的热情初级工程师”也能执行。

4. 子智能体驱动开发 / 执行计划（subagent-driven-development /executing-plans），设计方案通过批准后激活。为每个任务分配全新子智能体，执行两阶段评审（先验证是否符合规格，再检查代码质量）；或批量执行任务并设置人工检查点。

5. 测试驱动开发（test-driven-development）实施阶段激活。强制遵循红-绿-重构流程：编写失败测试用例 → 观察失败 → 编写最简代码 → 观察通过 → 提交。删除测试前编写的代码。

6. 请求代码评审（requesting-code-review）：任务间激活。对照计划进行评审，按严重程度报告问题，关键问题将阻塞项目进度。

7. 完成开发分支（finishing-a-development-branch）：任务完成后激活。验证测试，提供选项（合并/拉取请求/保留/丢弃），清理工作树。

四：从 0 到 1 的使用路径

1. 第 1 步：启动头脑风暴
   在聊天里输入：/superpowers:brainstorming
   目标：先澄清需求，不急着写代码。

2. 第 2 步：逐题澄清（一次只问一个问题）
   我会按流程问你：目的、约束、成功标准。
   你只需要短答，比如“给谁用、必须支持什么、上线时间”。

3. 第 3 步：方案对比（2-3 个）
   我会给你 2-3 条实现路径 + 取舍 + 推荐方案。
   你选定后，我再给完整设计（架构/组件/数据流/异常/测试）。

4. 第 4 步：设计确认后再进入实现
   设计确认后，进入：/superpowers:writing-plans
   然后再走实现：/superpowers:test-driven-development
   最后验收：/superpowers:verification-before-completion，必要时 /code-reviewer 审查。

4.1 你在每一步要做什么

• 你负责：回答问题、拍板方案、确认设计。
• 我负责：控流程、收敛需求、给出可执行设计和后续计划。
• 关键原则：先设计后实现；未确认设计前不写代码。

4.2 一段最小可用示例（你可以直接复制思路）

你：/superpowers:brainstorming 我要做一个员工请假审批功能
我：先问 1 个问题（比如“优先 PC 还是移动端？”）
你：回答
我：继续单题澄清 → 给 2-3 个方案 → 你选
我：输出设计并让你确认
你：确认后输入 /superpowers:writing-plans
我：生成实施计划，再进入 TDD 实现和验证

五：实战

第 1 步：启动头脑风暴（/superpowers:brainstorming）

第 2 步：逐题澄清（一次只问一个问题）

第 3 步：方案对比（2-3 个）

第 4 步：设计确认后再进入实现

第 5 步：编写计划（writing-plans）

第 6 步：测试驱动开发（test-driven-development）

第 7 步：收尾（finishing-a-development-branch）