你有没有过这种体验？

打开 Claude Code，描述了一个需求，它唰唰唰就开始写代码了。你松了一口气，心想「今天效率真高」——

然后开始 review，发现它完全理解错了方向，代码写了一大堆但全都要重来。

你叹了口气，删掉，重新描述。这一次它理解了，但代码风格和项目现有规范完全不搭。你再改一遍，它改了这里坏了那里。

一个下午过去了，你做的事只有一个：告诉 AI 它做错了什么，让它重新做。

这不是你的问题，也不是 Claude 的问题。这是一个结构性问题——

AI 很聪明，但它没有工程纪律。

想象一下：你有一个热情但没有经验的初级工程师。他编程能力很强，但每次接到需求就直接开始写代码，不确认需求、不设计架构、不写测试、不 review。结果就是——做得很快，但经常做错。

你怎么管他？

你给他一套 SOP（标准作业流程）：

接到需求 → 需求澄清 → 设计方案 → 评审通过 → 写测试 → 写实现 → 代码 review → 合入。

---

什么是 Superpowers？

Superpowers 是一套开源的 AI 编码智能体方法论，由 Jesse Vincent（obra）创建，Prime Radiant 团队维护。它目前是：

• GitHub 17.7 万 Star，增长最快的开源项目之一
• Claude 官方插件市场安装量第二
• 支持 11 种编码智能体平台（Claude Code、Codex、Cursor、Kimi、Gemini CLI、Copilot CLI……）
• 23 万+ 安装量

但与其说它是一个「插件」，不如说它是一套强制性的工程纪律框架。

它不给 AI 加新功能——它给 AI 立规矩。

一句话总结

Superpowers 不让 AI 变聪明，而是让 AI 守纪律。

把「写代码很快但漏洞百出」，变成「一次做对且可复现」。

为什么裸跑 AI 总是翻车？—— 三大原罪

原生 Claude Code 智慧绝伦，却天生不适应严谨的工程环境。根源在于大语言模型的三个「天性」：

原罪一：回答的随机性

面对同一句「加个支付回调」，它可能随机从 100 种写法中挑一种。今天写得完美，明天就可能漏掉幂等性检查。

本质：模型是概率预测器，每次采样都是「掷骰子」。

原罪二：直觉快思考

模型总倾向于一步到位直接给代码。它不会主动停下来问：

• 「这个验证码需要过期时间吗？」
• 「用什么存储？Redis 还是数据库？」
• 「需要频率限制吗？」

这种思维跳跃导致了大量隐性 Bug。

本质：模型只有「快思考」（直觉联想），没有「慢思考」（系统推理）。

原罪三：注意力稀释

当上下文变长，模型处理多个任务时极易「记忆串台」——修改 A 功能的时候不小心破坏 B 功能的逻辑。

本质：长上下文中的注意力衰减，导致「顾此失彼」。

《清单革命》里说：即便是最顶尖的外科医生，在复杂手术中也会因注意力分散而犯低级错误。一张术前清单，就能让术后并发症死亡率下降 47%。

Superpowers 的验证清单和检查点机制，本质上就是为 AI 手术台设计的「术前清单」——不提升医生的技术，但确保关键步骤不被跳过。

Superpowers 的七步工作流

Superpowers 的核心是 14 个内置 Skill，覆盖了从需求澄清到代码合入的完整开发流程。你不用记住它们——它们会自动触发。

以下是标准的七步工作流：

1. Brainstorming      → 需求澄清，设计方案
Git Worktrees      → 创建隔离工作区
Writing Plans      → 拆解任务，编写计划
Subagent Dev       → 子智能体驱动开发
TDD                → 测试驱动开发
Code Review        → 代码自我审查
Finishing Branch   → 收尾，合入决策

注意：不是每次都要走完全部七步。Superpowers 会根据任务复杂度自动决定触发哪些阶段。简单任务（改个 typo）会自动跳过大部分流程。

