Superpowers 是什么:Claude Code 最火的技能库,7.0 版怎么装、怎么用,旧教程里的命令为什么没了
Superpowers 是一套给 Claude Code、Codex、Cursor 等编程 AI 用的开源技能库和开发流程:先问清需求、再写计划、再按测试驱动一步步实现。本文讲清楚 7.0 版的安装、完整流程、旧教程里 /brainstorm 等命令被删后怎么用,以及两种执行方式的 Token 消耗差别。
Superpowers 是一套开源的编程 AI 技能库,同时也是一套开发流程:动手之前先问清楚你要什么,写成设计和计划,再按测试驱动一步步实现、评审。 它在 GitHub 上是 obra/superpowers,作者是 Jesse Vincent 和 Prime Radiant 团队,MIT 协议,2026-11-13 查看时约 31.7 万星,最新版本是 11-03 发布的 7.0.2。除了 Claude Code,也支持 Codex、Cursor、OpenCode、Copilot CLI 等十几种工具。
先说网上旧教程最常见的问题:/brainstorm、/write-plan、/execute-plan 这三个命令已经删了(2026-04-30 的 5.1.0 版)。现在不用记命令,技能会根据你在做什么自动触发;想手动用,直接让它用对应的技能,比如 superpowers:brainstorming、superpowers:writing-plans、superpowers:executing-plans。另外 10 月的 7.0 版重做了需求讨论环节,问法和旧视频里也不一样了。
安装
Claude Code(推荐用官方插件市场)
/plugin install superpowers@claude-plugins-official
也可以用作者自己的插件市场,里面还有几个相关插件:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
装完新开一个会话。验证方法:发一句 Let's make a react todo list,装好的话它会先开始问需求(brainstorming),而不是直接写代码。
其他工具:每个工具要分别装一次。
| 工具 | 怎么装 |
|---|---|
| Codex CLI | 输入 /plugins,搜 superpowers,选 Install Plugin |
| Codex App | 侧边栏 Plugins → Coding 分类里找 Superpowers,点 + |
| Cursor | 在 Agent 对话里输入 /add-plugin superpowers |
| OpenCode | 让 OpenCode「Fetch and follow instructions from」仓库里的 .opencode/INSTALL.md |
| Copilot CLI | copilot plugin marketplace add obra/superpowers-marketplace,再 copilot plugin install superpowers@superpowers-marketplace |
它的完整流程
装好以后,Claude Code 每次接到任务都会先看有没有该用的技能,这些是强制流程,不是建议:
- brainstorming(需求讨论):先问你为什么要做、要做成什么样,把理解复述给你纠正。小改动在对话里说定,项目级的会写一份设计文档。7.0.2 起问得更少:答案不影响做法的就不问,直接给出它的判断让你改;有选择时列出选项并给推荐。
- using-git-worktrees(隔离工作区):设计确认后,在新分支上建一个独立的 git worktree,装好依赖,确认测试一开始是通过的。
- writing-plans(写计划):把工作拆成 2 到 5 分钟一个的小任务,每个任务写明文件路径、代码和验证步骤。
- 执行计划,二选一(见下面「Token 消耗」):
- subagent-driven-development:每个任务开一个新的子代理去做,做完评审一次。最彻底。
- executing-plans:在当前会话里依次做完所有任务,最后对整个分支评审一次。最省。
- test-driven-development(测试驱动):先写失败的测试、看它失败,再写最少的代码让它通过,然后提交。测试之前写的代码会被删掉,这点要有心理准备。
- requesting-code-review(评审):任务之间按计划评审,问题按严重程度报,严重问题不解决不往下走。
- finishing-a-development-branch(收尾):跑完测试,让你选合并、开 PR、保留还是丢弃,再清理工作区。
作者说过,按定好的计划,它连续自己干一两个小时不跑偏并不少见。
不是每件事都会走全套:7.0 版会先判断工作大小,简单清楚的任务直接做,小改动在对话里定,只有项目级的才写设计文档。你也可以推翻它的判断。
Token 消耗:两种执行方式差别很大
Superpowers 本身不调用任何 API,它只是改变 Claude Code 的做事方式。但这种方式比直接写代码多了很多来回:先讨论、再写计划、写测试、评审,按计划执行时还可能开很多子代理。按 Token 计费的话,最大的变量是第 4 步选哪种执行方式:
- subagent-driven-development:每个任务一个新子代理,外加每个任务一次评审。子代理每次都要重新读相关文件,任务多的时候 Token 消耗明显更高,换来的是每一步都有人复查。
- executing-plans:所有任务在一个会话里做,只在最后评审一次,官方的说法是「最省」。
小功能、改几个文件的,可以直接要求它用 executing-plans;大一点、出错代价高的,再用子代理方式。
如果某次会话明显多花了 Token、重复干活或者没按计划走,可以让它「figure out what went wrong with superpowers in this session」,它会调用 diagnosing-superpowers 技能,读会话记录,指出具体哪一步出了问题。
最准的还是看账单:用 CCSub 的话,控制台「使用记录」里每条请求都有 Token 数和扣费,按时间段加起来就是这次任务的花费。
小心这几点
- 它会建分支和工作区:using-git-worktrees 会在新分支上开 worktree,收尾时让你选怎么处理。没用 git 的目录先
git init并提交一次。 - 测试驱动会删代码:测试之前写的实现会被删掉重写。只想让它改个小 bug,直接说清楚,它会按小任务处理。
- 可视化助手的统计:brainstorming 里可选的可视化页面会从作者网站加载 logo,带上 Superpowers 的版本号,不带项目内容。不想要的话,设环境变量
SUPERPOWERS_DISABLE_TELEMETRY=1;它也认 Claude Code 的DISABLE_TELEMETRY和CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC。 - 更新:多数工具会自动更新插件,旧版的问法和行为可能和这里写的不一样,先把插件更新到最新。
和 API 服务的关系
Superpowers 不碰你的 API 配置,子代理也用 Claude Code 当前的接口和 Key,所以不管接的是官方账号还是第三方服务,装法和用法都一样,不需要额外配置。要注意的只有上面说的 Token 消耗。
还没配置好 Claude Code 的话,先看 Claude Code 接入教程;用 Codex 的看 Codex CLI 接入教程。同样是给 Claude Code 装的插件,记忆插件 claude-mem 用第三方 API 时要多配一步,见 claude-mem 教程。
相关接入教程和报错排查
相关文章
claude-mem 是什么:让 Claude Code 记住上一次做了什么,新版怎么装,用第三方 API 要多配一步
claude-mem 是一个开源的 Claude Code 记忆插件,自动记下每次会话做了什么,下次开新会话时带上。本文讲清楚新版安装时要选的「记忆由谁来记」、用第三方 Anthropic 兼容 API 时怎么让它跟着走、会多花多少 Token,以及中文笔记、隐私开关和常见问题。
Taste Skill 是什么:让 Claude Code 做出不像 AI 的前端页面,2.5 版怎么装、旧版去哪了
Taste Skill 是一个开源的 Claude Code 技能,用来去掉 AI 生成网页的「AI 味」。本文讲清楚现在的 2.5 版和网上教程里的旧版有什么不同、各自怎么安装、运行要求,以及和官方 frontend-design 插件怎么选。
Ponytail 是什么:让 Claude Code 少写代码的插件,怎么装、怎么用、能省多少
Ponytail 是一个 Claude Code 插件,让 AI 只写任务需要的代码。本文讲安装命令、lite / full / ultra 三档用法、作者自测的省 token 数据怎么看,以及怎么用自己的账单验证到底省了多少。