Superpowers
扩展介绍
Superpowers 是一套完整的软件开发方法论，专为你的编码代理（coding agents）设计，构建于一组可组合的技能（skills）和初始指令之上，确保你的代理能够使用它们。
工作原理
它从你启动编码代理的那一刻开始。一旦它发现你在构建某些东西，它不会直接跳入编写代码。相反，它会退一步，询问你真正想要实现的目标。
当它从对话中提炼出规格说明后，会以足够短、便于阅读和消化的片段展示给你。
在你批准设计后，你的代理会制定一个实现计划，该计划清晰到足以让一个热情但品味不佳、缺乏判断力、没有项目背景且厌恶测试的初级工程师也能遵循。它强调真正的红/绿TDD、YAGNI（你不需要它）和DRY原则。
接下来，一旦你说“开始”，它会启动一个子代理驱动开发流程，让代理逐个处理每个工程任务，检查并审查其工作，然后继续推进。你的代理常常会自主工作数小时，而不会偏离你制定的计划。
系统还有更多细节，但这是核心部分。由于技能会自动触发，你无需做任何特殊操作。你的编码代理只是拥有了超能力。
安装
安装方式因工具链而异。如果您使用多个工具链，请为每个工具链分别安装 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 会运行插件的会话启动钩子，因此 Superpowers 从第一条消息起即处于激活状态。使用相同命令重新安装即可更新。
Codex App
Superpowers 可通过 官方 Codex 插件市场 获取。
- 在 Codex 应用中，点击侧边栏中的“插件”。
- 您应该在“编码”部分看到
Superpowers。 - 点击 Superpowers 旁边的
+，然后按照提示操作。
Codex CLI
Superpowers 可通过官方 Codex 插件市场获取。
- 打开插件搜索界面：
/plugins
- 搜索 Superpowers：
superpowers
- 选择
Install Plugin。
Cursor
- 在 Cursor Agent 聊天中，从市场安装：
/add-plugin superpowers
- 或者在插件市场中搜索“superpowers”。
Devin CLI
- 从此仓库安装插件：
devin plugins install obra/superpowers
- 使用以下命令更新到最新版本：
devin plugins update 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
Grok Build CLI
Superpowers 可通过官方 Grok 插件市场获取。
- 从 xAI 的官方市场安装插件：
grok plugin install superpowers@xai-official --trust
- 或者在 TUI 中打开市场，搜索 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
Pi
从本仓库将 Superpowers 安装为 Pi 包：
pi install git:github.com/obra/superpowers
对于本地开发，使用此检出作为临时包运行 Pi：
pi -e /path/to/superpowers
Pi 包加载 Superpowers 技能和一个小型扩展，该扩展在会话启动时以及压缩后注入 using-superpowers 引导程序。Pi 具有原生技能，因此不需要兼容性 Skill 工具。子代理和任务列表工具仍然是可选的 Pi 配套包。
Hermes Agent
从本仓库将 Superpowers 安装为 Hermes 插件：
hermes plugins install obra/superpowers --enable
安装后重启任何活动的 Hermes 会话。注意：Hermes 没有压缩后钩子，因此如果很长的会话在第一次轮次后压缩，会丢失引导程序——如果技能停止触发，请启动新会话。
基本工作流程
- 头脑风暴 - 在编写代码前激活。通过提问完善粗略想法，探索替代方案，分部分呈现设计以供验证。保存设计文档。
- 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 - 在任务完成时激活。验证测试，提供选项（合并/PR/保留/丢弃），清理工作树。
代理在任何任务之前检查相关技能。 这些是强制工作流，而非建议。
包含内容
技能库
测试
- test-driven-development - 红-绿-重构循环（包含测试反模式参考）
调试
- 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 - 合并/拉取请求决策流程
- subagent-driven-development - 通过两阶段审查（先规范合规性，再代码质量）实现快速迭代
元
- writing-skills - 按照最佳实践创建新技能（包括测试方法论）
- using-superpowers - 技能系统简介
理念
- 测试驱动开发 - 始终先编写测试
- 系统性优于临时性 - 流程优于猜测
- 降低复杂性 - 简单性作为首要目标
- 证据优于声明 - 在宣布成功前进行验证