阅读来源：Claude Code Superpowers 工程级开发

一、核心定位：从 “聪明实习生” 到 “有纪律的开发团队”

Superpowers 是由 Jesse Vincent 开发的开源代理技能框架，专门解决 AI 编程中的核心问题：如何让 AI 写出工程级的代码，而不是 “玩具级” 的代码。

为什么需要 Superpowers？

普通 Claude Code 就像一个 “聪明的实习生”，能写出能跑的代码，但缺少工程化的流程和纪律，存在这些问题：

1. Vibe Coding 的混乱：AI 直接开始写代码，没有规划，导致频繁返工

2. 缺少 TDD 纪律：习惯先写代码再补测试，甚至干脆不写测试

3. 需求模糊直接动手：用户说 “做一个登录功能”，AI 就开始写，结果做出来不是想要的

4. 代码质量不稳定：没有代码审查机制，质量依赖 AI 的 “心情”

Superpowers 解决了这些问题，给 Claude 配备了 “资深工程师导师”，强制它遵循完整的软件开发流程，让 Claude 变成一个 “有纪律的开发团队”。

二、快速开始

1. 安装 Superpowers

有三种安装方式：

方法一：通过 Marketplace（推荐）

在 Claude Code 中运行：

# 添加 marketplace
/plugin marketplace add obra/superpowers-marketplace
# 安装 superpowers
/plugin install superpowers@superpowers-marketplace

方法二：手动克隆

git clone https://github.com/obra/superpowers.git ~/.claude/skills/superpowers

方法三：项目级别安装

如果想在特定项目中使用，让团队共享配置：

# 在项目根目录
mkdir -p .claude/skills
# 复制 superpowers 到项目目录
cp -r ~/.claude/skills/superpowers .claude/skills/

2. 体验第一个 Skill

以 brainstorming 技能为例：

• 没有 Superpowers 之前：你说 “做一个用户登录功能”，Claude 直接开始写代码，可能做出来不是你想要的

• 有 Superpowers 之后：Claude 会通过苏格拉底式提问帮你澄清需求：

  • 这个登录功能是为 Web 应用还是移动应用设计的？

  • 需要支持哪些登录方式？邮箱密码？第三方登录？

  • 是否需要 “记住我” 功能？

  • 密码重置流程是邮件还是短信？

  • …

这些问题迫使你在编码前想清楚真正需要什么，避免写出一堆用不上的代码。

3. 技能触发机制

Superpowers 不是 “魔法开关”，而是一组技能集合，有三种触发方式：

1. 关键词触发：提到特定关键词时自动激活对应技能

2. 场景自动触发：比如需求模糊时自动触发 brainstorming

3. 手动调用：直接指定要使用的技能

三、核心技能详解

Superpowers 包含 20+ 个可组合技能，覆盖整个软件开发生命周期，按类别划分：

🧪 测试类技能

test-driven-development（测试驱动开发）

触发关键词：“TDD”、“测试驱动开发”、“先写测试”
作用：强制 Claude 遵循 TDD 红绿重构循环，而不是 “想起来再写测试”

传统开发方式	TDD 技能激活后
1. 直接写代码	1. 🔴 RED：先写一个失败的测试
2. 手动测试一下	2. 🟢 GREEN：写最少的代码让测试通过
3. 发现 bug，修改代码	3. 🔵 REFACTOR：重构代码，保持测试通过
4. 重复…（测试？下次再说）	4. 重复

使用示例：

用 TDD 方式实现一个用户认证模块

🐛 调试类技能

systematic-debugging（系统化调试）

触发关键词：“调试”、“bug”、“不工作”
作用：强制使用四阶段根因分析，避免随机尝试修复：

1. 复现问题：确认 bug 可以稳定复现，记录复现步骤

2. 隔离根因：通过二分法缩小范围，添加日志定位问题代码

3. 验证假设：提出根因假设，设计验证实验

4. 修复并验证：实施修复，确认 bug 解决，添加回归测试

verification-before-completion（完成前验证）

作用：防止 Claude “感觉差不多” 就停止工作，要求它在任务完成前：

1. 运行所有测试

2. 手动测试关键功能

3. 检查代码质量（lint）

4. 确认文档已更新

🤝 协作类技能

brainstorming（头脑风暴）

触发：需求模糊时自动触发
作用：使用苏格拉底式提问法帮你澄清需求，避免开发出用不上的功能。

writing-plans（编写计划）

触发关键词：“制定计划”、“规划”
作用：将大任务分解为 2-5 分钟可完成的小任务，让复杂项目变得可控。

示例输出：

# 实现计划
## 任务 1：设计数据库 schema（预计 5 分钟）
- 创建 todos 表
- 定义字段：id, title, completed, createdAt

## 任务 2：创建 Express 路由（预计 10 分钟）
- POST /todos - 创建任务
- GET /todos - 获取列表
- ...

executing-plans（执行计划）

作用：批量执行计划，并在每个检查点暂停确认，让你可以在每个阶段检查方向是否正确，避免跑远了才发现错了。

dispatching-parallel-agents（并行代理调度）

作用：同时启动多个子代理并行工作，每个代理在自己的隔离环境中，互不干扰。
使用场景：同时处理多个独立任务，比如：

• 代理 A：编写后端 API

• 代理 B：编写前端组件

• 代理 C：编写测试

subagent-driven-development（子代理驱动开发）

