Superpowers 部署和常用指令笔记
Superpowers 是什么
Superpowers 是一个给 AI 编程助手使用的插件。它的核心作用不是提供某个单独命令，而是给助手加上一组更稳定的工作流，例如需求澄清、方案设计、测试驱动开发、系统化调试、代码审查和完成前验证。
平时直接让 AI 改代码，容易出现几个问题：还没弄清需求就开始写、遇到 bug 直接猜、测试没跑就说完成、复杂任务没有拆分。Superpowers 的价值就在于把这些流程变成可触发的技能，让助手在合适的场景下先走正确步骤。
我把它理解成一套“AI 开发流程约束”。它不会替代模型能力，但能让模型更稳定地使用工程方法。
部署方式
不同 AI 工具的安装命令不一样。安装前建议先确认当前工具是否支持插件或扩展。
Claude
Claude 可以直接从官方插件市场安装：
1 | /plugin install superpowers@claude-plugins-official |
如果要从 Superpowers 自己的 marketplace 安装，可以先添加 marketplace：
1 | /plugin marketplace add obra/superpowers-marketplace |
然后安装插件：
1 | /plugin install superpowers@superpowers-marketplace |
更新插件：
1 | /plugin update superpowers |
Cursor
在 Cursor Agent chat 里安装：
1 | /add-plugin superpowers |
Copilot CLI
先添加 marketplace：
1 | copilot plugin marketplace add obra/superpowers-marketplace |
再安装插件：
1 | copilot plugin install superpowers@superpowers-marketplace |
Gemini
Gemini 使用 extensions 安装：
1 | gemini extensions install https://github.com/obra/superpowers |
Codex
Codex 的安装方式需要按官方安装文档执行。官方 README 里给出的入口是拉取并执行下面这个安装说明：
1 | https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md |
如果已经有 Codex 也可以通过输入 /plugins 命令去安装这个插件。
如果已经通过 Codex 插件系统安装成功，通常能在会话里看到 Superpowers 插件，以及一组 superpowers:* 技能。
如何验证是否生效
安装后可以用一个简单任务测试，例如让AI“新增一个小功能”或“修复一个bug”。如果 Superpowers 生效，助手通常会先触发对应技能，而不是立刻动手改代码。
常见表现：
- 新功能或行为变更前，会触发
brainstorming，先确认目标和方案。 - 修 bug 时，会触发
systematic-debugging，先复现和定位根因。 - 写功能或 bugfix 时，会触发
test-driven-development，先写失败测试。 - 准备说完成前，会触发
verification-before-completion，先运行验证命令。 - 复杂任务可能会触发
writing-plans，先生成实施计划。
如果完全没有这些行为，可以检查插件是否安装成功、当前工具是否启用了插件、会话是否需要重启。
常用指令
插件管理
Claude 常用：
1 | /plugin install superpowers@claude-plugins-official |
Cursor 常用：
1 | /add-plugin superpowers |
Copilot CLI 常用：
1 | copilot plugin marketplace add obra/superpowers-marketplace |
Gemini 常用：
1 | gemini extensions install https://github.com/obra/superpowers |
常用技能
Superpowers 真正常用的是技能，不是单纯的安装命令。下面这些是日常开发里最容易用到的。
using-superpowers
会话开始时的基础技能。它的作用是提醒助手：收到任务后先判断有没有适用技能，而不是直接凭感觉开始做。
适合场景：
- 开始任何新任务。
- 不确定当前任务应该用哪个流程。
- 想让助手遵守 Superpowers 的技能触发规则。
brainstorming
做新功能、改行为、设计组件之前使用。它会先探索项目上下文，再确认需求，最后提出方案。
适合场景：
- 新增功能。
- 修改已有交互或业务逻辑。
- 写一篇需要结构设计的文章。
- 还没完全确定要怎么做。
writing-plans
把已经确认的设计拆成可执行计划。适合任务较大、步骤较多、需要按阶段完成时使用。
适合场景：
- 多文件改动。
- 需要先测试再实现。
- 需要拆分任务顺序。
- 希望 AI 按计划执行，而不是边想边改。
test-driven-development
实现功能或修复 bug 前使用。核心流程是先写失败测试，再写最小实现，最后重构。
适合场景：
- 代码逻辑容易回归。
- bug 有明确复现条件。
- 修改共享模块。
- 希望避免“看起来能跑”的实现。
systematic-debugging
遇到 bug、测试失败或异常行为时使用。它强调先复现、再定位根因，避免直接猜。
适合场景：
- 测试失败。
- 线上行为和预期不一致。
- 错误原因不明显。
- 已经修了几次但问题反复出现。
requesting-code-review
完成较大的功能后，让另一个视角审查改动。重点看 bug、风险、回归和遗漏测试。
适合场景：
- 改动范围比较大。
- 准备合并前。
- 需要检查实现是否符合原计划。
- 想发现自己没注意到的问题。
verification-before-completion
准备说“完成”“已修复”“测试通过”之前使用。它要求先运行能证明结论的命令，再给结论。
适合场景：
- 准备提交最终结果。
- 准备告诉用户测试通过。
- 准备部署或同步。
- 需要避免没有验证就下结论。
finishing-a-development-branch
开发分支完成后使用。它会帮助确认测试、合并、PR、清理工作区等收尾动作。
适合场景：
- 功能已经做完。
- 测试已经通过。
- 准备合并到主分支。
- 需要决定是开 PR、合并、保留还是丢弃分支。
我的使用建议
如果只是问一个知识点，不一定需要强制走完整流程。但只要涉及代码改动、文章结构、功能设计或 bug 修复，就适合让 Superpowers 介入。
我个人会这样用：
- 新功能：先
brainstorming，确认方案后再写计划。 - bug：先
systematic-debugging，不要直接让 AI 猜修复。 - 代码实现：优先
test-driven-development，尤其是核心逻辑。 - 完成前：必须
verification-before-completion，让结论有命令输出支撑。 - 大改动：最后用
requesting-code-review再看一遍。
常见问题
安装后没有触发技能
先重启当前 AI 工具或新开一个会话，再确认插件是否启用。有些工具安装插件后不会影响已经打开的旧会话。
不同工具的命令不一样
这是正常的。Claude、Cursor、Copilot CLI、Gemini 和 Codex 的插件系统不同，安装命令不能混用。文章里的命令要按当前工具选择。
技能流程看起来比较慢
Superpowers 的目标不是最快生成答案，而是减少返工。简单任务可能显得步骤多，但在复杂功能、调试和上线前验证时，流程约束通常能省掉更多时间。
Codex 里怎么判断是否安装成功
可以看会话可用技能列表里是否出现 superpowers:*，例如 superpowers:brainstorming、superpowers:systematic-debugging、superpowers:verification-before-completion 等。如果能被自动触发，说明基本可用。
总结
Superpowers 更像是一套 AI 编程工作流，而不是普通插件。部署完成后，真正需要熟悉的是常用技能的触发场景：设计用 brainstorming，调试用 systematic-debugging，实现用 test-driven-development，完成前用 verification-before-completion。
对个人使用来说，不需要一开始记住所有技能。先把“需求先确认、bug 先复现、完成前先验证”这几件事用起来，就能明显减少 AI 编程时的返工。