第一步：Brainstorming — 在写代码之前，先搞对方向

触发时机：你说「帮我做一个 xxx」时自动触发。

这是 Superpowers 最重要的一步，也是区别最大的一步。

裸跑 Claude Code 时，你说「做一个 Markdown 解析器」，它马上开始写代码。

装了 Superpowers 之后，它不会写代码——它会问你问题。

你：帮我做一个 Markdown 解析器

Claude：[触发 brainstorming]
  在开始之前，我需要先确认几个方向：

  1. 你需要的解析深度是什么？
     - 只转换标题、加粗、链接这些基础语法？
     - 还是需要支持表格、脚注、GFM 扩展？

  2. 输入输出格式呢？
     - 输入是 Markdown 字符串？
     - 输出只要 HTML，还是也需要 AST？

  3. 技术栈和约束？
     - 用什么语言？TypeScript 还是 Python？
     - 允许依赖第三方库吗？还是要零依赖？
     - ……

它采用 苏格拉底式提问法，通过追问把你的模糊想法变成具体的设计文档。

Brainstorming 的设计哲学

• 分段输出：不是一次甩 5000 字，而是一段一段来，每段等你确认
• 主动发现分歧：如果你描述的是多个独立子系统，它会建议拆分成多个子项目
• 保存设计文档：讨论完之后会生成一份正式的设计文档，作为后续开发的依据

硬性门禁（HARD-GATE）：在用户批准设计方案之前，不得写任何代码。

这一条，从根本上杜绝了 AI 最容易犯的错误：跳过设计直接编码。

第二步：Git Worktrees — 隔离的开发环境

触发时机：设计方案获得批准后自动触发。

批准设计后，它不会直接在当前分支写代码，而是：

• 创建一个新的 Git 分支
• 用 git worktree 创建一个独立的工作目录
• 跑一遍项目现有测试，确保基线是绿的
• 在隔离环境里开始开发

这样做的好处是：

• 不会污染你当前的工作目录
• 可以同时开多个功能分支并行开发
• 搞砸了直接删掉 worktree 就行，干干净净

---

第三步：Writing Plans — 把大象装进冰箱需要几步

触发时机：有了批准的设计后自动触发。

Superpowers 会把工作拆分成一个个 2-5 分钟就能完成的微任务。每个任务都有：

• 精确的文件路径
• 完整的代码变更说明
• 明确的验证步骤

不是「实现用户认证模块」这种大而空的描述——而是具体到：

任务 3/8：添加密码哈希工具函数
文件：src/utils/crypto.ts
新增：hashPassword(password: string): Promise
新增：verifyPassword(password: string, hash: string): Promise
使用 bcryptjs，salt rounds = 10
验证：运行 npm test crypto，三个测试用例全部通过

为什么要拆这么细？因为模型的注意力是有限的。任务越小，出错的概率越低。

这就像给初级工程师派活——你不能说「做个支付系统」，你得说「第一步，先写个加密工具函数，我告诉你接口是什么」。

第四步：Subagent-Driven Development — 子智能体驱动开发

触发时机：有了任务计划后自动触发。

这是 Superpowers 最酷的部分——它不会自己一个人闷头干所有任务。它会为每个任务启动一个独立的子智能体。

每个子智能体：

• 只拿到和当前任务相关的上下文（不是整个项目）
• 专注完成一个小任务
• 写完之后，主智能体会做两阶段审查：

审查通过了，才进入下一个任务。审查不通过，打回子智能体重写。

这意味着什么？意味着你的 Claude Code 可以连续自主工作几个小时，按计划一个任务一个任务推进，不需要你盯着。

你去开个会，回来发现代码已经写完了、测试已经通过了、就等你 review 了。

第五步：TDD — 测试驱动开发

触发时机：实现代码的过程中自动触发。

Superpowers 强制推行 RED-GREEN-REFACTOR 循环：

