Superpowers

Superpowers 是一种专为编码智能体设计的完整软件开发方法论，它基于一系列可组合的技能以及一些初始指令构建，这些指令能确保智能体正确使用这些技能。

快速入门

为您的智能体配备 Superpowers：Claude Code、Antigravity、Codex App、Codex CLI、Cursor、Factory Droid、Gemini CLI、GitHub Copilot CLI、Kimi Code、OpenCode、Pi。

工作原理

从您启动编码智能体的那一刻起，它就开始发挥作用。一旦检测到您正在构建某些内容，它并不会直接着手编写代码，而是会先退一步，询问您真正的目标是什么。

通过对话逐步明确需求后，它会将设计内容分块展示给您，每块的篇幅都短到足以让您轻松阅读和理解。

在您确认设计方案后，智能体便会制定出一个实施计划，这个计划即便交给一个缺乏审美、没有判断力、不了解项目背景且讨厌测试的初级工程师，也能清晰地照着执行。该计划强调真正的红/绿 TDD、YAGNI（你不需要它）以及 DRY 原则。

接下来，一旦您下达“开始”指令，系统就会启动子智能体驱动开发流程，让多个智能体依次处理各项工程任务，互相检查与评审，然后持续推进工作。通常情况下，您的智能体可以连续数小时自主工作，而不会偏离您制定的计划。

其实其中还有许多细节，但以上就是该系统的核心内容。由于相关技能会自动触发，您无需做任何特殊操作——您的编码智能体天生就拥有 Superpowers。

商业服务

如果您在企业环境中使用 Superpowers，并且需要商业支持、额外的工具或托管式支出管理服务，请随时通过 sales@primeradiant.com 与我们联系。

安装

不同集成框架的安装方式各不相同。如果您使用了多个框架，请分别为每个框架单独安装 Superpowers。

Claude Code

Superpowers 可通过官方 Claude 插件市场获取。

官方市场

从 Anthropic 的官方市场安装插件：

/plugin install superpowers@claude-plugins-official

Superpowers 市场

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

注册该市场：

/plugin marketplace add obra/superpowers-marketplace

从该市场安装插件：

/plugin install superpowers@superpowers-marketplace

Antigravity

请从该仓库以插件形式安装 Superpowers：

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

Antigravity 会触发该插件的 session-start 钩子，因此从第一条消息开始 Superpowers 就已处于激活状态。如需更新，可使用相同命令重新安装。

Codex 应用

Superpowers 可通过官方 Codex 插件市场获取。

在 Codex 应用中，点击侧边栏中的 Plugins。
您应在 Coding 部分看到 Superpowers。
点击 Superpowers 旁边的 +，然后按照提示操作。

Codex CLI

Superpowers 可通过官方 Codex 插件市场获取。

打开插件搜索界面：
```
/plugins
```
搜索 Superpowers：
```
superpowers
```
选择 Install Plugin。

Cursor

在 Cursor Agent 聊天界面中，从市场进行安装：
```
/add-plugin superpowers
```
或者在插件市场中搜索 “superpowers”。

Factory Droid

注册市场：

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

安装插件：

droid plugin install superpowers@superpowers

Gemini CLI

安装扩展程序：

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

后续再更新：
```
gemini extensions update superpowers
```

GitHub Copilot CLI

注册市场：

copilot plugin marketplace add obra/superpowers-marketplace

安装插件：

copilot plugin install superpowers@superpowers-marketplace

Kimi Code

Superpowers 可在 Kimi Code 的插件市场中找到。

打开 Kimi Code 的插件管理器：
```
/plugins
```
转到 Marketplace > Superpowers，然后进行安装。

或者直接从该仓库安装：

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

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

OpenCode

OpenCode 使用其自身的插件安装机制；即便您已在其他工具中使用了 Superpowers，仍需单独为其安装。

告诉 OpenCode：

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

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

Pi

从该仓库以 Pi 包的形式安装 Superpowers：

pi install git:github.com/obra/superpowers

对于本地开发，可运行 Pi，并将此代码检出作为临时包加载：

pi -e /path/to/superpowers

Pi 包会加载 Superpowers 的技能，以及一个小型扩展程序，该扩展会在会话启动时以及压缩处理后再次注入 using-superpowers bootstrap。由于 Pi 自带技能，因此无需使用兼容性 Skill 工具。Subagent 和任务列表工具仍属于可选的 Pi 附加包。

基本工作流程

