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写出无覆盖、运行即报错的代码，自带回归保障

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

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

1. 复现问题，收集完整日志堆栈
2. 列出所有可能根因假设
3. 逐个验证假设，排除无效猜测
4. 定位根源后再写修复方案 约束：连续3次修复失败，强制触发架构评审，禁止盲目改代码

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

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隔离、并行代&理、代码评审全套进阶技能