乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > 【保姆级】Superpowers 插件:给 Claude Code 装上＂工程大脑＂,小白也能写出专业代码

【保姆级】Superpowers 插件:给 Claude Code 装上＂工程大脑＂,小白也能写出专业代码

当前时间： 2026-04-28 16:11:41 更新时间： 2026-04-28 分类：软件教程 评论(0)

【保姆级】Superpowers 插件:给 Claude Code 装上＂工程大脑＂,小白也能写出专业代码

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

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

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

打个比方你就懂了

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

没装 Superpowers 之前：

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

装了 Superpowers 之后：

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

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

二、为什么需要 Superpowers？

问题1：AI 太”着急”了

普通的 Claude Code 对话：

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

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

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

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

Superpowers 的解决方案

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

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

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

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

打开终端，运行：

ounter(lineclaude plugin install superpowers

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

ounter(line✓ Superpowers skills loaded: 14 skills available

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

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line# 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 里输入：

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

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

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

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

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

1. brainstorming — 头脑风暴

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

适用场景：

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

使用示例：

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

Claude 会做什么：

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

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

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

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

适用场景：

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

使用示例：

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

Claude 会输出：

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line## 用户登录模块 - 执行计划### 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 自动按节点推进，你只需要在关键节点确认

使用示例：

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

Claude 会做什么：

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

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

4. writing-code — 编写代码

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

适用场景：

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

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

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

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

适用场景：

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

使用示例：

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

Claude 的工作流：

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

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

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

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

适用场景：

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

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

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

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

适用场景：

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

使用示例：

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

Claude 会做什么：

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

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

8. debugging — 调试专家

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

适用场景：

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

使用示例：

ounter(line> 用 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 讨论方案

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line你：用 brainstorming 模式，帮我规划用户注册功能Claude：好的，在动手之前我需要了解几个问题：1. 注册需要哪些字段？只要手机号+密码，还是需要邮箱、用户名？2. 需要短信/邮箱验证码吗？3. 密码有什么要求？（长度、复杂度）4. 需不需要邮箱/手机验证激活？5. 有没有现有的用户表结构可以参考？你：只要手机号+密码，需要短信验证码，密码至少8位含大小写字母和数字，需要短信验证激活，参考现有的 users 表。Claude：明白了，我给你出一份方案文档...（输出详细的技术方案，包括数据库表设计、API 接口定义、流程图等）

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

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line你：方案没问题，用 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 执行

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line你：确认，用 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 准备提交

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line你：用 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，持续更新，遇到问题容易找到答案

快速上手三步走

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line# 1. 安装claude plugin install superpowers# 2. 重启 Claude Code/quitclaude# 3. 试试第一个 skill> 用 brainstorming 模式，帮我规划一个 XXX 功能

👨‍💻 H先生出品 | 专注 AI 工具与效率提升 关注公众号，回复「Superpowers」获取本文的完整 Skills 清单 PDF

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