Superpowers 是 Claude Code 生态里官方热门的工程规范插件，一套强制标准化的开发流程。它专门用来治AI那些“上来就乱写、需求跑偏、代码没测试、瞎改Bug”的Vibe Coding顽疾。整个插件包含14个可组合的技能（Skill），分成三大类：新手4个核心必装、进阶工程技能、以及元能力底层技能。下面这张图可以先帮你建立整体印象：
一、新手4个刚需必备技能（日常开发必开，零门槛）
1. superpowers:brainstorming 需求头脑风暴（第一道硬门禁）
触发条件：新建功能、重构、需求模糊时自动调用；也可手动命令 /superpowers:brainstorming。核心规则是硬锁（HARD-GATE）：不确认设计文档，一行代码都不许写。流程如下：
- 扫描项目现有代码和文档，摸清所有约束条件
- 用苏格拉底式追问把缺失需求一条条挖出来（技术栈、安全、边界、用户场景、权限等）
- 输出2~3套实现方案，对比优劣并给出推荐
- 生成规范的设计文档，存入
docs/superpowers/specs/ - 等你确认方案，才允许进入写计划阶段
这套流程解决的痛点很明确：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步调试流程：
- 复现问题，收集完整日志堆栈
- 列出所有可能的根因假设
- 逐个验证假设，排除无效猜测
- 定位根源后再写修复方案
特别有一条约束：连续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核心技能串联）
- 需求描述 → 自动触发
brainstorming澄清需求、生成设计文档 - 确认设计 → 自动调用
writing-plans拆分成微任务计划 - 执行计划 →
executing-plans+TDD先写测试再编码 - 出现报错 → 自动切到
systematic-debugging进行根因排查 - 全部完成 →
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
六、使用建议
- 小型工具/脚本：只开启
brainstorming + writing-plans即可，减少Token消耗。 - 业务项目/前后端开发：建议全套4个核心技能全部打开，TDD加调试能力能大幅降低返工率。
- 团队标准化开发：额外开启
writing-skills定制企业专属编码规范。 - 大型重构/多文件改造：建议开启git隔离、并行袋里、代码评审等全套进阶技能。
