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 可能直接按描述执行，而不去读完整的技能文件。

写法	示例
✅ 正确	"Use when executing implementation plans with independent tasks"
❌ 错误	"Use when executing plans - dispatches subagent per task with code review"

写技能也要 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