1. RED    → 先写一个会失败的测试，看着它失败
GREEN  → 写最少的代码让测试通过
REFACTOR → 重构代码，保持测试通过

而且它有一条硬性规则：如果测试是在代码之后写的，删除代码，重走流程。

这听起来很苛刻，但效果显著——

---

第六步：Code Review — 自己审查自己

触发时机：每个任务完成后自动触发。

Superpowers 会让 Claude 自己 review 自己写的代码，对照计划检查：

• 是否按计划实现了？
• 有没有引入计划外的变更？
• 有没有明显的 Bug 或安全问题？

问题按严重程度分级：

Critical 级别的问题，不修好不让往下走。

---

第七步：Finishing Branch — 完美收尾

触发时机：所有任务完成后自动触发。

最后，它会：

• 运行完整的测试套件，确保所有测试通过
• 给你呈现几个选项：

• 清理 worktree

整个流程，从需求到合入，有始有终，干干净净。

---

实测数据：它到底能提升多少？

空口无凭，来看数据。

独立测试结果（12 组对照实验）

一位开发者做了 12 组对照实验——6 次有 Superpowers，6 次没有。同样的任务，同样的 prompt，全自动运行，无人工干预。

Token 反而更少？因为更少的纠正循环意味着更少的来回。每一轮纠正都有延迟和 Token 开销，少走弯路就是省钱又省时间。

社区用户反馈

多个独立用户的实测反馈高度一致：

• 返工率降低 70-90%
• 测试覆盖率从 40% 提升到 85-95%+
• 多文件重构正确率 95%（20 处改对 19 处）
• 并行执行多任务比串行快 3-4 倍

---

安装：30 秒搞定

Claude Code（推荐）

方式一：官方市场

/plugin install superpowers@claude-plugins-official

方式二：Superpowers 专用市场

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

其他平台

Superpowers 支持 11 种编码智能体：

安装完成后，重启你的编码智能体，就生效了。

---

验证是否生效

启动 Claude Code 后，直接说：「帮我规划一个用户登录功能」。

✅ 如果 Claude 回复的不是代码，而是问题（「你想用 JWT 还是 Session？」「有没有现有的认证中间件？」）——说明 Superpowers 已生效。

❌ 如果 Claude 直接开始写代码——说明没生效。

检查一下：

/plugin list | grep superpowers

---

使用建议：什么时候用，什么时候跳过

✅ 强烈推荐开启的场景

• 新功能开发：从零开始做一个模块
• 大型重构：涉及多个文件的改动
• 核心业务逻辑：出错代价高的代码
• 你不熟悉的领域：需要更严谨的流程来保证质量
• 需要长期维护的代码：测试覆盖率很重要

⚠️ 可以考虑跳过的场景

• 改个 typo 或配置项：过度流程反而慢
• 探索性原型：还不确定要做什么，先试试看
• 一次性脚本：用完就扔，不需要维护
• 你 100% 确定要怎么做：不需要 AI 帮你澄清需求

怎么跳过？

很简单——直接告诉它：

「不用 brainstorming，直接写代码。」

「这是个小改动，跳过完整流程。」

---

技能库总览：14 个核心 Skill

Superpowers 内置了 14 个核心 Skill，分为四大类：

测试类

调试类

协作类

元技能

---

设计哲学

Superpowers 背后有四条核心设计原则：

1. Test-Driven Development — 测试先行

写测试不是为了追求覆盖率数字，而是为了逼你先想清楚「正确的行为是什么」。

2. Systematic over ad-hoc — 系统化优于临时应对

遇到问题不是拍脑袋修，而是按流程来：复现 → 定位 → 假设 → 验证 → 修复 → 回归。

3. Complexity reduction — 简化为首要目标

每写一行代码都在增加复杂度。好的工程师，是能在解决问题的同时保持简单的人。

