欢迎使用 Superpowers
实践指南：让 AI 编码助手以纪律运作——而不仅仅是快速。
什么是 Superpowers？
Superpowers 是一套"技能"（skill）集合——即结构化的行为规则——你可以将其安装到 AI 编码助手中（如 Claude Code、Cursor 或 Gemini CLI）。安装完成后，你的 AI 助手将不再像一个急于扑向代码的新手实习生，而是像一位行动前先思考的资深工程师。
简单来说：Superpowers 教会你的 AI 先问再写代码、提前规划，以及验证结果后才声称任务完成。
它不会让 AI 变得更聪明，但会让 AI 更有纪律。
这就好比一个承包商：一种是到场就立刻开始锤钉子；另一种是先勘察现场、询问蓝图、检查墙内管道，然后有条不紊地建造。两位承包商都知道如何施工，但只有后者不会造成代价高昂的混乱。
它解决什么问题？
大多数使用过 AI 编码工具的人都经历过这个循环：
没有 Superpowers
| 你说的话 | AI 的行为 |
|---|---|
| "添加一个登录功能" | 立刻在 8 个文件中写了 400 行代码 |
| "它能用吗？" | "是的！我已经实现了完整的登录系统。" |
| "我运行了测试" | 3 个测试失败，2 个文件缺少 import |
| "修复这些测试" | 重写了一半代码库，又引入了 2 个新 bug |
| "现在完成了吗？" | "是的！一切都很好。" |
| 现实 | 什么都不能用。你浪费了一个小时。 |
AI 没有撒谎——它真的认为自己完成了。但它从来没有运行测试，从来没有验证，只是说完成了，因为那是你想听到的。
有了 Superpowers
| 你说的话 | AI 的行为 |
|---|---|
| "添加一个登录功能" | 提出 3 个关于需求的澄清问题 |
| 你回答 | 提议 2 种不同方案及各自的权衡分析 |
| 你选择一种 | 撰写详细计划等待你审批 |
| 你批准 | 逐步实现，每步之后运行测试 |
| "完成了吗？" | 运行完整测试套件，向你展示实际输出，然后才说完成 |
| 现实 | 它能用。有测试。计划已记录在案。 |
区别不在于能力，而在于工作流纪律。
它如何运作（简述）
Superpowers 为每项重要的编码任务强制执行一个 7 步工作流：
第 1 步 — Brainstorming（头脑风暴）
在写任何代码之前，AI 与你一起探索问题。它每次提一个问题，提出多种方案，并等待你对设计的批准。没有你的许可，不会有任何代码。
第 2 步 — Isolation（隔离）
工作在隔离环境（git worktree）中进行，因此你的主代码库不会受到正在进行中的实验的影响。就像一个独立的沙盒。
第 3 步 — Planning（规划）
AI 撰写一份详细的逐步实现计划。每项任务都足够小，一个新工程师可以在 2–5 分钟内完成。计划在执行开始前经过审查和批准。
第 4 步 — Execution（执行）
计划中的任务被执行——通常由独立的"subagent"进程处理——每次一个，有清晰的交接和状态报告。任务之间不相互干扰。
第 5 步 — Testing（测试）
测试先于生产代码编写（Test-Driven Development，TDD）。AI 不能声称功能完成，除非测试通过并有真实的、观察到的输出——而非假设的输出。
第 6 步 — Review（审查）
实现后，两阶段审查检查：(1) 我们是否构建了规格说明的内容？(2) 代码质量是否可接受？这是两个独立的问题，都必须通过。
第 7 步 — Completion（完成）
只有在所有验证关卡通过后，AI 才宣布工作完成。然后它会帮助你集成代码、创建 pull request，或干净地关闭任务。
谁在使用 Superpowers？
Superpowers 已在开发者社区中被广泛采用：
- 86,000+ GitHub stars — 最受欢迎的 agentic 工具包之一
- 6,800+ forks — 团队正在积极为其工作流程定制
- 24 位贡献者 — 活跃的开源社区
- 6+ 支持平台 — 支持 Claude Code、Cursor、Gemini CLI、Codex、OpenCode 等
它被以下人群使用：希望停止亲自看守 AI 工具的独立开发者；希望从 AI 辅助开发中获得一致质量的工程团队；以及在与 AI 助手合作时希望实现可预测交付的产品经理。
它适合你的团队吗？
使用以下清单查看 Superpowers 是否适合你的情况：
对于开发者
对于产品经理和团队负责人
对于 QA 工程师
如果你在任何部分勾选了 3 项或更多，Superpowers 就是为你打造的。
入门指南 — 下一步阅读什么
不同角色从本指南的不同部分中获益：
| 角色 | 推荐阅读路径 |
|---|---|
| 开发者 | 从 入门指南 → 头脑风暴 → 撰写计划 → 所有章节 |
| 产品经理 | 阅读 头脑风暴 和 撰写计划 以了解需求如何变成计划 |
| QA 工程师 | 直接跳到 TDD 和 执行与 Subagent 了解验证和测试模型 |
| 团队负责人/架构师 | 阅读所有章节 — Superpowers 是团队范围的纪律，而不仅仅是开发者工具 |
结论： Superpowers 不会替代你的判断力。它确保 AI 在正确的时刻寻求你的判断，记录决策，并在完成任何事情之前证明其工作成果。