superpowers 教程
老师：Claude Code 插件体系的资深工程师，带你从零掌握 AI 编程的工程纪律。
课前必读：为什么要学 superpowers？
你用过 Claude Code 吗？用它写代码时，是不是经常遇到这种情况：
- Agent 二话不说就开始写代码，写到最后才发现自己理解错了需求
- 写到一半发现漏了这个那个依赖，返工重写
- 改 bug 时凭直觉乱试，花了几个小时才发现真正原因
- 代码写完了自己都不太敢确定是不是真的修好了
这些问题不是 Claude 的问题，是工程流程缺失的问题。
superpowers 是一套强制你走完整工程流程的”纪律框架”——它不是建议，是强制。14 个 Skill 自动触发，你不需要记得调用，Agent 自动会按流程走。
第一课：superpowers 是什么
核心理念
一句话：不让 Agent 直接跳进去写代码。
传统开发流程是���需求 → 设计 → 实现 → 测试 → 验收
但 AI Agent 的问题是拿到需求就开干，干到一半发现理解错了，或者写完了才发现有更好的方案。
superpowers 的解决方案是：在写代码之前，强制 Agent 停下来问清楚需求。
四大核心原则
| 原则 | 意思 | 举个例子 |
|---|---|---|
| TDD 优先 | 永远先写测试 | 要写一个加法函数？先写 assert add(1,2) == 3，让测试失败，再写代码让它通过 |
| 系统化 > 临时性 | 按流程走，别凭感觉 | 遇到 bug？不是这里改改那里试试，而是用 4 阶段根因分析 |
| 复杂度削减 | 简洁是首要目标 | 别过度设计，YAGNI——You Aren’t Gonna Need It |
| 证据优于声明 | 声称修好了？拿证据来 | 写完代码必须跑测试、必须验证，而不是”我觉得好了” |
第二课：7 步工作流
这是 superpowers 的核心骨架。每次你要用 AI Agent 写代码，它都会自动带你走这 7 步：
需求 → 设计 → 计划 → 执行 → 测试 → 审查 → 收尾
步骤详解
第 1 步：brainstorming（需求澄清）
触发时机：你想写代码了
做什么：Agent 会用 Socratic 方法追问你——“你想实现什么？”、“这个功能的核心价值是什么？”、“有没有副作用？”
产出：一份设计文档（Design Document）
为什么重要：80% 的代码返工源于需求理解偏差。这一步帮你把模糊的想法澄清成具体的规格。
第 2 步：using-git-worktrees（创建隔离工作区）
触发时机：设计文档确认后
做什么：创建一个独立的 Git worktree，在新分支上工作
产出：干净的独立开发环境
为什么重要：不污染主分支，随时可以丢弃重头开始。
第 3 步：writing-plans（拆解任务）
触发时机：有设计文档后
做什么：把整个任务拆成 2-5 分钟能完成的小任务，每个任务包含：
- 精确的文件路径
- 完整的代码示例
- 验证步骤（怎么知道这一步完成了）
产出：任务清单（Task List）
为什么重要：Agent 不擅长一次性处理大任务。拆小后，每个任务都是可验证的。
第 4 步：subagent-driven-development（子 Agent 执行）
触发时机：有计划后
做什么：Agent 会创建子 Agent 并行或分批执行任务，每完成一个任务做两阶段审查：
- 规格合规性：这代码真的实现了设计文档的要求吗？
- 代码质量：有没有明显的代码坏味道？
产出：实现代码 + 审查报告
为什么重要：一个人很难同时做实现和审查。子 Agent 机制实现了”别人帮你 review”。
第 5 步：test-driven-development（TDD）
触发时机：实现过程中
做什么：严格遵循 RED-GREEN-REFACTOR 循环：
- RED：先写一个会失败的测试
- GREEN：写最少的代码让测试通过
- REFACTOR：优化代码，保持测试通过
- 提交：每完成一个循环就 commit
产出：测试通过的代码
为什么重要：没有测试的代码 = 未经验证的代码。你怎么知道你写的是对的？
第 6 步：requesting-code-review（代码审查）
触发时机：任务之间
做什么：按严重度分类报告发现的问题：
- Critical：必须修复，否则无法合并
- Major：建议修复
- Minor：可选优化
产出：审查报告
为什么重要：Critical 问题必须阻断进度，不能带病上线。
第 7 步：finishing-a-development-branch（收尾）
触发时机：所有任务完成
做什么：
- 验证所有测试通过
- 让你选择下一步：merge / PR / 保留 / 丢弃
- 清理 worktree（如选择丢弃）
产出：决策
为什么重要：开发不是写完代码就结束，怎么合并、要不要保留、什么时候该放弃，都是工程决策。
第三课：14 个 Skill 全览
superpowers 由 14 个 Skill 组成，分为 4 类：
测试类
| Skill | 作用 |
|---|---|
| test-driven-development | RED-GREEN-REFACTOR 循环 |
调试类
| Skill | 作用 |
|---|---|
| systematic-debugging | 4 阶段根因分析 |
| verification-before-completion | 完成前必须验证 |
协作类（10 个）
| Skill | 作用 |
|---|---|
| brainstorming | Socratic 需求澄清 |
| writing-plans | 拆解任务清单 |
| executing-plans | 批次执行+检查点 |
| dispatching-parallel-agents | 并发子 Agent |
| requesting-code-review | 代码审查 |
| receiving-code-review | 响应审查反馈 |
| using-git-worktrees | 并行分支��理 |
| finishing-a-development-branch | Merge/PR 决策 |
| subagent-driven-development | 子 Agent 执行+两阶段审查 |
元类
| Skill | 作用 |
|---|---|
| writing-skills | 如何创建新 Skill |
| using-superpowers | Skill 系统入门 |
第四课：安装与体验
安装命令（Claude Code）
/plugin install superpowers@claude-plugins-official首次体验
安装后，打开 Claude Code，随意说一句话比如”帮我写一个排序算法”。
观察发生什么：Agent 不会直接写代码，而是会先问你问题——“你想要哪种排序算法？""输入数据有什么特点？""对时间空间复杂度有要求吗？”
这就是 brainstorming Skill 被自动触发了。
课后练习
- Day 1：安装 superpowers，体验一次 brainstorming
- Day 2：用 writing-plans 拆解一个小任务
- Day 3：体验 subagent-driven-development + TDD
- Day 4：模拟一个 bug，用 systematic-debugging 定位
- Day 5：完成功能后，走一遍 requesting-code-review + finishing
下节课预告
下一课我会详细讲解 brainstorming 的具体工作方式，以及如何写出一份合格的设计文档。
有问题随时问。🚀