Claude Code Superpowers 安装使用指南：让 AI 编程从“业余”走向“工程化”
如果你经常使用 Claude Code 写代码，一定经历过这些场景：AI 一上来就埋头写代码，跳过设计直接堆砌功能，产出一堆难以维护的“一次性代码”；或者换个会话，它就完全不记得之前的决策，同样的坑反复踩。
Superpowers 正是为解决这些问题而生。作为 Claude Code 官方插件市场中安装量排名第二的王牌插件，它在 GitHub 上斩获超 11 万 Star，由核心开发者 Jesse Vincent 打造。它本质上是一套强制性的工程化工作流系统，通过 14 个技能（Skills）让 AI 在动手写代码前，必须先完成需求澄清、方案设计、计划拆解，再进入严格的 TDD 开发与代码审查环节。
本文将带你完成从安装到实战的全流程，掌握这套让 AI 编程效率与质量“质变”的方法论。
一、Superpowers 是什么？它解决了什么核心痛点？
与其说 Superpowers 是一个插件，不如说它是一套植入到 AI Agent 内部的“开发纪律”。它解决了 AI 编程助手最核心的两个问题：
Superpowers 的工作流由四个硬性门禁（Hard Gates）组成：头脑风暴 → 计划拆解 → TDD 执行 → 代码审查。任何一步没完成，都无法进入下一步。
二、安装指南：分平台快速部署
Superpowers 支持 Claude Code、OpenAI Codex、Cursor、GitHub Copilot CLI 等多种平台。以下是最常用的安装方式：
1. Claude Code 官方 Marketplace（推荐）
这是最标准、最省事的安装方式。在 Claude Code 会话中直接输入：
/plugin install superpowers@claude-plugins-official
安装完成后务必重启 Claude Code，因为插件不是热加载的。
2. Superpowers 自有 Marketplace
如果你已经在使用 Superpowers 生态的其他插件，也可以通过自有市场安装：
# 先注册市场
/plugin marketplace add obra/superpowers-marketplace
# 再安装插件
/plugin install superpowers@superpowers-marketplace
3. 其他平台的安装
- Cursor：在 Agent 对话中输入 /add-plugin superpowers
- GitHub Copilot CLI：copilot plugin marketplace add obra/superpowers-marketplace 然后 copilot plugin install superpowers@superpowers-marketplace
- OpenCode：在 opencode.json 中添加 "plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]
- Gemini CLI：gemini extensions install https://github.com/obra/superpowers
验证安装
安装后可以输入 /help 查看命令列表，如果出现 superpowers:brainstorm 等命令，说明安装成功。也可以直接对你的 Agent 说 “Tell me about your superpowers” 来验证。
三、核心工作流实战：从需求到交付的完整流程
安装完成后，Superpowers 会在你发起开发任务时自动激活。下面以一个实际例子演示完整流程。
当你向 Claude Code 提出开发需求时，Superpowers 的第一个技能 brainstorming 就会自动触发。与原生 Plan 模式一口气抛出很多问题不同，Superpowers 采用的是苏格拉底式追问：一次只问一个问题，根据你的回答决定下一个问题，直到真正理清需求。
步骤 1：头脑风暴（brainstorming）—— 把需求“拷打”清楚
这是 Superpowers 的第一道硬门禁。AI 不会写任何代码，而是一步步追问：
- 使用场景是什么？目标用户是谁？
- 技术栈偏好、部署环境、性能要求
- 边界条件与不在本期范围内的功能
在追问过程中，AI 还会主动做调研。比如有开发者想做一个 ADHD 阅读辅助工具，Superpowers 会主动查阅研究文献，然后告知：“仿生阅读（加粗单词前几个字母）对中文阅读并没有显著改善”——这在原生 Plan 模式下是做不到的。
最终，AI 会输出 2-3 个架构方案供你选择，确认后生成一份完整的设计文档（Spec），保存到本地。
步骤 2：Git 工作区隔离（using-git-worktrees）
设计确认后，Superpowers 会自动创建隔离的开发分支，确保主分支不受影响。这不是可选项，而是强制执行的标准操作。
步骤 3：制定实施计划（writing-plans）
代码依旧没有开始写。writing-plans 技能会将设计文档拆解为 2-5 分钟即可完成 的细粒度任务。每个任务包含确切文件路径、完整测试用例、验证命令和 Git 提交信息。
这个技能的设计目标很明确：“让一个没有判断力、没有项目上下文、且厌恶测试的初级工程师也能照着执行”。
步骤 4：子代理 TDD 执行（subagent-driven-development）
终于进入编码阶段。Superpowers 会为每个任务派发独立的子代理（Subagent），严格执行 TDD 流程：先写失败测试 → 再写最简实现 → 测试通过后提交。
每完成一个任务，自动触发两阶段审查：
- 第一轮：检查是否按需求文档实现，有没有多余设计
- 第二轮：检查代码规范性与可维护性
未通过审查的任务会被打回重做，直到通过为止。
步骤 5：全局审查与收尾（requesting-code-review + finishing-a-development-branch）
所有任务完成后，Superpowers 还会进行一次全局代码审查，检查模块间的集成一致性。最终验证全部测试通过后，合并回主分支，清理工作区。
四、核心技能一览：14 个技能的分工
Superpowers 包含 14 个核心技能，覆盖开发全流程：
| using-superpowers | 入口技能，确保 Agent 优先使用技能 |
| brainstorming | 需求澄清与设计，强制先设计后编码 |
| writing-plans | 将设计拆解为可执行的细粒度任务 |
| test-driven-development | 强制红-绿-重构 TDD 循环 |
| subagent-driven-development | 子代理分工执行，自动审查 |
| systematic-debugging | 系统化调试四阶段：根因→分析→假设→修复 |
| requesting-code-review | 主动请求代码审查 |
| receiving-code-review | 技术性接收审查反馈，不盲目认同 |
| verification-before-completion | 完成前强制验证，杜绝“理论上已修复” |
| using-git-worktrees | 为特性开发创建隔离工作区 |
| executing-plans | 按计划顺序执行，遇阻塞才停止 |
| dispatching-parallel-agents | 并行代理处理互不依赖的问题 |
| finishing-a-development-branch | 开发收尾：验证、合并、清理 |
| writing-skills | 教你自定义编写新技能 |
五、避坑与注意事项
结合社区实践，以下几点值得特别注意：
环境调试不在工作流范围内。Superpowers 擅长的是功能开发，遇到平台特定的环境问题（如 macOS 与 Linux 的命令差异）时，需要跳出工作流手动修复，然后再回来继续。
设计文档错误会被继承。计划严格依据 Spec 生成，如果 Spec 有错，计划和代码都会错。建议在确认设计文档前，对关键逻辑做快速代码验证。
强制 TDD 可能延长开发时间。但这是有意的设计取舍——用前期的时间投入换取后期更少的返工。
任务复选框是你的会话恢复机制。如果会话意外中断，已勾选的任务是下一个会话恢复进度的唯一依据。
用户指令始终优先。如果你的 CLAUDE.md 中明确写了“不使用 TDD”，Superpowers 会遵从这个指示，用户拥有最终决定权。
六、总结：Superpowers 适合谁？
Superpowers 不是让 AI 变得更快，而是让 AI 变得更可靠。它用一套严格的工作流门禁，把 AI 从“快速写代码的工具”升级为“负责任的开发伙伴”。
如果你满足以下任一情况，Superpowers 很可能适合你：
- 经常发现 AI 写出的代码和预期差距很大
- 需要维护 AI 生成的非玩具级项目
- 希望用 AI 执行相对复杂的开发任务，而非简单脚本
- 在团队中使用 AI 编程，需要标准化的流程
规划 2 小时，执行 10 分钟——这是很多 Superpowers 用户的心得。在这个 AI 编程能力日益强大的时代，真正拉开差距的，或许不是谁能更快地写出代码，而是谁能在动手之前，把问题真正想清楚。
