Superpowers：Agent 开发的完整方法论框架

Superpowers 是一套面向 coding agent 的完整软件开发方法论。它构建在一组可组合的 skills 之上，并通过一些初始指令确保你的 Agent 会使用这些 skills。

赋予你的 Agent Superpowers：Claude Code、Antigravity、Codex App、Codex CLI、Cursor、Factory Droid、Gemini CLI、GitHub Copilot CLI、Kimi Code、OpenCode、Pi。

从启动 coding agent 的那一刻起，Superpowers 就开始发挥作用。Agent 一发现你准备构建某个东西，并不会立刻跳进去尝试编写代码，而是先退一步，询问你真正想做什么。

通过对话梳理出 spec 后，它会把 spec 分成足够短的小段展示给你，让你确实能够读完并消化其中的内容。

当你确认设计之后，Agent 会制订一份足够清晰的实现计划，即使是一名热情高涨，但品味糟糕、缺乏判断力、不了解项目背景并且讨厌测试的初级工程师，也能按照计划执行。计划强调真正的红灯/绿灯 TDD、YAGNI（You Aren't Gonna Need It，你不会需要它）以及 DRY。

接下来，只要你说一声 “go”，它就会启动由 subagent 驱动的开发流程，让各个 Agent 分别完成每一项工程任务，同时检查和审查它们的工作，然后继续向前推进。你的 Agent 经常可以一次自主工作几个小时，同时不偏离你们共同制订的计划。

这套系统还有很多其他内容，但以上就是它的核心。由于这些 skills 会自动触发，因此你不需要执行任何特殊操作。你的 coding agent 就这样拥有了 Superpowers。

如果你在企业环境中使用 Superpowers，并且需要商业支持、更多工具或托管支出服务，请随时发送邮件至 sales@primeradiant.com 与我们联系。

不同 harness 的安装方式有所不同。如果你使用多个 harness，需要分别为每个 harness 安装 Superpowers。

Superpowers 已上架 Claude 官方插件市场。

从 Anthropic 官方市场安装插件：/plugin install superpowers@claude-plugins-official

从 Anthropic 官方市场安装插件：

/plugin install superpowers@claude-plugins-official

Superpowers marketplace 为 Claude Code 提供 Superpowers 以及其他一些相关插件。

注册 marketplace：/plugin marketplace add obra/superpowers-marketplace

注册 marketplace：

/plugin marketplace add obra/superpowers-marketplace

从该 marketplace 安装插件：/plugin install superpowers@superpowers-marketplace

从该 marketplace 安装插件：

/plugin install superpowers@superpowers-marketplace

将此仓库中的 Superpowers 安装为插件：

agy plugin install https://github.com/obra/superpowers

Antigravity 会运行该插件的 session-start hook，因此 Superpowers 从第一条消息开始就会生效。需要更新时，使用相同的命令重新安装即可。

Superpowers 已上架 Codex 官方插件市场。

在 Codex App 中，点击侧边栏里的 Plugins。

你应该能在 Coding 分类中看到 Superpowers。

点击 Superpowers 旁边的 +，然后按照提示操作。

Superpowers 已上架 Codex 官方插件市场。

打开插件搜索界面：/plugins

打开插件搜索界面：

/plugins

搜索 Superpowers：superpowers

搜索 Superpowers：

superpowers

选择 Install Plugin。

选择 Install Plugin。

在 Cursor Agent 聊天中，从 marketplace 安装：/add-plugin superpowers

在 Cursor Agent 聊天中，从 marketplace 安装：

/add-plugin superpowers

或者在插件 marketplace 中搜索 “superpowers”。

或者在插件 marketplace 中搜索 “superpowers”。

注册 marketplace：droid plugin marketplace add https://github.com/obra/superpowers

注册 marketplace：

droid plugin marketplace add https://github.com/obra/superpowers

安装插件：droid plugin install superpowers@superpowers

droid plugin install superpowers@superpowers

安装 extension：gemini extensions install https://github.com/obra/superpowers

安装 extension：

gemini extensions install https://github.com/obra/superpowers

后续更新：gemini extensions update superpowers

gemini extensions update superpowers

注册 marketplace：copilot plugin marketplace add obra/superpowers-marketplace

注册 marketplace：

copilot plugin marketplace add obra/superpowers-marketplace

安装插件：copilot plugin install superpowers@superpowers-marketplace

copilot plugin install superpowers@superpowers-marketplace

Superpowers 已上架 Kimi Code 的插件 marketplace。

打开 Kimi Code 的插件管理器：/plugins

打开 Kimi Code 的插件管理器：

/plugins

前往 Marketplace > Superpowers 并完成安装。

前往 Marketplace > Superpowers 并完成安装。

或者直接从此仓库安装：/plugins install https://github.com/obra/superpowers

或者直接从此仓库安装：

/plugins install https://github.com/obra/superpowers

详细文档：docs/README.kimi.md

详细文档：docs/README.kimi.md

OpenCode 使用自己的插件安装机制；即使你已经在其他 harness 中使用 Superpowers，也需要为 OpenCode 单独安装。

告诉 OpenCode：Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

详细文档：docs/README.opencode.md

详细文档：docs/README.opencode.md

将此仓库中的 Superpowers 安装为 Pi package：

pi install git:github.com/obra/superpowers

在本地开发时，运行 Pi，并将当前 checkout 作为临时 package 加载：

pi -e /path/to/superpowers

这个 Pi package 会加载 Superpowers skills，以及一个小型 extension。该 extension 会在会话启动时，以及上下文压缩后，再次注入 using-superpowers bootstrap。Pi 原生支持 skills，因此不需要兼容性的 Skill 工具。Subagent 和任务列表工具仍然是可选的 Pi 配套 package。

