你有没有这种感觉：Claude Code 很强大，但有时候像一匹脱缰的野马——你让它写个功能，它"刷刷刷"写了一堆，跑起来发现这个没考虑、那个有 bug，还得你回来收拾烂摊子。

今天要介绍的 Superpowers，就是给这匹野马套上缰绳的"训练师"。装了它，Claude Code 会从"随心所欲写代码"变成"按部就班做工程"。

一、先搞懂：Superpowers 到底是什么？

打个比方你就懂了

想象你请了一个很聪明的实习生：

没装 Superpowers 之前：

  • 你：“帮我做个用户登录功能”
  • 实习生：立刻开始写代码，30 秒后说"搞定！"
  • 你检查了一下：密码明文存储、没做输入校验、没处理异常、没写测试……
  • 你：“这不对啊，得改”
  • 实习生：“哦，那我再加点……”
  • （循环 N 次，最后你干脆自己重写了）

装了 Superpowers 之后：

  • 你：“帮我做个用户登录功能”
  • 实习生：先问你 —— “登录方式是什么？JWT 还是 Session？密码要加密吗？需要记住我功能吗？有没有现有的用户表结构？”
  • 你回答完，实习生先写方案文档，给你看，确认了再动手
  • 动手时：先写测试 → 再写代码 → 跑测试 → 通过了才提交
  • 最后还帮你写了 README 和 Git commit message

这就是 Superpowers 的核心：把资深工程师的工作习惯，固化成 AI 必须遵守的流程。

二、为什么需要 Superpowers？

问题1：AI 太"着急"了

普通的 Claude Code 对话：

你：帮我做一个电商购物车功能
Claude：好的！（立刻开始写代码）
10秒后：搞定！我创建了 Cart.js，包含 addItem、removeItem、getTotal 三个方法。
你：等等，你没考虑库存校验、没做价格计算、没处理并发……
Claude：哦对，那我再改改……
（又是一通改，最后还是得你自己 review）

问题2：AI 不知道"什么时候算做完"

你让 AI 做个功能，它经常"提前交卷"——写了一半就觉得差不多了，但实际上：

  • 没写测试
  • 没处理边界情况
  • 没更新文档
  • 没跑 lint 检查

Superpowers 的解决方案

通过 14 个可组合的技能（Skills），把软件开发的标准流程（SOP）教给 AI：

传统 AI 编程 Superpowers 加持后
直接写代码 先讨论方案，再动手
写到哪算哪 按计划节点推进
不知道做完没 有明确的完成标准
代码质量靠运气 强制 TDD + 代码审查
一个任务串行跑 多任务可并行调度

三、安装 Superpowers（3 分钟搞定）

方式一：一条命令安装（推荐）

打开终端，运行：

claude plugin install superpowers

装完后重启 Claude Code（输入 /quit 退出，再重新运行 claude），你会看到提示：

✓ Superpowers skills loaded: 14 skills available

方式二：手动安装（适合无法联网的环境）

# 1. 克隆仓库
git clone https://github.com/obra/superpowers.git ~/.config/claude/superpowers

# 2. 在 Claude Code 中注册插件
# 启动 claude，然后输入：
> /plugin add ~/.config/claude/superpowers

# 3. 验证安装
> /skills list
# 应该能看到 brainstorming、executing-plans 等技能

怎么确认装好了？

在 Claude Code 里输入：

> 用 brainstorming 帮我规划一个待办事项应用

如果 Claude 开始问你需求细节（而不是直接写代码），说明装好了！

四、14 个核心 Skills 详解（附带使用场景）

Superpowers 提供了 14 个可组合技能，覆盖软件开发全生命周期。下面按使用频率和功能分类介绍：

🧠 第一类：需求与规划（写代码之前的必备步骤）

1. brainstorming — 头脑风暴

一句话解释： 让 Claude 先跟你讨论方案，再动手写代码。

适用场景：

  • 拿到一个新需求，不知道从哪开始
  • 有多个技术方案，拿不定主意
  • 想把需求拆分成可执行的任务

使用示例：

> 用 brainstorming 模式，帮我规划一个在线聊天室的功能模块

Claude 会做什么：

  1. 问你：用户量预期？需要历史消息吗？要不要表情包功能？
  2. 帮你列出功能清单
  3. 给出技术选型建议（WebSocket vs 轮询？Redis vs 数据库？）
  4. 输出一份结构化的方案文档

效果： 避免 AI "自作主张"选了一个不适合你场景的方案。

2. writing-plans — 编写执行计划

一句话解释： 把笼统的需求，拆成一步步的执行计划。

