Superpowers 超能力

Superpowers 是一套完整的软件开发方法论，适用于你的编程代理（coding agents），它构建在一组可组合的技能（skills）和若干初始指令之上，确保你的代理能够使用这些技能。

快速开始

为你的编程代理赋予 Superpowers：Claude Code、Antigravity、Codex App、Codex CLI、Cursor、Factory Droid、Gemini CLI、GitHub Copilot CLI、Kimi Code、OpenCode、Pi。

工作原理

从你启动编程代理的那一刻起，它就开始工作了。当它发现你正在构建某个东西时，它不会直接跳入编写代码的环节。相反，它会退一步，询问你真正想要实现的目标。一旦它从对话中提炼出规格说明（spec），它会以足够短、便于你实际阅读和消化的片段展示给你。

在你确认设计之后，你的代理会制定一份实现计划，这份计划清晰到即使是一位热情但品味不佳、缺乏判断力、没有项目背景且厌恶测试的初级工程师也能照着执行。它强调真正的红/绿测试驱动开发（TDD）、YAGNI（你不需要它）和 DRY（不要重复自己）原则。

接下来，一旦你说“开始”，它会启动一个子代理驱动开发（subagent-driven-development）流程，让代理逐个完成每个工程任务，检查并审查它们的工作，然后继续推进。你的代理连续自主工作几个小时而不偏离你制定的计划，这种情况并不罕见。

除此之外还有很多内容，但以上是系统的核心。由于这些技能会自动触发，你不需要做任何特殊操作。你的编程代理天生就拥有 Superpowers。

商业服务

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

安装

安装方式因宿主（harness）而异。如果你使用多个宿主，请为每个宿主分别安装 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 hook），因此 Superpowers 从第一条消息起就处于激活状态。使用相同命令重新安装即可更新。

Codex App

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

从此仓库将 Superpowers 安装为 Pi 包：

pi install git:github.com/obra/superpowers

用于本地开发时，将此检出目录作为临时包运行 Pi：

pi -e /path/to/superpowers

Pi 包会加载 Superpowers 技能以及一个小型扩展，该扩展在会话启动时以及压缩（compaction）后注入 using-superpowers 引导程序。Pi 原生支持技能，因此不需要兼容性技能工具。子代理和任务列表工具仍然是可选的 Pi 配套包。

基本工作流程

• brainstorming（头脑风暴） — 在编写代码之前激活。通过提问完善粗略的想法，探索替代方案，分节展示设计以供验证。保存设计文档。
• using-git-worktrees（使用 Git 工作树） — 在设计批准后激活。在新分支上创建隔离的工作区，运行项目设置，验证干净的测试基线。
• writing-plans（编写计划） — 在设计获批后激活。将工作分解为小任务（每个 2-5 分钟）。每个任务都有精确的文件路径、完整代码和验证步骤。
• subagent-driven-development（子代理驱动开发）或 executing-plans（执行计划） — 在有计划时激活。为每个任务派遣全新的子代理，进行两阶段审查（先检查规格符合性，再检查代码质量），或分批执行并在人工检查点暂停。
• test-driven-development（测试驱动开发） — 在实现期间激活。强制执行 RED-GREEN-REFACTOR（红-绿-重构）循环：编写失败的测试，观察其失败，编写最小代码，观察其通过，提交。删除在测试之前编写的代码。
• requesting-code-review（请求代码审查） — 在任务之间激活。对照计划进行审查，按严重程度报告问题。严重问题会阻止进度。
• finishing-a-development-branch（完成开发分支） — 在任务完成时激活。验证测试，呈现选项（合并/PR/保留/丢弃），清理工作树。