Claude Code必备Superpowers技能从入门到精通

Superpowers 是 Claude Code 生态里官方热门的工程规范插件，一套强制标准化的开发流程。它专门用来治AI那些“上来就乱写、需求跑偏、代码没测试、瞎改Bug”的Vibe Coding顽疾。整个插件包含14个可组合的技能（Skill），分成三大类：新手4个核心必装、进阶工程技能、以及元能力底层技能。下面这张图可以先帮你建立整体印象：

一、新手4个刚需必备技能（日常开发必开，零门槛）

1. superpowers:brainstorming 需求头脑风暴（第一道硬门禁）

触发条件：新建功能、重构、需求模糊时自动调用；也可手动命令 /superpowers:brainstorming。核心规则是硬锁（HARD-GATE）：不确认设计文档，一行代码都不许写。流程如下：

1. 扫描项目现有代码和文档，摸清所有约束条件
2. 用苏格拉底式追问把缺失需求一条条挖出来（技术栈、安全、边界、用户场景、权限等）
3. 输出2~3套实现方案，对比优劣并给出推荐
4. 生成规范的设计文档，存入 docs/superpowers/specs/
5. 等你确认方案，才允许进入写计划阶段

这套流程解决的痛点很明确：AI误解需求、写了一半全部返工、遗漏安全或边界逻辑——这些坑踩过的人都知道有多疼。

2. superpowers:writing-plans 任务规划拆解

触发条件：脑暴确认设计后自动触发；也可手动 /superpowers:write-plan。输出的标准化开发计划包括：

• 把任务拆成2~5分钟就能完成的原子微任务
• 每个任务都标注精确的修改文件路径、依赖关系、风险点
• 配套每个任务的验证命令（单元测试、接口请求、Lint）

这个技能的价值在于：大型重构或多文件修改不再混乱，每一步都能单独校验。想象一下，以前那种改个东西连带着改崩一片的恐慌感，终于可以终结了。

3. superpowers:test-driven-development (TDD) 测试驱动开发（铁律）

强制规则：先写测试、跑红失败，再写业务代码跑绿，最后重构。适用场景：新功能、接口、Bug修复、工具函数。效果很直接：杜绝AI写出那种无覆盖、运行即报错的代码，自带回归保障。说白了，就是让AI也遵守TDD的纪律，而不是拍脑袋写代码。

4. superpowers:systematic-debugging 系统化根因排错

触发条件：报错、测试失败、异常行为自动启用。它采用标准化的4步调试流程：

1. 复现问题，收集完整日志堆栈
2. 列出所有可能的根因假设
3. 逐个验证假设，排除无效猜测
4. 定位根源后再写修复方案

特别有一条约束：连续3次修复失败，强制触发架构评审——禁止盲目改代码。这条规则非常实用，避免了AI反复试错却不解决问题的循环。

二、中大型项目进阶必备技能（复杂开发/重构专用）

5. superpowers:executing-plans 分步执行开发计划

手动命令 /superpowers:execute-plan。这个技能会自动创建独立子袋里来执行每个微任务，隔离上下文污染；全程使用Git Worktree隔离工作区，不污染主分支；单个任务完成后自动执行自检加代码评审双重校验。

6. superpowers:using-git-worktrees 隔离开发分支

自动创建独立工作树，功能开发、重构、Bug修复互不干扰。基线代码永远保持干净，想要丢弃失败改动，一键就能搞定。

7. superpowers:requesting-code-review / receiving-code-review 代码评审

• requesting-code-review：开发完成后自动提交评审清单，覆盖架构、规范、安全、测试覆盖率等维度。
• receiving-code-review：收到评审意见后先复盘问题，再动手修改，不是盲目覆盖。

8. superpowers:verification-before-completion 完工强制校验

AI不能随便说一句“写完了”就完事。它必须自动执行：全量测试、Lint、类型检查、边界用例验证——全部通过才算完成。这招可以有效杜绝AI的幻觉式“代码正常”声明。

9. superpowers:dispatching-parallel-agents 并行多任务

对于那些没有依赖关系的独立任务（比如前端页面、后端接口、单元测试），自动分发到多个子袋里并行开发，大幅提升开发速度。

10. superpowers:finishing-a-development-branch 分支收尾集成

全部功能验收完成后，自动处理合并冲突、生成提交日志、整理变更文档、输出上线检查清单。收尾工作不会再有遗漏。

三、元能力终极技能（自定义AI规则，团队神器）

11. superpowers:writing-skills 自定义技能生成（最强超能力）

这个技能允许你按照规范让Claude生成专属的自定义Skill文件，完全适配公司内部规范、特定框架、业务规则。举个例子：创建一个Vue3+Vite性能优化Skill，包含Core Web Vitals校验、分包、图片懒加载、Lighthouse自动化验证。生成后可以永久复用，统一团队AI编码标准。

12. superpowers:using-superpowers 总调度入口

这是整套框架的底层核心技能，自动识别当前任务场景，匹配调用对应的Skill。可以把它理解成整个系统的调度中枢。

13. superpowers:subagent-driven-development 子袋里驱动开发

拆分复杂任务为独立子会话，避免超长上下文导致信息丢失。特别适合上千行的大型重构任务。

四、标准完整工作流（4核心技能串联）

1. 需求描述 → 自动触发 brainstorming 澄清需求、生成设计文档
2. 确认设计 → 自动调用 writing-plans 拆分成微任务计划
3. 执行计划 → executing-plans + TDD 先写测试再编码
4. 出现报错 → 自动切到 systematic-debugging 进行根因排查
5. 全部完成 → verification-before-completion 全量校验 + 代码评审

五、安装与使用命令

1. 安装（在Claude Code终端中执行）

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

2. 手动调用技能命令

/superpowers:brainstorming    # 需求梳理
/superpowers:write-plan       # 生成开发计划
/superpowers:execute-plan     # 执行开发任务
/superpowers:systematic-debugging # 排错

3. 查看全部技能

/superpowers

六、使用建议

1. 小型工具/脚本：只开启 brainstorming + writing-plans 即可，减少Token消耗。
2. 业务项目/前后端开发：建议全套4个核心技能全部打开，TDD加调试能力能大幅降低返工率。
3. 团队标准化开发：额外开启 writing-skills 定制企业专属编码规范。
4. 大型重构/多文件改造：建议开启git隔离、并行袋里、代码评审等全套进阶技能。