brainstorming - 在编写代码之前激活。通过提问来完善初步想法，探索各种替代方案，分章节展示设计内容以供验证，并保存设计文档。
using-git-worktrees - 在设计获得批准后激活。在新分支上创建隔离的工作空间，运行项目设置流程，确认测试基准是干净的。
writing-plans - 在设计获批后激活。将工作分解为时长为 2-5 分钟的小任务。每个任务都包含确切的文件路径、完整的代码以及验证步骤。
subagent-driven-development 或 executing-plans —— 随计划启动。为每个任务派遣新的子代理，并进行两阶段审查（先检查规范合规性，再检查代码质量），或以批次方式执行并设置人工检查点。
test-driven-development —— 在实现阶段启动。遵循 RED-GREEN-REFACTOR 流程：编写失败的测试用例，观察其失败，编写最简代码，观察其通过，然后提交代码。同时会删除在编写测试之前产生的代码。
requesting-code-review —— 在任务之间启动。根据计划进行审查，并按严重程度报告问题。严重问题会阻碍进度。
finishing-a-development-branch —— 当任务完成后启动。验证测试结果，提供合并/提交 Pull Request/保留/丢弃等选项，并清理工作树。

在任何任务开始前，该代理都会检查相关技能是否具备。 这些是强制性的工作流程，而非建议。

内容概览

技能库

测试

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

调试

systematic-debugging —— 四阶段根本原因分析流程（包含根本原因追踪、深度防御、基于条件的等待技术）
verification-before-completion —— 确保问题确实已解决

协作

brainstorming —— 苏格拉底式设计优化
writing-plans —— 详细的实施计划
executing-plans —— 带有检查点的批量执行
dispatching-parallel-agents —— 并行子代理工作流
requesting-code-review —— 审核前的检查清单
receiving-code-review —— 回复反馈
using-git-worktrees —— 并行开发分支
finishing-a-development-branch —— 合并/提交 Pull Request 的决策流程
subagent-driven-development —— 带有两阶段审查的快速迭代（先检查规范合规性，再检查代码质量）

元技能

writing-skills —— 按照最佳实践创建新技能（包含测试方法论）
using-superpowers —— 技能系统简介

设计理念

Test-Driven Development —— 始终先编写测试用例
Systematic over ad-hoc —— 依赖流程而非凭直觉猜测
Complexity reduction —— 简化是首要目标
Evidence over claims —— 在宣称成功之前先进行验证

阅读原始发布公告。

贡献方式

Superpowers 的通用贡献流程如下。请注意，我们通常不接受新技能的贡献，且任何技能的更新都必须能在我们支持的所有编程代理中正常使用。

复制该仓库的副本
切换到 ‘dev’ 分支
为你的工作创建一个新分支
依照 writing-skills 中的步骤来创建和测试新的以及经过修改的技能
提交 Pull Request，务必填写好 Pull Request 模板。

技能行为测试使用来自 superpowers-evals 的 drill eval harness，该工具已克隆到 evals/ 中——具体设置方式请参见 evals/README.md。插件基础设施测试则位于 tests/，通过相应的 run-*.sh 或 npm test 工具来运行。

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

更新

Superpowers 的更新在某种程度上取决于编码代理，但通常会自动进行。

许可证

MIT 许可证——详情请参见 LICENSE 文件。

可视化辅助功能遥测数据

由于技能和插件无法向创建者提供任何反馈，我们无从知晓有多少人在使用 Superpowers。默认情况下，头脑风暴功能中可选的可视化辅助特性所显示的 Prime Radiant 徽标是从我们的网站加载的，该徽标会标明当前使用的 Superpowers 版本，但不会包含有关你的项目、提示词或编码代理的任何细节。我们无法看到你的点击操作或你在构建的内容。这些数据有助于我们大致了解使用 Superpowers 的人数以及他们所使用的版本。这一功能完全是可选的。若要禁用它，可将环境变量 SUPERPOWERS_DISABLE_TELEMETRY 设置为任何值为 true 的值。Superpowers 也会尊重 Claude Code 的 DISABLE_TELEMETRY 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 取消选项。

社区

Superpowers 由 Jesse Vincent 以及 Prime Radiant 的其他成员共同开发。

Discord：加入我们，获取社区支持、解答疑问，以及分享你使用 Superpowers 所创建的内容
问题反馈：https://github.com/obra/superpowers/issues
版本发布公告：注册，即可收到新版本的通知