4. Evidence over claims — 证据胜于声明

「修好了」不算数。测试通过了，才算数。

这四条不是什么新鲜东西——它们是软件工程界几十年的共识。Superpowers 做的事情，就是把这些人类工程师的最佳实践，变成 AI 编码智能体的默认行为。

常见问题

Q：它会让开发变慢吗？

短期来看，是的——因为以前 AI 上来就写代码，现在它要先问问题、先做设计、先写测试。

但长期来看，它会快很多。因为你花在返工、调试、擦屁股上的时间大大减少了。

一次做对，比做十次才对，快得多。

Q：小改动也要走完整流程吗？

不用。Superpowers 会根据任务复杂度自动调整。改个 typo 不会触发 brainstorming。

如果它过度干预了，你直接说「这个简单，跳过流程直接改」就行。

Q：它和 Claude Code 原生的 Plan Mode 有什么区别？

Plan Mode 是「先写个计划，然后执行计划」。

Superpowers 是一整套方法论——需求澄清 → 设计 → 规划 → 子智能体开发 → TDD → 审查 → 收尾。计划只是其中一步。

而且 Superpowers 是跨平台的，不只是 Claude Code 能用。

Q：我的代码会被上传吗？

不会。Superpowers 完全在本地运行，所有 Skill 都是 Markdown 文件，没有任何外部服务依赖。

唯一可选的遥测是：brainstorming 的视觉伴侣功能会加载一张 Prime Radiant 的 logo 图片（用于统计使用量），不包含任何项目信息。可以通过环境变量 SUPERPOWERS_DISABLE_TELEMETRY 关闭。

---

适合谁？不适合谁？

✅ 强烈推荐

• 对代码质量有要求的团队和个人
• 经常用 AI 做大型重构或新功能开发的人
• 被 AI 的「看似正确实则有坑」折磨过的人
• 相信工程方法论价值的开发者
• 想让 AI 真正帮你干活而不是帮你添乱的人

⚠️ 需要考虑

• 只做快速原型、不在乎质量 — 流程会显得繁琐
• 改 bug 多于写新功能 — TDD 的价值会打折扣
• 完全不想学新东西 — 虽然是自动触发，但还是需要适应它的节奏

❌ 不推荐

• 只是偶尔用 AI 问个问题
• 写的代码不需要维护（一次性脚本、玩具项目）
• 对速度的要求远高于对质量的要求

---

写在最后

AI 编码智能体的能力已经很强了——强到我们经常忘记，能力不等于质量。

一个天才工程师，如果没有工程纪律，也会写出一团糟的代码。AI 也是一样。

Superpowers 不提升 AI 的智力。它给 AI 穿上了一件「纪律工装」——

• 先想清楚再动手
• 先写测试再写实现
• 做完了自己 review 一遍
• 有始有终，干净利落

这件「工装」，让 AI 从一个「才华横溢但难以驾驭的天才」，变成了「靠谱、稳定、可信赖的合作伙伴」。

而这，才是 AI 真正能帮你提升生产力的样子。

试一下吧。你可能会惊讶——原来 Claude Code 可以这么好用。

---

快速开始（再放一次）

bash
/plugin install superpowers@claude-plugins-official

重启后验证：说"帮我做一个 xxx"
如果它先问你问题而不是直接写代码 → 成功了

祝你编码愉快。

---

参考资料

[1] Superpowers GitHub 仓库：https://github.com/obra/superpowers

[2] 官方发布公告：https://blog.fsck.com/2025/10/09/superpowers/

[3] Claude 官方插件市场：https://claude.com/plugins/superpowers

[4] 作者 Jesse Vincent（obra）：https://blog.fsck.com/

[5] Prime Radiant：https://primeradiant.com/

[6] Discord 社区：https://discord.gg/35wsABTejz

[7] Superpowers Evals（测试框架）：https://github.com/prime-radiant-inc/superpowers-evals/