Superpowers¶
Superpowers 是一套为你的编码代理（coding agents）打造的完整软件开发方法论，它构建在一组可组合的技能和若干初始指令之上，这些指令能确保你的代理使用这些技能。
目录¶
- 工作原理
- 商业服务
- 快速开始
- Claude Code
- Antigravity
- Codex App
- Codex CLI
- Cursor
- Devin CLI
- Factory Droid
- Gemini CLI
- GitHub Copilot CLI
- Grok Build CLI
- Kimi Code
- OpenCode
- Pi
- Qwen Code
- Hermes Agent
- Muse
- 基本工作流程
- 出问题时
- 社区
- 包含内容
- 哲学
- 贡献
- 更新
- 许可证
- 可视化伴侣遥测
工作原理¶
从你启动编码代理的那一刻起，它就开始起作用。当它看到你在构建某些东西时，它不会直接跳进去尝试写代码。相反，它会退一步，询问你到底想做什么。
一旦它从对话中提取出一份规格说明，就会以足够短的片段展示给你，让你能够真正阅读和理解。
在你对设计签字确认后，你的代理会整理出一份清晰的 Implementation Plan，即使是一位品味不佳、毫无判断力、不了解项目背景、还讨厌测试的热情初级工程师也能照着执行。它强调真正的 red/green TDD、YAGNI（You Aren't Gonna Need It）和 DRY。
接下来，一旦你说“开始”，它就会启动一个子代理驱动开发（subagent-driven-development）流程，让多个代理逐一完成每项工程任务，检查并审查它们的工作，然后继续推进。你的代理连续自主工作几个小时、且不偏离你制定的计划，这种情况并不少见。
这个系统远不止这些，但以上是其核心。而且由于这些技能会自动触发，你不需要做任何特殊操作。你的编码代理只是拥有了 Superpowers。
商业服务¶
如果你在企业环境中使用 Superpowers，并且可能受益于商业支持、额外工具或托管支出，请随时通过 sales@primeradiant.com 与我们联系。
安装¶
不同宿主（harness）的安装方式有所不同。如果你使用多个宿主，请分别为每一个安装 Superpowers。
Claude Code¶
Superpowers 可通过官方 Claude 插件市场获取。
官方市场¶
- 从 Anthropic 的官方市场安装插件：
Superpowers 市场¶
Superpowers 市场提供 Superpowers 以及一些其他相关插件，供 Claude Code 使用。
- 注册市场：
- 从该市场安装插件：
Antigravity¶
从本仓库将 Superpowers 安装为插件：
Antigravity 会列出每个已安装技能的描述，而 using-superpowers 技能的描述会提示模型在对话开始时加载该技能。使用相同的命令重新安装即可更新。
Codex App¶
Superpowers 可通过官方 Codex 插件市场获取。
- 在 Codex 应用中，点击侧边栏中的 Plugins。
- 你会在 Coding 部分看到
Superpowers。 - 点击 Superpowers 旁边的
+并按照提示操作。
Codex CLI¶
Superpowers 可通过官方 Codex 插件市场获取。
- 打开插件搜索界面：
- 搜索 Superpowers：
- 选择
Install Plugin。
Cursor¶
- 在 Cursor Agent 聊天中，从市场安装：
- 或者在插件市场中搜索“superpowers”。
Devin CLI¶
- 从本仓库安装插件：
- 使用以下命令更新到最新版本：
Factory Droid¶
- 注册市场：
- 安装插件：
Gemini CLI¶
- 安装扩展：
- 稍后更新：
GitHub Copilot CLI¶
- 注册市场：
- 安装插件：
Grok Build CLI¶
Superpowers 可通过官方 Grok 插件市场获取。
- 从 xAI 的官方市场安装插件：
- 或者在 TUI 中打开市场，搜索 Superpowers 并安装：
Kimi Code¶
Superpowers 可在 Kimi Code 的插件市场中获取。
- 打开 Kimi Code 的插件管理器：
-
进入
Marketplace>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
Pi¶
从本仓库将 Superpowers 安装为 Pi 包：
进行本地开发时，在 Pi 中运行如下命令，将此检出加载为临时包：
Pi 包会加载 Superpowers 技能和一个小型扩展，该扩展会在会话启动时以及压缩后再次注入 using-superpowers 引导程序。Pi 原生支持技能，因此无需兼容性的 Skill 工具。Subagent 和任务列表工具仍作为可选的 Pi 伴生包提供。
Qwen Code¶
Qwen Code 直接从 Claude Code 市场安装插件。
- 从该仓库安装插件，并在提示时选择
superpowers：
- 之后更新：
Hermes Agent¶
从该仓库将 Superpowers 安装为 Hermes 插件：
安装后，重启所有活动的 Hermes 会话。注意：Hermes 没有压缩后钩子，因此如果某个超长会话在首轮之后发生压缩，就会丢失引导程序——如果技能停止触发，请开启新会话。
Muse¶
Superpowers 可作为原生 Muse 插件使用——同一仓库、同一套技能、适用于所有工具框架。using-superpowers 引导程序会与 Claude Code、Codex、Cursor、Gemini、Pi 等一起，通过原生 SessionStart 钩子注入——无需逐个会话选择启用。
- 从本地检出安装：
或克隆并安装：
git clone https://github.com/obra/superpowers.git
muse plugins install ./superpowers
muse plugins approve superpowers
- 之后更新：
安装后重启所有活动的 Muse 会话，以便 SessionStart 钩子生效——技能会立即生效，但钩子在首次安装时需要批准。要验证，请开启一个新会话并发送 Let's make a react todo list——安装正常的话，会在编写任何代码之前自动触发 brainstorming。版本号由 .version-bump.json 记录，因此 scripts/bump-version.sh 可使其保持同步。
基本工作流程¶
-
brainstorming - 在任何构建之前激活。通过提问让你描述自己真正想要的内容以及原因，再将它的理解反馈给你进行修正。小的改动在对话中确认；项目则会得到一份书面的设计文档，构建者可以据此制定计划。
-
using-git-worktrees - 设计获批后激活。在新分支上创建隔离的工作区，运行项目初始化，并验证干净的测试基线。
-
writing-plans - 在获批的设计下激活。将工作分解为小任务（每个 2-5 分钟）。每个任务都有确切文件路径、完整代码和验证步骤。
-
subagent-driven-development 或 executing-plans - 有计划后激活。要么为每个任务分派一个新的 subagent，并在每个任务后进行审查（最彻底）；要么在当前会话中内联实现所有任务，并在最后对整个分支做一次全新审查（最经济）。
-
test-driven-development - 在实现期间激活。强制执行 RED-GREEN-REFACTOR：编写失败测试，观察它失败，编写最少代码，观察它通过，然后提交。删除在测试之前编写的代码。
-
requesting-code-review - 在任务之间激活。对照计划进行审查，按严重程度报告问题。严重问题会阻塞进度。
-
finishing-a-development-branch - 任务完成时激活。验证测试，提供选项（merge/PR/keep/discard），并清理 worktree。
编码代理会在任何任务之前检查相关技能。 这些是强制工作流程，而非建议。
当出现问题¶
有时会话会行为异常：某个技能在不该触发时触发，在该触发时却保持沉默，或者编码代理忽略其计划、重复工作、或消耗比你预期更多的 token。请让你的编码代理执行“figure out what went wrong with superpowers in this session”，它将调用 diagnosing-superpowers 技能。要检查更早的会话，请指明会话：“figure out what went wrong with superpowers in session <id>”。
该技能会读取会话记录，以行级证据报告发生的情况，并在你需要时打包一份经过清理的 bundle 用于 bug 报告。
社区¶
Superpowers 由 Jesse Vincent 和 Prime Radiant 的其他人共同打造。
- Discord：加入我们，获取社区支持、提问并分享你用 Superpowers 构建的内容
- Issues：https://github.com/obra/superpowers/issues
- 发布公告：注册 以接收新版本通知
包含内容¶
技能库¶
测试 - test-driven-development - RED-GREEN-REFACTOR 循环（包含测试反模式参考）
调试 - systematic-debugging - 四阶段根因分析过程（包含 root-cause-tracing、defense-in-depth、condition-based-waiting 技术） - verification-before-completion - 确保问题确实已修复 - diagnosing-superpowers - 找出会话中哪里出了问题，并带有证据；导出一份清理后的 bundle 或提交 issue
协作 - brainstorming - 在构建前厘清意图 - writing-plans - 详细的实施计划 - executing-plans - 内联执行计划：单一上下文，一次最终审查 - dispatching-parallel-agents - 并发 subagent 工作流 - requesting-code-review - 审查前检查清单 - receiving-code-review - 回应反馈 - using-git-worktrees - 并行开发分支 - finishing-a-development-branch - merge/PR 决策工作流 - subagent-driven-development - 两阶段审查的快速迭代（先检查规格符合性，再检查代码质量）
元信息¶
- writing-skills - 遵循最佳实践创建新技能（包含测试方法论）
- using-superpowers - 技能系统简介
理念¶
- 测试驱动开发 - 始终先编写测试
- 系统化优于临时方案 - 以流程而非猜测为依据
- 降低复杂性 - 以简洁为首要目标
- 证据优于断言 - 在宣布成功之前先进行验证
阅读原始发布公告。
贡献¶
Superpowers 的一般贡献流程如下。请记住，我们通常不接受新技能的贡献，并且任何对技能的更新都必须在我们支持的所有编码代理中正常工作。
- 复刻（Fork）仓库
- 切换到
dev分支 - 为你的工作创建一个分支
- 遵循
writing-skills技能来创建和测试新的及修改过的技能 - 提交一个 PR，务必填写 pull request 模板。
技能行为测试使用来自 superpowers-evals 的 drill 评估框架，克隆到 evals/ 中 — 有关设置，请参阅 evals/README.md。插件基础设施测试位于 tests/，并通过相应的 run-*.sh 或 npm test 运行。
完整指南请参阅 skills/writing-skills/SKILL.md。
更新¶
Superpowers 的更新在一定程度上依赖于编码代理，但通常是自动进行的。
许可证¶
MIT 许可证 - 详见 LICENSE 文件
视觉伴侣遥测¶
因为技能和插件不会向创作者提供任何反馈，所以我们不知道有多少人在使用 Superpowers。默认情况下，brainstorming 的可选视觉伴侣功能中的 Prime Radiant 标志是从我们的网站加载的。它包含正在使用的 Superpowers 版本。它不包含有关你的项目、提示词或编码代理的任何详细信息。我们看不到你的点击，也看不到你在构建什么。这有助于我们粗略了解有多少人在使用 Superpowers，以及他们使用的是哪个版本的 Superpowers。这 100% 是可选的。若要禁用此功能，请将环境变量 SUPERPOWERS_DISABLE_TELEMETRY 设置为任何“真”值。Superpowers 同样尊重 Claude Code 的 DISABLE_TELEMETRY 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 退出选项。
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 su/superpowers