Claude Code Superpowers 安装使用指南：让 AI 编程从“业余”走向“工程化”

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 编程助手最核心的两个问题：

跳过思考直接编码 ：传统 AI 收到任务后倾向于立刻输出代码，忽略了需求澄清和架构设计。Superpowers 通过 brainstorming 技能强制执行"先设计后编码"的硬性门禁。
缺乏测试与审查：AI 经常"写完就交差"，不在意代码质量和可维护性。Superpowers 强制要求 TDD（测试驱动开发）和两阶段代码审查。

Superpowers 的工作流由四个硬性门禁（Hard Gates）组成：头脑风暴 → 计划拆解 → TDD 执行 → 代码审查。任何一步没完成，都无法进入下一步。

二、安装指南：分平台快速部署

Superpowers 支持 Claude Code、OpenAI Codex、Cursor、GitHub Copilot CLI 等多种平台。以下是最常用的安装方式：

1. Claude Code 官方 Marketplace（推荐）

这是最标准、最省事的安装方式。在 Claude Code 会话中直接输入：

bash 复制代码

/plugin install superpowers@claude-plugins-official

安装完成后务必重启 Claude Code，因为插件不是热加载的。

2. Superpowers 自有 Marketplace

如果你已经在使用 Superpowers 生态的其他插件，也可以通过自有市场安装：

bash 复制代码

# 先注册市场
/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 编程能力日益强大的时代，真正拉开差距的，或许不是谁能更快地写出代码，而是谁能在动手之前，把问题真正想清楚。