要点速览
- Superpowers 是一个开源插件，内含 15 个可组合技能——头脑风暴、计划、TDD、调试、worktree、代码评审——装上后 Claude Code 会自动加载。
- 官方市场一行搞定：/plugin install superpowers@claude-plugins-official；或先添加 obra/superpowers-marketplace，再装 superpowers@superpowers-marketplace。
- 作者发布文里写的最低版本是 Claude Code 2.0.13 左右；仓库里的插件清单是 v7.0.2，发布于 2026-11-03。
- 工作流是：头脑风暴 → worktree → 写计划 → 子代理或本地执行 + TDD → 评审 → 收尾分支。代理在每个任务前都会先检查有没有对应技能。
仓库状态核对于 2026-11-11：GitHub 上 315,938 颗星，最新发布 v7.0.2（2026-11-03），最新提交 22f0b463。星数每天都在变，请当作快照看。本页的安装命令、技能名和版本号均照抄自上述来源，未做改写。
Superpowers 到底是什么
Superpowers 是一个 MIT 许可的开源插件——写作时版本为 v7.0.2——它给 Claude Code 的不是又一套工具，而是一套软件开发方法论。它不是模型、不是 API 代理、也不是分叉：它是一个由 15 个技能组成的库，外加一段让代理主动去找并遵循这些技能的引导。
一个技能就是一个装着 SKILL.md 的文件夹：YAML frontmatter 里有 name 和 description，下面是 markdown 指令。description 就是触发器——Claude Code 读它来判断这个技能适不适用。Superpowers 还加了一个会话启动钩子，注入 using-superpowers 引导，所以代理是先找技能再回答，而不是写完代码才想起来。
它由 Prime Radiant 的 Jesse Vincent（obra）开发，2025-10-09 发布——正好是 Anthropic 上线 Claude Code 插件系统的那天。同一个仓库也能装进 Codex、Cursor、Gemini CLI、Copilot CLI、OpenCode 等环境：一套技能库，多个宿主。
- 版本
- v7.0.2 · 2026-11-03
- 最新提交
- 22f0b463
- 许可证
- MIT
在 Claude Code 里安装 Superpowers
两条官方支持的路径，均照抄自仓库 README。请在 Claude Code 会话里执行——它们是斜杠命令，不是终端命令。
路径一 — 官方市场（一行）
第一次启动交互式 Claude Code 会话时，Anthropic 的 claude-plugins-official 市场会被自动添加，所以你只需要这一行安装命令。README 里还给了 claude.com/plugins/superpowers 这个展示页。
/plugin install superpowers@claude-plugins-official路径二 — Superpowers 市场
如果你想要作者自己的市场（里面还有 superpowers-chrome、elements-of-style 等相关插件），先用第一行注册市场，再用第二行按名字安装。
/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplace跑起来之前需要什么
- 1Claude Code 2.0.13 或更新版本——这是作者发布文里为插件流程写下的最低要求。
- 2装完要重启：退出并重新启动 claude，会话启动钩子才会注入引导。
- 3完整工作流需要 git 仓库——worktree 那一步会建独立分支，收尾那一步会给出合并、提 PR 或丢弃的选项。
其他宿主，同一个仓库
README 为每个编码代理都列了一行安装命令。下面照抄原文——运行前建议再读一遍 README，因为命令会随版本变化。
| 宿主 | 安装命令 |
|---|---|
| Codex CLI | /plugins |
| Cursor | /add-plugin superpowers |
| Gemini CLI | gemini extensions install https://github.com/obra/superpowers |
| Copilot CLI | copilot plugin marketplace add obra/superpowers-marketplace |
| Antigravity | agy plugin install https://github.com/obra/superpowers |
| Qwen Code | qwen extensions install obra/superpowers |
| Kimi Code | /plugins install https://github.com/obra/superpowers |
| Factory Droid | droid plugin marketplace add https://github.com/obra/superpowers |
| Grok Build | grok plugin install superpowers@xai-official --trust |
| Pi | pi install git:github.com/obra/superpowers |
| Hermes | hermes plugins install obra/superpowers --enable |
它强制执行的流程
这部分才真正改变了 Claude Code 的行为。以下七步来自 README 的 Basic Workflow 一节，另加一条规则：代理在任何任务前都要先检查有没有对应技能。
- 1
brainstorming（头脑风暴）
动手之前先问清你到底要什么、为什么，再把自己的理解复述给你纠正；比小改动大的事都会写成设计文档。
- 2
using-git-worktrees（隔离工作区）
设计通过后在新分支上建隔离工作区，跑一遍项目初始化，确认测试基线是干净的，再动代码。
- 3
writing-plans（写计划）
把设计拆成每个 2–5 分钟的小任务，每个任务都带准确的文件路径、完整代码和验证步骤。
- 4
subagent-driven-development 或 executing-plans
两种执行方式：每个任务派一个全新子代理并在每次之后评审（最彻底），或在当前会话里逐条实现、最后对整个分支做一次评审（最省）。
- 5
test-driven-development（TDD）
实现期间严格执行 RED-GREEN-REFACTOR：先写会失败的测试，看着它失败，写最少量的代码，看着它通过，提交。先于测试写下的代码会被删掉。
- 6
requesting-code-review（请求评审）
任务之间按计划做评审，问题按严重程度报告——Critical 会阻断继续推进。
- 7
finishing-a-development-branch（收尾）
结束时验证测试，给出合并、提 PR、保留或丢弃的选项，执行你的选择并清理 worktree。
v7.0.2 里的全部 15 个技能
文件夹名就是代理用来匹配的标识符，因此不做翻译。每条描述都改写自提交 22f0b463 时该技能自己的 frontmatter。
测试
test-driven-development
先写测试、看着它失败，再只写够通过的最少代码——附带一份测试反模式参考。
调试
systematic-debugging
面对任何 bug、失败测试或异常行为，在提出修复前先走四阶段根因流程。修症状算失败。
verification-before-completion
在声称工作完成、修好或通过之前，先跑验证命令并读它的输出。
diagnosing-superpowers
会话出问题时，读它的记录稿，用逐行证据报告发生了什么，还可以打包一份脱敏包用于提 issue。
协作
brainstorming
任何创造性工作前必用：通过提问把真实意图挖出来，并在动手前把理解复述确认。
writing-plans
把规格变成一份从没见过这个代码库的工程师也能执行的计划：每个任务给出确切文件、命名、签名与测试。
executing-plans
本地执行计划——你在当前会话里逐任务实现，最后对整个分支做一次全新上下文的评审。
subagent-driven-development
每个任务派一个全新实现子代理，每次之后做规格+质量双重评审，最后对整个分支做一次全面评审。
dispatching-parallel-agents
遇到两个以上互不依赖、无共享状态的任务时，为每个任务构造独立上下文并行分派，而不是串行处理。
requesting-code-review
派一个拿到精确上下文的评审子代理，让问题在任务之间就暴露，而不是拖到最后。
receiving-code-review
如何处理评审意见：先核实再改，先提问再假设，不做表演式认同。
using-git-worktrees
确保存在隔离工作区，优先用平台自带的 worktree 工具，没有才退回手动 git worktree。
finishing-a-development-branch
验证测试、识别环境、给出合并/PR/保留/丢弃选项、执行选择并清理。
元技能
writing-skills
把 TDD 用在流程文档上来创建和修改技能，包括怎么测试一个技能到底会不会被触发。
using-superpowers
引导技能：怎么找技能、怎么加载技能，以及为什么必须在任何回答之前调用。
Superpowers 与原版 Claude Code 对比
原版 Claude Code 已经有 plan mode、原生 skills、子代理、worktree 和插件系统。Superpowers 并没有新增底层能力——它加的是「什么时候该用哪个」的主张，以及一个让这些主张很难被跳过的钩子。
| 对比项 | 原版 Claude Code | 装了 Superpowers |
|---|---|---|
| 流程从哪来 | 每次会话自己选：plan mode、CLAUDE.md 约定，或者手动贴一段提示词。 | 会话启动钩子注入强制技能引导，那套顺序变成默认行为。 |
| 计划环节 | plan mode 产出一份你批准的计划，然后就在同一个上下文里开工。 | brainstorming → 设计文档 → writing-plans，把计划拆成 2–5 分钟、带文件路径和测试的任务。 |
| 隔离与执行 | worktree 和子代理都有，什么时候用由你决定。 | 设计通过后自动跑 using-git-worktrees；再让你在 subagent-driven-development 与 executing-plans 之间选。 |
| 质量关卡 | 测试和评审靠你自己提，或者自己接 hooks 和 CI。 | TDD、verification-before-completion、requesting-code-review 在任务之间自动触发；评审里的 Critical 问题会阻断推进。 |
好处在哪
- 默认行为从「先写代码」变成「先问清楚」——这是最实在的差别，也是作者发布文的主线。
- 技能都很小、可读：每个行为都是一个 markdown 文件，能打开、能 diff、能改，而不是黑盒功能。
- 一套技能库跨宿主复用——同一个仓库能装进 Claude Code、Codex、Cursor、Gemini CLI 等等。
代价在哪
- 更费 token、更多轮次：提问、设计文档、计划和逐任务评审都发生在第一行生产代码之前。
- 刻意强主张——YAGNI、严格 TDD、强制调用技能，更适合新项目，而不是老仓库里的一个紧急修复。
- 又多了一个要跟着更新的东西，而且完整收益假设你在 git 仓库里、且宿主支持子代理。
会话不对劲的时候
如果某个技能在不该触发时触发了、该触发时沉默，或者代理无视自己写的计划，仓库里正好有一个 diagnosing-superpowers 技能。在会话里直接说，要查之前的会话就加上「in session <id>」——它会读记录稿、用证据报告发生了什么，还能打包一份脱敏包用于报 bug。
figure out what went wrong with superpowers in session <id>遥测，以及怎么关掉
README 写得很直白：brainstorming 技能里可选的视觉伴随功能会从 Prime Radiant 站点加载一个 logo，其中带有 Superpowers 版本号，但不含项目、提示词或代理的任何细节。把 SUPERPOWERS_DISABLE_TELEMETRY 设为任意真值即可关闭；Claude Code 的 DISABLE_TELEMETRY 与 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 同样被尊重。