🦸♂️ Superpowers：让 AI 开发能力暴涨 10 倍的技能套装
📢 写在前面
你是否遇到过 AI 写代码质量参差不齐的问题？
是否感觉 AI 总是"想到什么写什么"，缺乏系统方法论？今天介绍的这个开源技能套装 —— Superpowers，让 AI 拥有了工程级开发能力！
📚 一、Superpowers 是什么？
Superpowers 是由 obra 开发的一套 AI 开发方法论技能集合，目前在 skills.sh 拥有 39.3 万次安装。
核心理念
把人类工程开发的最佳实践，封装成 AI 可执行的技能包
包含的 14 个技能
┌─────────────────────────────────────────────────────────────┐
│ SUPERPOWERS 技能全家福 │
├─────────────────────────────────────────────────────────────┤
│ 🧠 brainstorm │ 头脑风暴 & 需求分析 │
│ 📋 writing-plans │ 编写详细实现计划 │
│ 🔧 systematic- │ 系统化调试方法 │
│ debugging │ │
│ 🧪 test-driven- │ 测试驱动开发 │
│ development │ │
│ 🚀 subagent-driven│ 子智能体驱动开发 │
│ -development │ │
│ ✅ verification- │ 完成前验证 │
│ before- │ │
│ completion │ │
│ 🔀 executing-plans│ 执行实现计划 │
│ 🎯 requesting- │ 请求代码审查 │
│ code-review │ │
│ 📥 receiving- │ 接收代码审查反馈 │
│ code-review │ │
│ 🌳 using-git- │ Git Worktree 隔离开发 │
│ worktrees │ │
│ 📝 writing-skills │ 创建自定义技能 │
│ 🔚 finishing-a- │ 完成开发分支 │
│ development- │ │
│ branch │ │
│ ⚡ dispatching- │ 并行分发子任务 │
│ parallel- │ │
│ agents │ │
└─────────────────────────────────────────────────────────────┘
安装命令
# 一键安装全部技能
npx skills add obra/superpowers
# 或单独安装特定技能
npx skills add obra/superpowers@brainstorming
npx skills add obra/superpowers@writing-plans
🏆 二、热门程度（排行榜）
| 排名 | 技能名称 | 安装量 | 用途 |
|---|---|---|---|
| 1 | brainstorming | 6.4万 | 头脑风暴 |
| 2 | systematic-debugging | 3.5万 | 系统调试 |
| 3 | writing-plans | 3.4万 | 编写计划 |
| 4 | using-superpowers | 2.9万 | 技能使用 |
| 5 | test-driven-development | 2.9万 | TDD 开发 |
| 6 | executing-plans | 2.8万 | 执行计划 |
| 7 | requesting-code-review | 2.7万 | 请求审查 |
| 8 | subagent-driven-development | 2.3万 | 子智能体开发 |
| 9 | verification-before-completion | 2.2万 | 验证完成 |
| 10 | receiving-code-review | 2.2万 | 接收审查 |
| 11 | writing-skills | 2.1万 | 写技能 |
| 12 | using-git-worktrees | 2.0万 | Git 隔离 |
| 13 | dispatching-parallel-agents | 2.0万 | 并行任务 |
| 14 | finishing-a-development-branch | 1.9万 | 完成分支 |
🔄 三、工作原理：核心流程图
完整开发流程
┌──────────────────────────────────────────────────────────────────────┐
│ SUPERPOWERS 开发工作流 │
└──────────────────────────────────────────────────────────────────────┘
┌─────────────┐
│ 🧠 开始 │
└──────┬──────┘
│
▼
┌─────────────────────┐ ┌─────────────────────┐
│ brainstorming │────→ │ writing-plans │
│ 头脑风暴 & 设计 │ │ 编写实现计划 │
└─────────────────────┘ └──────────┬──────────┘
│
▼
┌─────────────────────┐
│ subagent-driven- │
│ development │
│ 子智能体执行计划 │
└──────────┬──────────┘
│
┌────────────────────────────┼────────────────────────────┐
│ │ │
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ 🚀 实现任务 │ │ 🚀 实现任务 │ │ 🚀 实现任务 │
│ (Task 1) │ │ (Task 2) │ │ (Task 3) │
└───────┬───────┘ └───────┬───────┘ └───────┬───────┘
│ │ │
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ ⚠️ 规范审查 │ │ ⚠️ 规范审查 │ │ ⚠️ 规范审查 │
│ (Spec Review) │ │ (Spec Review) │ │ (Spec Review) │
└───────┬───────┘ └───────┬───────┘ └───────┬───────┘
│ │ │
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ 💎 代码质量 │ │ 💎 代码质量 │ │ 💎 代码质量 │
│ (Code Review) │ │ (Code Review) │ │ (Code Review) │
└───────┬───────┘ └───────┬───────┘ └───────┬───────┘
│ │ │
└───────────────────────────┴───────────────────────────┘
│
▼
┌─────────────────────┐
│ finishing-a- │
│ development-branch │
│ 合并 & 完成 │
└──────────┬──────────┘
│
▼
┌─────────────┐
│ ✅ 完成 │
└─────────────┘
🧠 四、核心技能详解
1. brainstorming —— 需求分析 & 设计
作用：在写代码之前，先把"要做什么"想清楚
┌─────────────────────────────────────────────────────────┐
│ brainstorming 工作流程 │
├─────────────────────────────────────────────────────────┤
│ 1️⃣ 探索项目上下文 │
│ ↓ │
│ 2️⃣ 提出视觉化方案？（如果是 UI 相关） │
│ ↓ │
│ 3️⃣ 逐一提问澄清需求 │
│ ↓ │
│ 4️⃣ 提出 2-3 个方案并分析利弊 │
│ ↓ │
│ 5️⃣ 分段展示设计，获得用户确认 │
│ ↓ │
│ 6️⃣ 编写设计文档保存到 docs/superpowers/specs/ │
│ ↓ │
│ 7️⃣ 规格审查循环（最多 3 轮） │
│ ↓ │
│ 8️⃣ 用户最终确认 │
│ ↓ │
│ 9️⃣ 调用 writing-plans 开始写计划 │
└─────────────────────────────────────────────────────────┘
核心原则：
⚠️ 绝对不能跳过设计阶段！
即使是"简单的需求"，也必须经过设计流程确认
典型对话示例：
AI: "这个功能涉及用户认证。我有几个问题想确认：
1. 使用邮箱密码还是第三方登录？
A. 仅邮箱密码 B. 仅第三方(OAuth) C. 两者都要"
用户: "选 C，两者都要"
AI: "好的。接下来：
2. 第三方登录支持哪些平台？
A. 仅 Google B. Google + GitHub C. 全部(Google/GitHub/微信)"
用户: "选 B"
...
2. writing-plans —— 编写实现计划
作用：把设计方案拆成最小可执行的步骤
┌─────────────────────────────────────────────────────────┐
│ writing-plans 输出示例 │
├─────────────────────────────────────────────────────────┤
│ # 用户认证功能实现计划 │
│ │
│ ## 任务分解 │
│ │
│ ### Task 1: 创建用户模型 │
│ - [ ] Step 1: 写失败的测试 │
│ - [ ] Step 2: 运行确认测试失败 │
│ - [ ] Step 3: 写最小实现代码 │
│ - [ ] Step 4: 运行确认测试通过 │
│ - [ ] Step 5: 提交代码 │
│ │
│ ### Task 2: 实现注册接口 │
│ ... │
└─────────────────────────────────────────────────────────┘
关键特性：
| 特性 | 说明 |
|---|---|
| 📝 精确文件路径 | 告诉你在哪个文件第几行修改 |
| 🧪 TDD 驱动 | 先写测试再写代码 |
| 🔧 最小代码 | 只写让测试通过的最小代码 |
| 📦 自包含 | 每个任务独立可测试 |
3. systematic-debugging —— 系统化调试
作用：用科学方法找 bug，而不是瞎猜
┌─────────────────────────────────────────────────────────┐
│ 四阶段调试法 │
├─────────────────────────────────────────────────────────┤
│ │
│ 🔍 Phase 1: 根因调查 │
│ ├─ 仔细阅读错误信息 │
│ ├─ 稳定复现问题 │
│ ├─ 检查最近变更 │
│ └─ 收集证据 │
│ ↓ │
│ 📊 Phase 2: 模式分析 │
│ ├─ 找类似工作的代码 │
│ ├─ 对比参考资料 │
│ └─ 找出差异点 │
│ ↓ │
│ 🧪 Phase 3: 假设 & 测试 │
│ ├─ 形成单一假设 │
│ ├─ 最小化测试 │
│ └─ 验证后继续 │
│ ↓ │
│ 🔧 Phase 4: 实现修复 │
│ ├─ 创建失败的测试用例 │
│ ├─ 修复根因 │
│ └─ 验证修复有效 │
│ │
└─────────────────────────────────────────────────────────┘
铁律：
🚫 在找到根因之前，绝对不能尝试修复！
4. subagent-driven-development —— 子智能体驱动开发
作用：并行执行多个任务，效率翻倍
┌─────────────────────────────────────────────────────────┐
│ subagent-driven 开发模式 │
├─────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────┐ │
│ │ 主控制器 (Main Controller) │ │
│ │ - 读取计划文件 │ │
│ │ - 创建 Todo 清单 │ │
│ │ - 调度子智能体 │ │
│ │ - 协调审查流程 │ │
│ └──────────────────┬──────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────┐ │
│ │ 子智能体 1 (Task 1) │ │
│ │ 实现 → 自审 → 规范审查 → 质量审查 │ │
│ └─────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────┐ │
│ │ 子智能体 2 (Task 2) │ │
│ │ 实现 → 自审 → 规范审查 → 质量审查 │ │
│ └─────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────┐ │
│ │ 子智能体 3 (Task 3) │ │
│ │ 实现 → 自审 → 规范审查 → 质量审查 │ │
│ └─────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
审查流程：
实现完成
↓
┌─────────────┐ ❌ 发现问题 ┌─────────────┐
│ 规范审查 │ ──────────────────→ │ 修复问题 │
│ (Spec) │ ↑ │ │
└─────┬──────┘ │ └─────────────┘
│ ✅ 通过
▼
┌─────────────┐ ❌ 质量问题 ┌─────────────┐
│ 质量审查 │ ──────────────────→ │ 修复问题 │
│ (Quality) │ ↑ │ │
└─────┬──────┘ │ └─────────────┘
│ ✅ 通过
▼
任务完成
🎯 五、使用场景示例
场景 1：开发一个新功能
用户: "我想给我的博客加一个点赞功能"
AI (加载 brainstorming):
━━━━━━━━━━━━━━━━━━━━━━━━━━
"好的，让我们先设计一下这个功能。
1. 点赞是游客还是登录用户才能点？
A. 游客也可以 B. 仅登录用户
请选择一个。"
━━━━━━━━━━━━━━━━━━━━━━━━━━
对比没有 Superpowers：
| 步骤 | 无 Superpowers | 有 Superpowers |
|---|---|---|
| 需求确认 | ❌ 直接开写 | ✅ 系统提问确认 |
| 方案设计 | ❌ 想哪写哪 | ✅ 2-3 方案对比 |
| 计划制定 | ❌ 边写边想 | ✅ 详细步骤清单 |
| 代码质量 | ❌ 参差不齐 | ✅ 双审机制保障 |
场景 2：调试一个 Bug
用户: "我的登录功能报错了"
AI (加载 systematic-debugging):
━━━━━━━━━━━━━━━━━━━━━━━━━━
"我需要先了解问题的根因。
Phase 1 - 根因调查：
1. 请提供完整的错误信息
2. 登录失败是 100% 还是偶尔？
3. 最近有改过什么代码吗？
请告诉我这些信息，我再开始调查。"
━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 六、效果对比
| 指标 | 无 Superpowers | 有 Superpowers | 提升 |
|---|---|---|---|
| 首次修复率 | ~40% | ~95% | 2.4x |
| 平均修复时间 | 2-3 小时 | 15-30 分钟 | 4-6x |
| 新 Bug 引入率 | 常见 | 接近零 | 大幅下降 |
| 代码规范性 | 参差不齐 | 统一标准 | 稳定 |
| 需求理解偏差 | 常见 | 极少 | 极大改善 |
🚀 七、快速上手指南
第一步：安装
# 安装全部 14 个技能
npx skills add obra/superpowers -g -y
第二步：自动加载
当你使用 OpenCode、Claude Code 等工具时，AI 会自动识别需要加载的技能：
检测到：开发新功能
✅ 加载：brainstorming
✅ 加载：writing-plans
第三步：按流程开发
头脑风暴 → 写计划 → 执行 → 审查 → 完成
推荐的技能组合
| 场景 | 技能组合 |
|---|---|
| 新功能开发 | brainstorming + writing-plans + subagent-driven |
| Bug 调试 | systematic-debugging + verification-before-completion |
| 代码重构 | brainstorming + writing-plans + requesting-code-review |
| 持续交付 | finishing-a-development-branch + using-git-worktrees |
🔧 八、自定义 Superpowers
创建自己的工作流技能
# 初始化新技能
npx skills init my-workflow
# 编辑技能内容
# vim my-workflow/SKILL.md
# 分享给团队
git add .
git commit -m "Add my custom workflow skill"
git push
技能文件结构
my-workflow/
├── SKILL.md # 主文件（必需）
│ ├── name: # 技能名称
│ ├── description: # 使用场景描述
│ └── 完整的工作流程文档
│
├── references/ # 参考文档（可选）
│ └── advanced-usage.md
│
└── scripts/ # 示例脚本（可选）
└── example.sh
📝 九、常见问题
Q1：Superpowers 和普通 AI 有什么区别？
A：普通 AI 像"想到什么写什么"的实习生；Superpowers 让 AI 拥有了资深工程师的思维方式和流程规范。
Q2：所有技能都需要用吗？
A：不需要。AI 会根据任务自动选择合适的技能。但
using-superpowers会确保你在做任何事之前都先检查是否有相关技能。
Q3：支持哪些 AI 工具？
A：OpenCode、Claude Code、Cursor、VS Code 等主流 AI 编程工具都支持。
Q4：学习曲线陡峭吗？
A：完全不会。你只需要提出需求，AI 会自动按照流程工作。你只需要在关键节点确认即可。
🎉 十、总结
| 内容 | 重点 |
|---|---|
| 是什么 | AI 开发方法论技能套装 |
| 有多少 | 14 个技能，39 万次安装 |
| 核心理念 | 把人类最佳实践灌输给 AI |
| 最大价值 | 从"瞎写"到"规范开发" |
| 在哪里 | skills.sh/obra/superp… |
💬 最后
Superpowers 的本质是：让 AI 不再是一个只会写代码的工具，而是成为一个有方法论、有流程、有审查的虚拟开发伙伴。
安装只需一行命令，但带来的开发体验提升是质的飞跃。
如果你经常和 AI 编程打交道，一定试试 Superpowers！
推荐指数：⭐⭐⭐⭐⭐
📎 相关资源
- 🌐 官网：skills.sh/obra/superp…
- 🐙 GitHub：github.com/obra/superp…
- 📦 安装：
npx skills add obra/superpowers