作用：为每个小任务启动一个独立的子代理，优势：

• 每个子代理有独立的上下文

• 任务失败不会影响其他任务

• 可以并行执行多个任务

using-git-worktrees（使用 Git Worktrees）

作用：使用 Git 的 worktree 功能创建隔离的开发环境，多个功能可以并行开发，不会互相冲突。

👀 代码审查类技能

requesting-code-review（请求代码审查）

作用：完成代码后，自动触发代码审查流程。

receiving-code-review（接收代码审查）

作用：定义如何接收和处理审查反馈，完整的审查流程：

1. 提交代码

2. 自动触发审查

3. 审查者检查代码质量、安全性、测试覆盖率

4. 提出改进建议

5. 修复问题

6. 重新审查直到批准

四、完整工作流程

Superpowers 的真正威力在于将多个技能组合成完整的开发流程：

1. Brainstorming（头脑风暴）
   ↓ 通过问答澄清真实需求
2. Design Document（设计文档）
   ↓ 分块展示设计，等待确认
3. Writing Plans（编写计划）
   ↓ 分解为 2-5 分钟的小任务
4. Subagent Development（子代理开发）
   ↓ 每个任务启动独立子代理
5. TDD（测试驱动开发）
   ↓ 强制 RED-GREEN-REFACTOR
6. Code Review（代码审查）
   ↓ 质量把关
7. 完成

实战案例：构建用户认证系统

1. Brainstorming 澄清需求：先问清楚你要的认证系统是什么样的

2. 生成设计文档：输出完整的设计方案，让你确认

3. 编写实现计划：把开发拆成一个个小任务

4. 执行开发：用 TDD 方式逐个实现，每个任务后暂停确认

5. 代码审查：最后做代码审查，确保质量

五、常用技能速查表

技能名称	功能	使用场景
brainstorming	苏格拉底式提问澄清需求	需求不明确时
writing-plans	分解任务为小步骤	大项目开始前
executing-plans	执行计划并检查点	按计划开发时
test-driven-development	TDD 红绿重构循环	所有功能开发
systematic-debugging	四阶段根因分析	出现 bug 时
verification-before-completion	完成前验证	任务结束时
requesting-code-review	请求代码审查	提交代码前
subagent-driven-development	子代理驱动开发	并行任务
using-git-worktrees	Git worktree 隔离	并行开发功能

六、最佳实践

1. 明确触发关键词

技能	触发关键词
test-driven-development	“TDD”、“测试驱动”、“先写测试”
brainstorming	需求模糊时自动触发
systematic-debugging	“调试”、“bug”、“不工作”
writing-plans	“制定计划”、“规划”

2. 需要流程纪律时用 Superpowers

• 生产级代码开发 → 提到 “TDD”

• 需求不明确时 → 让 brainstorming 帮你澄清

• 复杂项目 → 用 writing-plans 分解任务

3. 简单任务不必强求

如果是快速原型或一次性脚本，不需要强制走完整流程。Superpowers 适合需要长期维护的代码。

4. 技能可以组合使用

用 TDD 方式实现用户认证，完成后帮我做代码审查

这会同时触发 test-driven-development 和 code-review 技能，形成完整的工程化流程。

七、常见问题

Q1：用 Superpowers 必须指定 “TDD” 吗？

不是必须的。Superpowers 是技能集合，每个技能有自己的触发条件：

• 说 “用 TDD 方式” → 触发 test-driven-development

• 不说 TDD → Claude 可能写测试，也可能不写（取决于模型本身）
  Superpowers 的作用是强化流程纪律，而不是凭空创造能力。

Q2：Superpowers 会让开发变慢吗？

初期可能会感觉慢，因为：

• 需要时间澄清需求

• 要先写测试再写代码

• 要经过代码审查
  但长期来看，由于减少了返工和 bug，整体效率更高。

Q3：小项目也需要 Superpowers 吗？

对于原型验证或非常简单的任务，可以直接使用 Claude Code。Superpowers 更适合：

• 生产级项目

• 多人协作项目

• 需要长期维护的项目

Q4：Superpowers 和 Skills 有什么区别？

维度	Superpowers	Skills
本质	完整的开发方法论框架	可复用的技能包
范围	覆盖整个开发流程	聚焦特定功能
关系	Superpowers 内部使用 Skills	Superpowers 是 Skills 的集合

Q5：可以自定义 Superpowers 技能吗？

可以！Superpowers 是开源的，你可以：

1. Fork 仓库

2. 修改现有技能

3. 添加新的技能

4. 贡献回社区

八、总结

Superpowers 是一组工程级开发技能集合，它不让 AI 更聪明，而是让 AI 更有纪律，把 Claude Code 从 “聪明的实习生” 变成 “有纪律的开发团队”。

核心要点

1. Superpowers 是技能集合，不是魔法

   • 安装后，技能在后台可用

   • 通过关键词或场景触发

   • 可以手动调用特定技能

2. 记住关键触发词

   • 想要 TDD → 说 “用 TDD 方式”

   • 需求模糊 → brainstorming 会主动提问

   • 出现 bug → 提到 “调试” 触发 systematic-debugging

3. 适用场景

   • ✅ 生产级代码开发

   • ✅ 需要长期维护的项目

   • ✅ 团队协作项目

   • ❌ 快速原型（可选）

   • ❌ 一次性脚本（可选）