在 AI 编码代理（Coding Agent）遍地开花的 2026 年，一个尴尬的现实正在浮现：大部分开发者把最强的 AI 模型接入编辑器后，产出的代码质量依然参差不齐。不是因为模型不够聪明，而是因为缺少一套系统化的软件开发方法论来约束和引导 AI 的行为。由 Jesse Vincent（obra）创立的 Superpowers 正是为解决这个问题而生——它不是一个普通的技能包，而是一套可工作的 Agentic 技能框架与完整的软件开发方法论，将 TDD、代码审查、子代理驱动开发等工程最佳实践固化为 AI 代理必须遵循的强制性工作流。项目自 2025 年 10 月开源以来迅速引爆社区，目前星标数已突破 23 万，支持 11 个主流编码代理平台。

📌 项目概览 & 统计数据

✨ 核心功能

Superpowers 的核心是 6 个关键技能，它们串联起一条从设计到交付的完整工作流。每一个技能都不是”建议”——只要场景匹配，Agent 必须执行，不能跳过。

1. 🧠 brainstorming（头脑风暴） — 在任何创造性工作之前使用。强制 Agent 先理解需求、提出 2-3 种方案、获得用户确认后才动手写代码。这从根本上防止了”上来就写，写完发现方向错了”的悲剧。许多 AI 编码的翻车案例，根因都是需求理解偏差，而 brainstorming 用苏格拉底式问答在动手前就把方向锁死。

2. 📝 writing-plans（编写计划） — 拿到需求/规格后、写代码之前使用。将大任务拆解为小步骤，明确每步要改哪些文件、怎么测试、怎么验证。强调 DRY（不重复）/YAGNI（不超前设计）/TDD（测试先行）/频繁提交四大原则。计划写得越细，执行时的上下文就越可控，幻觉和跑偏的概率就越低。

3. 🧪 test-driven-development（测试驱动开发） — 实现任何功能或修复 bug 时使用。严格执行 RED-GREEN-REFACTOR 循环：先写测试 → 看它失败 → 写最少代码让它通过。如果你没看到测试失败，你就不知道测试是否写对了。技能内置了常见测试反模式参考，防止 Agent 写出”永远通过”的无效测试。

4. 🐛 systematic-debugging（系统化调试） — 遇到 bug、测试失败或异常行为时使用。核心原则：先找根因，再修代码。禁止随机修改、禁止快速打补丁——每一个修复都必须基于调查。提供 4 阶段根因分析方法论，包含根因追踪、纵深防御和基于条件的等待技术，配合 verification-before-completion 确保修复真正生效而非表面掩盖。

5. 🔍 requesting-code-review（请求代码审查） — 完成任务或合并前使用。派遣一个拥有全新上下文的独立代码审查子代理，基于 git diff 审查工作产物。新鲜视角 + 独立判断 = 发现问题级联，这是单一 Agent 自审永远做不到的。

6. 📖 using-superpowers（使用指南） — 元技能，在每次对话开始时加载，确保 Agent 自动调用其他技能。核心规则：只要某个技能可能适用，就必须使用它，不能跳过。 这是整个框架的”守门人”，保证方法论不被绕过。

整体工作流：

1
2
3
4
5
6
7

🧠 brainstorming（设计）
       ↓
📝 writing-plans（规划）
       ↓
🧪 TDD  +  🐛 systematic-debugging（实现）
       ↓
🔍 requesting-code-review（审查）

此外，Superpowers 还提供多个辅助技能形成完整生态：

• 🤖 subagent-driven-development — 将每个计划任务派发给全新上下文的子代理，两阶段审查通过后才算完成，从根本上解决长对话上下文膨胀和幻觉累积问题
• 🔀 using-git-worktrees — 并行开发时的分支隔离，避免 feature 互相污染
• 🏁 finishing-a-development-branch — 合并/PR 决策工作流，确保收尾质量
• ✅ verification-before-completion — 完成前的最终验证，防止”看起来修了其实没修”
• 🔧 writing-skills — 元技能，指导用户按最佳实践创建自定义技能，让生态持续扩展

