obra/superpowers · 上手攻略
- 仓库：obra/superpowers
- 链接：https://github.com/obra/superpowers
- 分类：AI · Agent 框架 / 软件开发方法论
- 作者：Tom
- 更新：2026-08-04
这是什么
Superpowers 是一个面向 AI 编码 Agent 的完整开发方法论与技能框架。它不是简单的提示词集合，而是一套从"需求对话→设计确认→任务拆解→子 Agent 执行→代码审查→分支收尾"的完整开发流程。核心理念：让 Agent 在写代码之前先理解需求，写代码时遵循 TDD，完成后主动审查。
它以技能（Skills）为载体，兼容多种 Agent 平台：Claude Code、Antigravity、Codex App/CLI、Cursor、Factory Droid、Gemini CLI、GitHub Copilot CLI、Kimi Code、OpenCode、Pi 等。
解决什么问题
大多数 AI 编码 Agent 的通病：拿到任务就直接开写，不做设计、不写测试、不遵守流程，导致代码质量不可控、返工多、偏离需求。Superpowers 通过强制触发的技能链解决这个问题——Agent 不会跳过关键步骤，每个技能都有明确的触发时机。
核心流程： 1. brainstorming：写代码前，先 Socratic 追问确认真实需求 2. writing-plans：拆解成 2-5 分钟可完成的小任务 3. subagent-driven-development / executing-plans：子 Agent 执行，附两阶段审查（规格合规 → 代码质量） 4. test-driven-development：强制 RED-GREEN-REFACTOR 循环 5. finishing-a-development-branch：任务完成后呈现合并选项
快速安装
⚠️ 安装方式因使用的 Agent 而异，每个 Agent 独立安装。以下为各主流平台的安装命令。
Claude Code（官方插件市场）
# 注册市场
/plugin marketplace add obra/superpowers-marketplace
# 安装
/plugin install superpowers@superpowers-marketplace
Antigravity（agy）
agy plugin install https://github.com/obra/superpowers
Codex App
在左侧栏 Plugins 中搜索 "Superpowers"，点击 + 安装。
Codex CLI
/plugins
# 搜索 superpowers
# 选择 Install Plugin
Cursor
/add-plugin 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
/plugins
# Marketplace > Superpowers 安装
# 或直接安装
/plugins install https://github.com/obra/superpowers
OpenCode
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
Pi
pi install git:github.com/obra/superpowers
# 本地开发调试
pi -e /path/to/superpowers
⚠️ 安装后：大多数平台需要开新会话（/new 或重启）才能激活 Superpowers。Kimi Code、Pi 等支持原生效能工具，无缝衔接。
核心用法
强制技能链（自动触发）
Superpowers 的技能在满足条件时自动触发，无需手动调用。
| 技能 | 触发时机 | 作用 |
|---|---|---|
brainstorming |
写代码之前 | Socratic 追问，精化需求，展示分段设计 |
using-git-worktrees |
设计批准后 | 在新分支创建隔离工作区，验证干净测试基线 |
writing-plans |
有批准设计时 | 拆解 2-5 分钟任务，每任务含精确文件路径和验证步骤 |
subagent-driven-development |
有计划时 | 每任务派发独立子 Agent，两阶段审查 |
executing-plans |
有计划时 | 批量执行，定时人工检查点 |
test-driven-development |
实现过程中 | RED-GREEN-REFACTOR，写测试→看失败→写最小实现→看通过 |
requesting-code-review |
任务之间 | 按严重级别报告问题，Critical 阻塞推进 |
finishing-a-development-branch |
任务完成时 | 验证测试，呈现 Merge/PR/保留/丢弃选项 |
TDD 核心循环
1. 写一个失败的测试 → RED
2. 看它失败 → 确认失败原因正确
3. 写最小代码让它通过 → GREEN
4. 重构 → REFACTOR
5. 提交 → COMMIT
调试技能
# systematic-debugging：4 阶段根因分析
# verification-before-completion：确认修复真正生效
典型适用场景
- 需要 Agent 长时间自主工作：Superpowers 让 Agent 能在 2-3 小时内自主完成复杂任务而不偏离计划
- TDD 驱动的 AI 协作开发：要求 AI 先写测试再写代码
- 多 Agent 并行任务：dispatching-parallel-agents 驱动并行子 Agent 工作流
- 企业级 AI 辅助开发：商业支持可联系 sales@primeradiant.com
坑与注意
- 插件独立安装：Superpowers 在不同 Agent 之间不共享状态，每个 Agent 需单独安装
- 会话激活：安装后需开新会话才能触发 session-start hook
- 不接收新技能贡献：项目明确表示一般不接受新技能提交，现有技能更新也必须兼容所有支持的 Agent
- 遥测说明：默认会向 Prime Radiant 服务器发送少量版本使用统计（可选关闭：设置
SUPERPOWERS_DISABLE_TELEMETRY=1） - 技能行为测试：使用 superpowers-evals 的 drill eval 框架，测试目录在
evals/ - 更新方式：大多数 Agent 自动更新，Pi 可用
pi install手动更新
与同类对比
| 框架 | 类型 | 核心特点 | Agent 兼容性 |
|---|---|---|---|
| Superpowers | 方法论+技能集 | 强制流程、Skills 触发、TDD | 多 Agent（10+ 种） |
| Cursor Rules | 提示词规则 | 项目级 .cursorrules 配置 | 仅 Cursor |
| CLAUDE.md | 项目说明 | 单文件 Agent 上下文 | 仅 Claude Code |
| @modelcontextprotocol | 协议标准 | 工具互操作协议 | 广泛 |
Superpowers 是目前覆盖最多 Agent 平台的技能框架，以 MIT 协议开源，Prime Radiant 提供商业支持。
一句话推荐结论
Superpowers 把"让 AI 像专业工程师一样工作"变成工程现实——强制 TDD、Skills 触发、全流程可复现，适合认真想让 AI 编码 Agent 产出高质量代码的团队。