适用场景：

  • 需求已经明确，需要拆分成开发任务
  • 想让 Claude 按步骤推进，而不是一锅端
  • 需要留下书面计划，方便跟踪进度

使用示例：

> 用 writing-plans 模式，给"用户登录模块"制定开发计划

Claude 会输出：

## 用户登录模块 - 执行计划

### Phase 1: 数据库设计
- [ ] 1.1 设计 users 表结构
- [ ] 1.2 创建 migrations 文件

### Phase 2: 后端 API
- [ ] 2.1 实现 POST /api/login
- [ ] 2.2 实现 POST /api/register
- [ ] 2.3 添加输入校验和错误处理

### Phase 3: 测试
- [ ] 3.1 编写单元测试
- [ ] 3.2 编写集成测试

### Phase 4: 文档
- [ ] 4.1 更新 API 文档
- [ ] 4.2 更新 README
3. executing-plans — 执行计划

一句话解释： 按上面写的计划，一步步推进开发。

适用场景：

  • 已经有了计划文档
  • 想让 Claude 自动按节点推进，你只需要在关键节点确认

使用示例：

> 用 executing-plans 模式，执行上面的计划（引用上一条消息）

Claude 会做什么：

  1. 读取计划文档
  2. 从第一个任务开始，完成一个再推进下一个
  3. 每完成一个阶段，向你汇报进度
  4. 遇到问题会自动调整计划并征求你的同意

🔧 第二类：开发与编码（核心工作流）

4. writing-code — 编写代码

一句话解释： 在明确的规格说明下，按规范写代码。

适用场景：

  • 已经有了详细的需求文档或接口定义
  • 需要 Claude 按照既有代码风格继续开发
  • 需要保证代码质量和一致性

注意： 这个 skill 通常配合 executing-plans 使用，而不是单独调用。

5. using-tdd — 测试驱动开发（TDD）

一句话解释： 先写测试，再写代码，确保每一行代码都有测试覆盖。

适用场景：

  • 写核心业务逻辑（比如支付、订单处理）
  • 重构老代码，需要保证不改坏原有功能
  • 你想养成 TDD 习惯，但总是偷懒

使用示例：

> 用 using-tdd 模式，实现购物车的价格计算功能

Claude 的工作流：

  1. 先写测试 —— 定义"什么算正确"
  2. 再写代码 —— 让测试通过
  3. 重构优化 —— 在测试保护下改进代码
  4. 输出覆盖率报告 —— 告诉你测到了多少

效果： 代码质量显著提升，重构不再心惊胆战。

6. using-integration-tests — 集成测试

一句话解释： 不只测单个函数，还要测模块之间的协作。

适用场景：

  • 写完一个完整功能（比如"用户下单"涉及用户模块 + 商品模块 + 订单模块）
  • 需要验证 API 接口是否正常工作
  • 数据库连接、第三方 API 调用等需要真实环境测试

🚀 第三类：并行与效率（高级技巧）

7. dispatching-parallel-agents — 并行代理调度

一句话解释： 把一个大任务拆成多个小任务，同时交给多个 Claude "分身"去完成。

适用场景：

  • 需要同时开发多个独立模块（比如同时做用户模块、商品模块、订单模块）
  • 需要同时跑多个测试套件
  • 有大量重复性工作（比如给 20 个 API 补全文档）

使用示例：

> 用 dispatching-parallel-agents 模式，同时开发用户、商品、订单三个模块

Claude 会做什么：

  1. 分析任务依赖关系
  2. 启动多个"子 Claude"同时工作
  3. 汇总结果，解决冲突
  4. 输出合并后的代码

效果： 原本需要 3 小时的顺序开发，可能 1 小时就搞定。

8. debugging — 调试专家

一句话解释： 遇到 bug 时，让 Claude 系统化地定位和修复问题。

适用场景：

  • 代码报错了，但看不懂错误信息
  • 有个 bug 时隐时现，找不到规律
  • 性能有问题，不知道瓶颈在哪

使用示例：

> 用 debugging 模式，帮我排查为什么用户登录总是失败

Claude 的排查流程：

  1. 收集错误信息、日志、复现步骤
  2. 提出假设（可能是密码加密方式不对？可能是 Session 过期太快？）
  3. 逐一验证假设
  4. 给出修复方案并动手改

📦 第四类：Git 与分支管理

9. finishing-a-development-branch — 完成开发分支

一句话解释： 在合并代码之前，帮你做一遍完整的检查清单。

适用场景：

  • 功能开发完了，准备提 PR
  • 想确保没有遗漏任何步骤
  • 需要规范 Git commit message