🗂️ 技能库分类

🛠️ 技术架构

架构示意：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

┌──────────────────────────────────────┐
│         11 个编码代理平台             │
│  Claude Code · Cursor · Codex · ...  │
├──────────────────────────────────────┤
│       插件适配层 (JS/TS)             │
│   统一接口 · 平台特性映射             │
├──────────────────────────────────────┤
│        技能引擎 (Shell)              │
│   触发匹配 · 上下文注入 · 流程编排   │
├──────────┬──────────┬───────────────┤
│  🧪 测试  │  🐛 调试  │  🤝 协作      │
│  TDD循环  │  根因分析 │  7步工作流    │
├──────────┴──────────┴───────────────┤
│     生命周期钩子 · 测试框架 · 构建工具 │
└──────────────────────────────────────┘

整个架构的核心设计理念是”技能即约束”——Agent 在任何操作前先检查是否有匹配的技能，有则必须按技能规定的流程执行，没有例外。using-superpowers 元技能作为守门人在对话启动时加载，确保这条规则不被绕过。这是一种巧妙的”以文件治 AI”的思路：用人类可读的 Markdown 文件定义 AI 的行为规范。

🚀 部署/安装方式

Superpowers 的安装方式因编码代理而异，覆盖 11 个平台：

Claude Code

1

/plugin install superpowers@claude-plugins-official

Antigravity

1

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

Codex App — 应用内插件市场点击 + 安装

Codex CLI

1

/plugins  # 搜索 superpowers

Cursor

1

/add-plugin superpowers

Factory Droid

1
2

droid plugin marketplace add
droid plugin install

Gemini CLI

1

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

GitHub Copilot CLI

1
2

copilot plugin marketplace add
copilot plugin install

Kimi Code — /plugins → Marketplace → Superpowers

OpenCode — 遵循 .opencode/INSTALL.md 中的指引

Pi

1

pi install git:github.com/obra/superpowers

💻 本地开发

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# 1. Fork 并克隆仓库
git clone https://github.com/YOUR_USERNAME/superpowers.git
cd superpowers

# 2. 切换到 dev 分支
git checkout dev

# 3. 创建功能分支
git checkout -b your-feature

# 4. 使用 writing-skills 技能创建或修改技能
# （遵循项目内置的 writing-skills 技能指引）

# 5. 运行技能行为测试
# 使用 superpowers-evals 的 drill eval 工具
# 仓库地址：https://github.com/prime-radiant-inc/superpowers-evals/

# 6. 提交 PR（务必填写 PR 模板，目标分支指向 dev）

⚠️ 项目通常不接受新技能的贡献。提交 PR 时需披露编写环境和目标分支（必须指向 dev）。

💡 项目亮点总结

• 方法论而非工具集 — Superpowers 的独特之处在于它提供的是一套软件开发哲学，而非简单的代码片段集合。6 大核心技能从 brainstorming 到 code-review 形成闭环，using-superpowers 守门人确保流程不被绕过，这是它与市面上所有”提示词合集”类项目的本质区别。

• 惊人的社区验证 — 开源仅 8 个月即斩获 23 万 Star 和 2 万 Fork，这个增长速度在开发者工具领域极为罕见，充分说明了社区对”AI 编码规范化”的迫切需求。

• 子代理架构的前瞻性 — 将每个任务派发给全新上下文的子代理，从根本上解决了长对话中的上下文窗口膨胀和幻觉累积问题，这是 AI 工程化的关键突破。

• TDD 作为不可绕过的底线 — “如果你没看到测试失败，你就不知道测试是否写对了”——这句话被写入技能规则，Agent 没有选择跳过的自由，只能遵守。

• 跨平台统一体验 — 支持 11 个编码代理平台，无论团队使用哪个工具，开发流程和代码质量标准保持一致。

🔗 参考资料

• Superpowers GitHub 仓库
• Prime Radiant 官网
• Superpowers 版本发布公告订阅
• 加入 Discord 社区
• Superpowers Evals 测试工具
• Jesse Vincent GitHub 主页