Superpowers 入门指南
安装一次，永久改变你的 AI 工作方式。
什么是 Superpowers？（技术说明）
Superpowers 是一个 agentic 技能框架——一套结构化的行为协议，你可以将其加载到 AI 编码助手中。它由 Jesse Vincent 创建，他以 Request Tracker 的作者而闻名，Request Tracker 是历史上部署最广泛的问题跟踪系统之一。
该框架定义了 AI 助手在软件开发中应该如何思考和行动——不仅仅是写什么代码，还包括何时停下来提问、如何规划、如何验证，以及如何知道某件事是否真正完成。
从技术上讲，Superpowers 是一套技能（也称为插件或规则，具体取决于你的平台）的集合。每个技能都是一组专注的指令，在特定条件下激活。当你将 Superpowers 安装到 AI 工具中时，你赋予了它一套构建为机器可读协议的专业软件工程纪律。
核心理念
Superpowers 建立在三个贯穿每个技能的原则之上：
1. TDD 优先（Test-Driven Development）
没有先有失败测试，就不能写生产代码。 这不是一个指导方针——这是一条强制规则。AI 必须先写一个失败的测试，然后才能写任何实现代码。如果你忍不住想跳过这一步，Superpowers 明确要求你删除所有没有测试就写的代码，然后重新开始。
为什么这很重要：代码之后写的测试往往测试代码做了什么，而不是它应该做什么。先写的测试捕获意图并尽早发现假设。
2. YAGNI（You Aren't Gonna Need It）
只构建明确要求的内容。 不要做投机性的抽象，不要"面向未来"，不要添加"以防万一"的额外配置选项。代码库中的每一个新增内容都有维护成本。Superpowers 让 AI 专注于当前任务。
3. 证据优先于声明
看到测试通过是证据。说它应该能用是声明。 Superpowers 要求 AI 提供实际输出——真实的测试结果、真实的命令输出、真实的文件 diff——然后才能断言任何事情是完成的。"它应该能用"不是可接受的完成声明。
安装
Superpowers 可在多个平台上运行。选择你的工具：
Claude Code
/plugin install superpowers@claude-plugins-official
这将完整的 Superpowers 技能套件安装到你的 Claude Code 会话中。技能会根据上下文自动激活。
Cursor
/add-plugin superpowers
添加插件后，Cursor 将加载技能定义。你可能需要重启 Cursor 会话。
Gemini CLI
gemini extensions install superpowers
按照提示授权扩展。所有技能在你的下一个 Gemini CLI 会话中可用。
Codex
通过 Codex 配置文件将 Superpowers 添加为自定义指令集。请参阅 官方 Codex 文档 了解插件安装路径。
OpenCode
opencode plugin add superpowers
技能在会话启动时自动加载。
验证安装
安装后，向你的 AI 助手询问：
"有哪些 Superpowers 技能可用？"
正确安装的 Superpowers 套件将列出活跃的技能。你应该看到包括 brainstorming、writing-plans、executing-plans、test-driven-development 等技能。
如果助手不识别这些技能，请重新运行安装命令并重启会话。
7 步核心工作流
安装完成后，Superpowers 通过结构化的 7 步流程引导开发。这里是简要概述——每个步骤都有专属章节详细介绍。
| 步骤 | Skill | 描述 |
|---|---|---|
| 1 | BRAINSTORM | 探索问题空间 |
| 2 | ISOLATE | 创建安全工作环境 |
| 3 | PLAN | 撰写详细任务列表 |
| 4 | EXECUTE | 使用 subagent 实现 |
| 5 | TEST | TDD 循环：红 → 绿 → 完成 |
| 6 | REVIEW | 两阶段质量关卡 |
| 7 | COMPLETE | 经验证的交付 |
第 1 步：Brainstorming（头脑风暴）
AI 在接触任何代码之前与你一起探索问题。它每次提一个澄清问题，提出 2–3 种方案及权衡分析，并等待你的批准。硬性关卡阻止在设计获批之前写代码。
→ 在 头脑风暴与设计 中详细介绍
第 2 步：Isolation（隔离）
工作在 git worktree 中进行——你代码库的一个隔离副本。更改保持隔离，直到被有意地合并。你的主 branch 始终安全。
→ 作为执行工作流的一部分介绍
第 3 步：Writing Plans（撰写计划）
在执行开始之前，会产出一份详细的实现计划。计划中的每项任务都是自包含的，包含完整的代码片段、准确的文件路径和准确的命令。计划经过审查和批准。
→ 在 撰写计划 中详细介绍
第 4 步：Execution & Subagents（执行与 Subagent）
计划中的任务被分派给全新的 subagent 进程——没有之前任务记忆的独立 AI 实例。这防止了一个任务中的错误污染下一个任务。每个完成的任务都经过两阶段审查。
→ 在 执行与 Subagent 中详细介绍
第 5 步：Test-Driven Development（测试驱动开发）
每个功能都以一个失败测试开始。RED-GREEN-REFACTOR 循环被严格遵守。没有运行测试套件并看到实际的通过输出，功能就不会被标记为完成。
→ 在 Test-Driven Development 中详细介绍
第 6 步：Review（审查）
两阶段审查流程检查规格符合性（我们是否构建了要求的内容？）和代码质量（代码是否可维护且正确？）。这两个问题分开评估。
→ 作为 执行与 Subagent 章节的一部分
第 7 步：Completion（完成）
在所有验证关卡通过后，助手提交一份干净的完成报告，帮助创建 pull request，并确保工作正确集成。没有什么是"完成的"，除非它被证明完成了。
→ 在 finishing-a-development-branch 技能文档中介绍
快速参考：关键命令
| 操作 | 对 AI 说的话 |
|---|---|
| 开始一个新功能 | "我想添加 [功能]。使用 brainstorming 技能。" |
| 撰写计划 | "我们已就设计达成一致。撰写一份实现计划。" |
| 执行计划 | "使用 subagent 执行这个计划。" |
| 运行 TDD | "使用 test-driven development 实现 [功能]。" |
| 审查工作 | "在我们完成之前审查这个实现。" |
接下来是什么
本指南深入介绍工作流的每个步骤。章节设计为第一次阅读时按顺序阅读，之后用作参考资料。
- 头脑风暴与设计 — 保护你免受过早编码的硬性关卡
- 撰写计划 — 如何将设计转化为可执行任务
- 执行与 Subagent — 通过上下文隔离安全地运行计划
- Test-Driven Development — 基于证据交付的铁律
记住： Superpowers 不是为了减慢速度。它是为了终止"写代码 → 出错 → 修复 → 再出错"这个代价高昂的循环。前期的纪律在后续节省了数倍的时间。