Claude 会帮你检查：

  • ✅ 所有测试都通过了吗？
  • ✅ 代码有没有 lint 错误？
  • ✅ README 和文档更新了吗？
  • ✅ 有没有遗留的 console.log 或调试代码？
  • ✅ Git commit message 是否规范？

最后： 自动生成一个规范的 PR 描述。

10. working-with-git-history — Git 历史操作

一句话解释： 安全地操作 Git 历史（rebase、cherry-pick、reset 等）。

适用场景：

  • 需要整理 commit 历史（多个小 commit 合并成一个）
  • 需要把某个 commit 应用到其他分支
  • 误操作了，需要回退

注意： 这个 skill 会在操作前反复确认，避免你误操作丢失代码。

📚 第五类：文档与沟通

11. writing-specifications — 编写规格说明

一句话解释： 把模糊的需求，转化成精确的、可执行的规格文档。

适用场景：

  • 需要写 API 接口文档
  • 需要定义模块之间的契约
  • 需要留下书面规格，方便其他人接手
12. writing-feedback — 编写反馈报告

一句话解释： 代码审查后，生成结构化的反馈报告。

适用场景：

  • 审查同事的代码，需要给出详细反馈
  • 被 code review 了，需要理解所有问题点
  • 需要留下审查记录

🛡️ 第六类：质量保证

13. acceptance-testing — 验收测试

一句话解释： 从用户角度验证功能是否真的可用。

适用场景：

  • 功能开发完了，需要模拟用户操作验证
  • 需要编写 E2E（端到端）测试
  • 需要确保边界情况和异常流程也处理了
14. writing-tests — 编写测试（通用）

一句话解释： 给现有代码补充测试用例。

适用场景：

  • 接手了一个没有测试的老项目
  • 需要快速提升测试覆盖率
  • 重构前先补测试，保证安全

五、实战演示：用 Superpowers 开发一个完整功能

让我们用一个完整的例子，看看 Superpowers 是怎么工作的。

任务：开发一个"用户注册"功能

第 1 步：用 brainstorming 讨论方案

你：用 brainstorming 模式，帮我规划用户注册功能

Claude：
好的，在动手之前我需要了解几个问题：

1. 注册需要哪些字段？只要手机号+密码，还是需要邮箱、用户名？
2. 需要短信/邮箱验证码吗？
3. 密码有什么要求？（长度、复杂度）
4. 需不需要邮箱/手机验证激活？
5. 有没有现有的用户表结构可以参考？

你：只要手机号+密码，需要短信验证码，密码至少8位含大小写字母和数字，需要短信验证激活，参考现有的 users 表。

Claude：
明白了，我给你出一份方案文档...
（输出详细的技术方案，包括数据库表设计、API 接口定义、流程图等）

第 2 步：用 writing-plans 制定计划

你：方案没问题，用 writing-plans 制定执行计划

Claude：
好的，这是执行计划：

Phase 1: 数据库准备
- 1.1 检查现有 users 表结构
- 1.2 添加短信验证码相关字段（sms_code, sms_expires_at）
- 1.3 创建 migrations 文件

Phase 2: 后端 API
- 2.1 实现 POST /api/sms/send（发送短信验证码）
- 2.2 实现 POST /api/register（注册接口）
- 2.3 添加参数校验和错误处理

Phase 3: 测试
- 3.1 编写单元测试（mock 短信服务）
- 3.2 编写集成测试（真实数据库）

Phase 4: 文档
- 4.1 更新 API 文档
- 4.2 更新 README

确认后我就开始执行。

第 3 步：用 executing-plans + using-tdd 执行

你：确认，用 executing-plans 和 using-tdd 模式执行

Claude：
✓ 开始执行 Phase 1...
  - 1.1 检查 users 表：发现缺少 sms_code 字段
  - 1.2 编写 migration 文件...
  - 1.3 执行 migration... 完成！

✓ 开始执行 Phase 2...
  - 使用 TDD 模式：先写测试，再写代码
  - 2.1 编写 /api/sms/send 的测试用例（5个场景）
  - 2.2 实现 /api/sms/send，让测试通过
  - 2.3 编写 /api/register 的测试用例（8个场景）
  - 2.4 实现 /api/register，让测试通过
  - 完成！

✓ 开始执行 Phase 3...
  - 运行所有测试：32 个测试全部通过 ✅
  - 覆盖率报告：87.5%

✓ 开始执行 Phase 4...
  - 更新 API 文档（添加两个新接口说明）
  - 更新 README（添加注册功能使用说明）

所有任务完成！🎉

第 4 步：用 finishing-a-development-branch 准备提交

你：用 finishing-a-development-branch 检查一遍