brainstorming —— 在编写代码前激活。通过提问完善粗略构想、探索替代方案，并将设计分段展示出来供你确认。保存设计文档。

brainstorming —— 在编写代码前激活。通过提问完善粗略构想、探索替代方案，并将设计分段展示出来供你确认。保存设计文档。

using-git-worktrees —— 在设计获批后激活。在新分支上创建隔离的工作区，完成项目初始化，并验证测试基线是干净的。

using-git-worktrees —— 在设计获批后激活。在新分支上创建隔离的工作区，完成项目初始化，并验证测试基线是干净的。

writing-plans —— 在设计获批后激活。把工作拆解成小粒度任务，每项任务耗时 2～5 分钟。每项任务都包含准确的文件路径、完整代码和验证步骤。

writing-plans —— 在设计获批后激活。把工作拆解成小粒度任务，每项任务耗时 2～5 分钟。每项任务都包含准确的文件路径、完整代码和验证步骤。

subagent-driven-development 或 executing-plans —— 在计划就绪后激活。为每项任务派遣一个全新的 subagent，并进行两阶段审查——先检查是否符合 spec，再检查代码质量；或者分批执行，并设置人工检查点。

subagent-driven-development 或 executing-plans —— 在计划就绪后激活。为每项任务派遣一个全新的 subagent，并进行两阶段审查——先检查是否符合 spec，再检查代码质量；或者分批执行，并设置人工检查点。

test-driven-development —— 在实现期间激活。强制执行 RED-GREEN-REFACTOR：编写失败的测试，亲眼确认它失败；编写最少量的代码，亲眼确认测试通过；然后提交。凡是在测试之前编写的代码都会被删除。

test-driven-development —— 在实现期间激活。强制执行 RED-GREEN-REFACTOR：编写失败的测试，亲眼确认它失败；编写最少量的代码，亲眼确认测试通过；然后提交。凡是在测试之前编写的代码都会被删除。

requesting-code-review —— 在任务之间激活。根据计划进行审查，并按严重程度报告问题。严重问题会阻止流程继续推进。

requesting-code-review —— 在任务之间激活。根据计划进行审查，并按严重程度报告问题。严重问题会阻止流程继续推进。

finishing-a-development-branch —— 在所有任务完成后激活。验证测试，提供多个选项（合并、创建 PR、保留或丢弃），并清理 worktree。

finishing-a-development-branch —— 在所有任务完成后激活。验证测试，提供多个选项（合并、创建 PR、保留或丢弃），并清理 worktree。

Agent 会在执行任何任务之前检查相关 skills。这些是强制执行的工作流，而不是建议。

test-driven-development —— RED-GREEN-REFACTOR 循环（包含测试反模式参考资料）

systematic-debugging —— 四阶段根因分析流程（包含 root-cause-tracing、defense-in-depth 和 condition-based-waiting 技术）

verification-before-completion —— 确保问题确实已经修复

brainstorming —— 通过苏格拉底式提问完善设计

writing-plans —— 制订详细的实现计划

executing-plans —— 设置检查点，分批执行

dispatching-parallel-agents —— 并发 subagent 工作流

requesting-code-review —— 审查前检查清单

receiving-code-review —— 响应审查反馈

using-git-worktrees —— 并行开发分支

finishing-a-development-branch —— 合并或创建 PR 的决策工作流

subagent-driven-development —— 通过两阶段审查快速迭代：先检查是否符合 spec，再检查代码质量

writing-skills —— 遵循最佳实践创建新的 skills（包含测试方法论）

using-superpowers —— skills 系统简介

Test-Driven Development —— 始终先编写测试

Systematic over ad-hoc —— 用系统化流程取代临时猜测

Complexity reduction —— 将简单性作为首要目标

Evidence over claims —— 在宣布成功之前进行验证

阅读最初的版本发布公告。

下面是 Superpowers 的常规贡献流程。请注意，我们通常不接受新增 skills 的贡献；对现有 skills 的任何更新，也必须适用于我们支持的所有 coding agent。

切换到 dev 分支

为你的工作创建一个分支

按照 writing-skills skill 创建并测试新增或修改后的 skills

提交 PR，并确保完整填写 pull request 模板。

Skill 行为测试使用来自 superpowers-evals 的 drill eval harness，该仓库会被克隆到 evals/ 中——设置方法请参阅 evals/README.md。插件基础设施测试位于 tests/，通过相应的 run-*.sh 或 npm test 运行。

完整指南请参阅 skills/writing-skills/SKILL.md。

Superpowers 的更新方式在一定程度上取决于 coding agent，但通常会自动完成。

MIT License——详情请参阅 LICENSE 文件。

Visual companion 遥测

由于 skills 和插件不会向创建者提供任何反馈，我们完全不知道有多少人在使用 Superpowers。默认情况下，brainstorming 可选 visual companion 功能中的 Prime Radiant logo 会从我们的网站加载，其中包含当前使用的 Superpowers 版本。它不包含你的项目、prompt 或 coding agent 的任何详细信息。我们看不到你的点击行为，也不知道你正在构建什么。这些信息只是帮助我们粗略了解有多少人在使用 Superpowers，以及他们使用的是哪个版本。该功能完全可选。如需禁用，请将环境变量 SUPERPOWERS_DISABLE_TELEMETRY 设置为任意 true 值。Superpowers 同样遵循 Claude Code 的 DISABLE_TELEMETRY 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 退出设置。

Superpowers 由 Jesse Vincent 和 Prime Radiant 的其他成员共同打造。

Discord：加入我们的社区，获取支持、提出问题，并分享你使用 Superpowers 构建的项目

Issues：https://github.com/obra/superpowers/issues

版本发布公告：订阅通知，及时获悉新版本