反物质维度
69.50M · 2026-03-22
Superpowers 是由 obra 开发的一套 AI 开发方法论技能集合，目前在 skills.sh 拥有 39.3 万次安装。
┌─────────────────────────────────────────────────────────────┐
│ 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 │
│ 合并 & 完成 │
└──────────┬──────────┘
│
▼
┌─────────────┐
│ 完成 │
└─────────────┘
作用：在写代码之前，先把"要做什么"想清楚
┌─────────────────────────────────────────────────────────┐
│ 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"
...
作用：把设计方案拆成最小可执行的步骤
┌─────────────────────────────────────────────────────────┐
│ writing-plans 输出示例 │
├─────────────────────────────────────────────────────────┤
│ # 用户认证功能实现计划 │
│ │
│ ## 任务分解 │
│ │
│ ### Task 1: 创建用户模型 │
│ - [ ] Step 1: 写失败的测试 │
│ - [ ] Step 2: 运行确认测试失败 │
│ - [ ] Step 3: 写最小实现代码 │
│ - [ ] Step 4: 运行确认测试通过 │
│ - [ ] Step 5: 提交代码 │
│ │
│ ### Task 2: 实现注册接口 │
│ ... │
└─────────────────────────────────────────────────────────┘
关键特性：
| 特性 | 说明 |
|---|---|
| 精确文件路径 | 告诉你在哪个文件第几行修改 |
| TDD 驱动 | 先写测试再写代码 |
| 最小代码 | 只写让测试通过的最小代码 |
| 自包含 | 每个任务独立可测试 |
作用：用科学方法找 bug，而不是瞎猜
┌─────────────────────────────────────────────────────────┐
│ 四阶段调试法 │
├─────────────────────────────────────────────────────────┤
│ │
│ Phase 1: 根因调查 │
│ ├─ 仔细阅读错误信息 │
│ ├─ 稳定复现问题 │
│ ├─ 检查最近变更 │
│ └─ 收集证据 │
│ ↓ │
│ Phase 2: 模式分析 │
│ ├─ 找类似工作的代码 │
│ ├─ 对比参考资料 │
│ └─ 找出差异点 │
│ ↓ │
│ Phase 3: 假设 & 测试 │
│ ├─ 形成单一假设 │
│ ├─ 最小化测试 │
│ └─ 验证后继续 │
│ ↓ │
│ Phase 4: 实现修复 │
│ ├─ 创建失败的测试用例 │
│ ├─ 修复根因 │
│ └─ 验证修复有效 │
│ │
└─────────────────────────────────────────────────────────┘
铁律：
作用：并行执行多个任务，效率翻倍
┌─────────────────────────────────────────────────────────┐
│ subagent-driven 开发模式 │
├─────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────┐ │
│ │ 主控制器 (Main Controller) │ │
│ │ - 读取计划文件 │ │
│ │ - 创建 Todo 清单 │ │
│ │ - 调度子智能体 │ │
│ │ - 协调审查流程 │ │
│ └──────────────────┬──────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────┐ │
│ │ 子智能体 1 (Task 1) │ │
│ │ 实现 → 自审 → 规范审查 → 质量审查 │ │
│ └─────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────┐ │
│ │ 子智能体 2 (Task 2) │ │
│ │ 实现 → 自审 → 规范审查 → 质量审查 │ │
│ └─────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────┐ │
│ │ 子智能体 3 (Task 3) │ │
│ │ 实现 → 自审 → 规范审查 → 质量审查 │ │
│ └─────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
审查流程：
实现完成
↓
┌─────────────┐ 发现问题 ┌─────────────┐
│ 规范审查 │ ──────────────────→ │ 修复问题 │
│ (Spec) │ ↑ │ │
└─────┬──────┘ │ └─────────────┘
│ 通过
▼
┌─────────────┐ 质量问题 ┌─────────────┐
│ 质量审查 │ ──────────────────→ │ 修复问题 │
│ (Quality) │ ↑ │ │
└─────┬──────┘ │ └─────────────┘
│ 通过
▼
任务完成
用户: "我想给我的博客加一个点赞功能"
AI (加载 brainstorming):
━━━━━━━━━━━━━━━━━━━━━━━━━━
"好的，让我们先设计一下这个功能。
1. 点赞是游客还是登录用户才能点？
A. 游客也可以 B. 仅登录用户
请选择一个。"
━━━━━━━━━━━━━━━━━━━━━━━━━━
对比没有 Superpowers：
| 步骤 | 无 Superpowers | 有 Superpowers |
|---|---|---|
| 需求确认 | 直接开写 | 系统提问确认 |
| 方案设计 | 想哪写哪 | 2-3 方案对比 |
| 计划制定 | 边写边想 | 详细步骤清单 |
| 代码质量 | 参差不齐 | 双审机制保障 |
用户: "我的登录功能报错了"
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 |
# 初始化新技能
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 有什么区别？
Q2：所有技能都需要用吗？
Q3：支持哪些 AI 工具？
Q4：学习曲线陡峭吗？
| 内容 | 重点 |
|---|---|
| 是什么 | AI 开发方法论技能套装 |
| 有多少 | 14 个技能，39 万次安装 |
| 核心理念 | 把人类最佳实践灌输给 AI |
| 最大价值 | 从"瞎写"到"规范开发" |
| 在哪里 | skills.sh/obra/superp… |
npx skills add obra/superpowers