Claude：
正在执行检查清单...

✅ 所有测试通过（32/32）
✅ 无 lint 错误
✅ 代码覆盖率 87.5%（达标）
✅ README 已更新
✅ API 文档已更新
✅ 无遗留的调试代码
✅ Git commit message 规范

准备提 PR，这是 PR 描述：

---
**功能：** 用户注册（手机号+短信验证）

**变更：**
- 新增 POST /api/sms/send 接口
- 新增 POST /api/register 接口
- users 表新增 sms_code, sms_expires_at 字段

**测试：**
- 新增 13 个测试用例
- 覆盖率 87.5%

**检查清单：**
- [x] 测试全部通过
- [x] 代码审查完成
- [x] 文档已更新
---

要我帮你提交吗？

对比一下：有 vs 没有 Superpowers

步骤 没装 Superpowers 装了 Superpowers
需求理解 Claude 猜，经常猜错 先讨论，确认了再动手
任务拆分 一锅端，写到哪算哪 有计划，一步步推进
代码质量 看运气 强制 TDD，有测试保护
完成标准 Claude 说"好了"就是好了 有明确的检查清单
最终交付 可能漏这漏那 完整的代码 + 测试 + 文档

六、Superpowers 适合你吗？

✅ 适合以下人群：

  1. 编程新手 —— 它能教你规范的开发流程，帮你养成好习惯
  2. 独立开发者 —— 没有人 code review，让 Superpowers 当你的"技术主管"
  3. 项目负责人 —— 确保团队成员（包括 AI）都按统一标准开发
  4. 接手老项目的 —— 用它的测试、文档 skills 快速补齐短板

⚠️ 可能不适合：

  • 快速原型验证 —— 如果你想 10 分钟搞个 demo，Superpowers 的规范流程可能显得"啰嗦"
  • AI 老手 —— 如果你已经很会"调教" Claude Code，可能觉得它限制太多
  • 非软件开发场景 —— 它是专门为软件工程设计的，写文章、做数据分析用不上

七、常见问题 FAQ

Q1：Superpowers 会影响 Claude Code 的响应速度吗？

A：会有一定影响，因为 AI 需要做更多"思考"和"规划"。但相比返工和 debug 的时间，这点等待是值得的。

Q2：可以只激活部分 Skills 吗？

A：可以。在 Claude Code 里用 /skills deactivate <skill-name> 关闭不用的 skill。

Q3：Superpowers 是免费的吗？

A：是的，它是开源项目（MIT 协议），完全免费。你在 GitHub 上搜索 obra/superpowers 就能找到源码。

Q4：如果 AI 按照 Skills 流程做出来的东西我还是不满意怎么办？

A：Skills 只是流程框架，具体的代码质量还是取决于你的需求描述和反馈。不满意就继续迭代，AI 会按照你的反馈调整。

Q5：Superpowers 和 Anthropic 官方 Skills 市场是什么关系？

A：Superpowers 是社区开源项目，不是 Anthropic 官方出品。但它遵循 Anthropic 的插件规范，可以无缝集成到 Claude Code 中。

Q6：装了 Superpowers 之后，还能用其他 Skills 吗？

A：可以，Skills 之间一般不冲突。你可以同时激活 Superpowers + API Doc Generator + Security Scan 等。

八、总结：为什么我推荐 Superpowers？

  1. 流程大于提示词 —— 它不是教你"怎么写提示词"，而是直接把工程规范固化成流程
  2. 开箱即用 —— 一条命令安装，14 个 skills 覆盖全流程
  3. 质量有保障 —— TDD + 代码审查 + 验收测试，三重保障
  4. 适合小白 —— 跟着流程走，就算不懂软件工程，也能做出像模像样的代码
  5. 社区活跃 —— GitHub 12k+ star，持续更新，遇到问题容易找到答案

快速上手三步走

# 1. 安装
claude plugin install superpowers

# 2. 重启 Claude Code
/quit
claude

# 3. 试试第一个 skill
> 用 brainstorming 模式，帮我规划一个 XXX 功能

👨‍💻 H先生出品 | 专注 AI 工具与效率提升

下期预告：《Claude Code + Superpowers 实战：从零开发一个完整项目》

Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

cover

DeepSeek RAG 查询缓存命中率优化：如何从 30% 提升到 80% 的工程实践

avatar DeepSeek技术社区
cover

DeepSeek-V4 服务健康检查：为什么你的离线评测全绿，上线却崩了？

avatar DeepSeek技术社区
cover

DeepSeek输出护栏实战：如何用结构化JSON抵御越狱与幻觉

avatar DeepSeek技术社区