Superpowers 驯服Agent：小白从入门到精通
这篇文章能帮你做什么？
如果你装了 Claude Code，但 AI 写出来的代码总是差点意思——要么没问清楚就动手、要么写完不测试、要么改着改着就跑偏——这篇文章就是为你写的。
读完你会：知道 Superpowers 是什么、能装好并跑通、会用核心流程写代码、甚至能自己写一个专属技能。
预计阅读时间：15 分钟（实操部分约 30 分钟）
Part 1 — 先搞清楚：Superpowers 到底是什么？
一句话版本
Superpowers = 给 AI 编程助手套上的「工程纪律手册」。它不会让 AI 变聪明，但会让它变靠谱。
一个比喻帮你理解
没有 Superpowers 的 AI，就像一个刚毕业的实习生——很聪明、写得快，但：
|
没有 Superpowers |
有了 Superpowers |
|---|---|
|
看到需求就写代码，不问你到底要什么 |
先问你几个关键问题，把需求挖清楚 |
|
写完代码不测试，出问题再救火 |
先写测试再写代码，每一步都验证 |
|
没有规划，做到一半发现方向不对 |
先拆成小任务，每个任务 2-5 分钟搞定 |
|
直接在主分支改代码，改坏了很难回滚 |
自动创建独立分支，不怕污染主线 |
它的本质
Superpowers 是一套 Markdown 格式的技能文件（SKILL.md），每个文件定义了一套工作纪律。比如：
- 头脑风暴技能 — 强制 AI 先问清楚再动手
- TDD 技能 — 强制 AI 先写测试再写代码
- 代码审查技能 — 强制 AI 自查代码质量
- Git Worktree 技能 — 强制 AI 在隔离分支上工作
这些技能可以组合使用，也可以单独启用。GitHub 上已有 93,000+ Star，是 2026 年增长最快的开源项目之一。
Part 2 — 动手安装（5 分钟搞定）
第 1 步：安装
打开终端，输入这一条命令：
/plugin install superpowers@claude-plugins-official --global如果只想在当前项目使用，去掉 --global：
/plugin install superpowers@claude-plugins-official安装完成后，Claude 会自动确认并列出所有可用的技能。
第 2 步：验证是否生效
随便给 Claude 一个开发需求，观察它的反应：
|
表现 |
说明 |
|---|---|
|
✅ 正确 |
Claude 先问你问题，不急着写代码 |
|
❌ 不对 |
Claude 直接开始输出代码 |
如果是后者，试试手动触发：输入 /superpowers:brainstorm，看技能是否正常加载。
第 3 步：更新版本
/plugin update superpowers当前最新版本是 v5.0.7。如果安装后 Claude 还是直接写代码，用 /plugin list 确认插件是否已在列表中。
Part 3 — 第一次使用：看看 Claude 变成什么样了
Superpowers 的 7 个阶段
装了 Superpowers 后，Claude 会把你的需求走完 7 个阶段，每个阶段有「入口条件」和「出口条件」——不走完当前阶段，就不让进下一个。
|
# |
阶段 |
做什么 |
为什么重要 |
|---|---|---|---|
|
1 |
头脑风暴 |
Claude 向你提问，把需求细节挖干净 |
方向不对，后面的都是白做 |
|
2 |
设计确认 |
把方案拆成小块，逐块让你确认 |
小块容易审，大文档你会直接跳过 |
|
3 |
工作区隔离 |
自动创建独立 Git 分支 |
改坏了随时删，不污染主线 |
|
4 |
编写计划 |
拆成 2-5 分钟的小任务 |
任务小到不可能失败 |
|
5 |
子代理开发 |
每个任务派一个全新的 AI 去执行 |
新鲜上下文，判断力不衰减 |
|
6 |
代码审查 |
独立 AI 审查所有代码 |
多一双眼睛，少一个 bug |
|
7 |
分支收尾 |
问你：合并？提 PR？保留？丢弃？ |
你来决定代码的最终去向 |
一个真实的例子
假设你对 Claude 说：「帮我做一个用户权限管理」
没有 Superpowers：
Claude 直接开始写代码 → 用了 RBAC 但你想要 ABAC → 没写测试 → 直接改 main 分支 → 上线后出 bug → 回滚折腾半天
有 Superpowers：
Claude 先问你：权限模型用 RBAC 还是 ABAC？要不要多租户？粒度到页面还是 API 级别？现有系统有认证方案吗？ → 确认设计 → 创建独立分支 → 写测试 → 写代码 → 审查 → 问你合并还是提 PR
区别一目了然。
Part 4 — 四大核心能力逐一学会
能力一：TDD（测试驱动开发）
铁律：没有失败的测试，就不能写功能代码。没有例外。
Superpowers 把 TDD 变成了一个你不能跳过的循环：
|
步骤 |
名称 |
做什么 |
|---|---|---|
|
RED |
写失败的测试 |
写一个最小的测试，运行它，确认它失败 |
|
GREEN |
写最少的代码 |
写刚好能让测试通过的代码，不多写一行 |
|
REFACTOR |
改善代码质量 |
消除重复、改善命名，同时保证测试仍然通过 |
AI 常见的逃避理由（以及为什么不成立）：
|
AI 可能会说 |
实际情况 |
|---|---|
|
「这个太简单了不需要测试」 |
简单的功能，测试也简单，没有理由跳过 |
|
「我先写完再补测试」 |
后补的测试验证的是你写了什么，不是你需要什么 |
|
「我已经手动测过了」 |
手动测试不可复现，下次改代码谁来保证？ |
能力二：头脑风暴（Brainstorming）
核心原则：不问清楚不动手。Claude 会通过递进式提问，把你的需求细节全部挖出来。
关键是：这些问题不是通用模板，而是 Claude 读了你的代码库之后，结合实际情况提出的。如果你的项目里已经有 auth 模块，它会问「是扩展现有的还是重新设计」；如果用了某个 ORM，它会问「数据模型怎么跟现有的表结构对接」。
新功能（v5.0）：Claude 可以生成可交互的 HTML 原型在浏览器中预览，不用再猜「按钮在左边还是右边」。
能力三：子代理驱动开发（Subagent-Driven Development）
这是 Superpowers 最核心的创新。
为什么不让一个 Claude 一路做到底？因为对话越长，AI 的判断力越差（上下文污染）。Superpowers 的做法是：每个任务派一个全新的 AI 去执行，只给它当前任务描述和必要上下文。
每个任务完成后，经历两阶段审查：
审查 1：规格符合性
代码是否完全符合设计规格？功能点有没有遗漏？
审查 2：代码质量
风格一致吗？测试覆盖充分吗？命名清晰吗？
审查不通过？打回重做。通过了才进入下一个任务。
能力四：代码审查（Code Review）
所有任务完成后，一个独立的审查 AI 对整个代码库做最终审查。它不是只看最后改的几行，而是从全局视角评估变更的影响。
审查完成后，Claude 会问你怎么处理这个分支：创建 PR、本地合并、保留、还是丢弃。
Part 5 — 日常使用技巧
什么时候用全部流程，什么时候可以跳过？
|
场景 |
建议 |
|---|---|
|
生产项目、新功能开发 |
走完整 7 阶段流程 |
|
修 bug |
走调试 + TDD + 审查流程 |
|
快速原型、一次性脚本 |
告诉 Claude「这是快速原型，不需要走完整流程」 |
|
小改动（改个文案、调个样式） |
可以跳过，Superpowers 尊重你的判断 |
省钱技巧：用便宜模型跑执行
v5.0 的一个重要变化：由于有了详细的预规划，执行具体任务时可以用 Claude Haiku 这样的轻量模型。协调者用强模型掌控全局，执行者用弱模型完成具体任务，大幅节省 token 消耗。
团队协作建议
- 把 Superpowers 配置提交到项目的
.claude/目录，确保团队用同一套流程 - 用
CLAUDE.md文件覆写全局配置——项目级规则优先于全局规则 - 自定义技能也提交到版本库，团队共享
Part 6 — 进阶：写一个你自己的技能
这是 Superpowers 最强大的地方——你可以自己扩展它。用内置的 writing-skills 元技能来创建自定义技能。
技能文件的基本结构
每个技能就是一个 Markdown 文件（SKILL.md），带一个 YAML 前言：
---
name: my-custom-skill
description: "Use when [具体的触发条件]"
---
# 技能名称
## Overview
这个技能是什么，核心原则一句话说清。
## When to Use
- 触发条件 1
- 触发条件 2
## Implementation
具体步骤。
description 怎么写？
这是最容易出错的地方。记住一条规则：
description 只能回答「什么时候用」，不能回答「怎么用」。如果描述了工作流程，AI 可能直接按描述执行，而不去读完整的技能文件。
|
写法 |
示例 |
|---|---|
|
✅ 正确 |
|
|
❌ 错误 |
|
写技能也要 TDD
没错，写技能本身也要遵循 TDD：
|
TDD 概念 |
技能开发中的对应 |
|---|---|
|
测试用例 |
用子代理跑压力测试场景 |
|
RED（测试失败） |
没有技能时，AI 违反规则（建立基线） |
|
GREEN（测试通过） |
有技能后，AI 遵循规则 |
|
REFACTOR |
堵住漏洞，同时保持合规 |
怎么测？让子代理扮演在高压场景下工作的开发者，看它会不会跳过规则。比如：
- 「生产环境炸了，每分钟损失 5000 美元」——AI 会不会跳过 TDD？
- 「老板说赶紧上线，测试先不管了」——AI 会不会妥协？
如果测试场景下 AI 跳过了规则，说明技能写得不够强，需要加固。
几个实用的自定义技能方向
|
技能 |
用途 |
|---|---|
|
发布检查清单 |
部署前的标准化检查流程 |
|
架构决策记录（ADR） |
强制记录重要的架构决策 |
|
安全审查 |
代码提交前的安全合规检查 |
|
新人上手指南 |
把组织内的知识打包成技能 |
Part 7 — 常见问题速查
Q1：安装后 Claude 还是直接写代码？
检查三点：① /plugin list 确认已安装；② 试 /superpowers:brainstorm 手动触发；③ 检查是否有 CLAUDE.md 覆盖了行为。
Q2：TDD 太慢了，简单功能也要先写测试？
简单的功能，测试也简单。TDD 的价值不在当下，在于三个月后有人改了你的代码，测试能告诉他有没有改坏。如果确实是一次性脚本，直接告诉 Claude 跳过流程即可。
Q3：可以只用部分技能吗？
可以。技能是可组合的，在 CLAUDE.md 中声明只启用特定技能即可。
Q4：支持非 TypeScript/JavaScript 项目吗？
完全支持。技能是语言无关的——TDD 对 Python、Go、Rust 同样适用。
Q5：和 Cursor / Windsurf 兼容吗？
Cursor 已有原生支持。其他编辑器只要能解析 SKILL.md 文件，就可以使用核心功能。
Q6：可以让 AI 自己工作很久吗？
可以。有了 Superpowers，AI 可以稳定自主工作数小时。原因在于子代理机制——每个任务都是新鲜上下文，不会因为对话变长而判断力下降。
结语
为什么 AI 写代码总是跑偏？不是 AI 不够聪明，是缺少约束。
Superpowers 做的事情很朴素：把软件工程几十年积累的最佳实践——TDD、代码审查、分支隔离、需求澄清——翻译成 AI 能理解、能遵循的结构化指令。
它不会让 AI 变聪明，但会让 AI 变靠谱。对大部分真实项目来说，靠谱比聪明重要得多。
参考资源
- GitHub 仓库：obra/superpowers
- Anthropic 官方插件页面
- Superpowers RELEASE-NOTES.md