superpowers 是一套以 skill 形式组织的工作流程方法论插件，核心理念是「先计划、再执行、再验证」的严谨开发习惯。它把头脑风暴、计划撰写、子 agent 编排、TDD、系统化调试、代码评审、完成前验证等环节沉淀成一系开箱即用的斜杠命令，适合在处理复杂任务时调用，避免低质量地一头扎进代码。

一、插件定位

superpowers 不是某个具体功能，而是一套「方法论脚手架」。它的价值在于把业界沉淀的良好工程实践固化成可重复执行的流程，让 AI 在面对复杂任务时不再凭直觉野蛮开干，而是按既定步骤推进。简单任务直接做即可；只有当任务较复杂、需要严谨流程时，这些 skill 才物有所值。

判断是否该用 superpowers 的标准：任务是否包含多步骤、多文件、需要先想清楚再动手？是则用，否则直接做。

二、安装与加载

通过 Claude Code 的插件市场安装，安装后需重载生效。

/plugin install superpowers@claude-plugins-official
/reload-plugins

重载成功后会提示类似「Reloaded: 1 plugin · 6 agents · 1 hook」的信息。之后所有 skill 命令即可在会话中直接调用。

三、可用 Skill 清单

插件提供以下 skill，均为斜杠命令，直接输入即可调用。

分类	命令	用途
入门	/superpowers:using-superpowers	插件总览与入门，第一次使用建议先跑这个
规划与思考	/superpowers:brainstorming	头脑风暴，把模糊需求拆成清晰思路
	/superpowers:writing-plans	把思路写成详细的实现计划文档
	/superpowers:executing-plans	按计划逐项执行
	/superpowers:finishing-a-development-branch	收尾一个开发分支
开发编排	/superpowers:subagent-driven-development	用子 agent 驱动开发，主 agent 编排多个专门子 agent
	/superpowers:dispatching-parallel-agents	并行派发多个子 agent 干活
	/superpowers:using-git-worktrees	用 git worktree 隔离工作，支持并行开发
质量基础	/superpowers:test-driven-development	TDD 流程：先写测试再写实现
	/superpowers:systematic-debugging	系统化调试，避免凭直觉乱改
评审与验证	/superpowers:requesting-code-review	请求代码评审
	/superpowers:receiving-code-review	接收并处理评审意见
	/superpowers:verification-before-completion	完成前验证，确认真的做完了
扩展	/superpowers:writing-skills	自己动手写新的 skill 扩展方法论

四、按场景推荐流程

场景一：从模糊想法到落地实现

当用户带着一个尚未清晰的需求来找你时，最忌直接开干。推荐三步走：

1. /superpowers:brainstorming — 把需求拆解、澄清边界、列出关键决策点

2. /superpowers:writing-plans — 将头脑风暴结论写成结构化实现计划

3. /superpowers:executing-plans — 按计划逐项落地

场景二：复杂改造或大范围重构

涉及多文件、多模块的改造，适合交给子 agent 编排，主 agent 负责协调而非亲力亲为。

1. /superpowers:writing-plans — 先出计划

2. /superpowers:subagent-driven-development — 主 agent 编排，子 agent 分工执行

3. /superpowers:dispatching-parallel-agents — 独立子任务并行推进

4. /superpowers:verification-before-completion — 收尾验证

场景三：排查棘手 Bug

面对难以复现或原因不明的 bug，不要凭直觉乱改，走系统化调试。

1. /superpowers:systematic-debugging — 假设—验证—定位根因

2. 修复后 /superpowers:verification-before-completion — 确认真修好了

场景四：上线前的质量把关

1. /superpowers:verification-before-completion — 自查完成度

2. /superpowers:requesting-code-review — 请评审者过一遍

3. /superpowers:receiving-code-review — 按评审意见修订

4. /superpowers:finishing-a-development-branch — 收尾分支、合并

场景五：需要隔离环境的并行开发

多人或多任务在同一仓库并行推进时，用 git worktree 隔离避免互相踩踏。

1. /superpowers:using-git-worktrees — 为每个任务建独立 worktree

2. 在各自 worktree 中执行开发流程

3. 完成后 /superpowers:finishing-a-development-branch 收尾

五、各 Skill 详解

/superpowers:using-superpowers

**定位。**插件的入门与总览命令。它会解释 superpowers 的设计哲学、各 skill 的关系，以及在不同任务规模下如何选择组合。第一次接触插件时建议先跑一遍，建立整体认知后再按需取用。

/superpowers:brainstorming

定位 需求澄清与方案探索。当需求模糊、有多种实现路径、或需要权衡取舍时调用。它会引导你把目标、约束、关键决策点、风险逐项摊开，输出一份可被后续 planning 直接消费的结论，而不是停留在泛泛讨论。

/superpowers:writing-plans

定位 把头脑风暴结论结构化成实现计划。产出包含任务拆解、依赖顺序、关键文件、验证方式的计划文档，作为 executing-plans 的输入。这一步把「想清楚」固化成可追溯的产物，是后续可复现、可审查的基础。

/superpowers:executing-plans

定位 按计划逐项落地。它会逐条推进计划项，维护进度与上下文，遇到偏差时回到计划修订而非擅自偏离。适合需要严格按既定方案推进、且中途不希望跑偏的场景。

/superpowers:subagent-driven-development

定位 主 agent 编排、子 agent 执行的开发模式。主 agent 负责拆解、派发、汇总与把关，子 agent 各自沉浸于单一职责。适合上下文较大、单一 agent 难以一手包揽的复杂任务，能显著降低单点上下文压力。

/superpowers:dispatching-parallel-agents

定位 并行派发多个子 agent。当存在多个相互独立的子任务时，与其串行等待，不如并行推进以压榨时间。该 skill 指导如何正确切分独立单元、避免共享可变状态、以及如何汇总并行结果。

/superpowers:using-git-worktrees

定位 用 git worktree 为每个任务建隔离工作区。多个任务可同时检出独立分支与目录，互不干扰，特别适合并行开发、长任务与实验性改动。完成后清理 worktree 即可，不污染主分支。

/superpowers:test-driven-development

定位 经典 TDD 循环：红—绿—重构。先写会失败的测试明确预期行为，再写最小实现使其通过，最后在不改行为的前提下重构。适合需要高置信度、行为明确的特性开发，能有效防止「实现先于需求」的跑偏。

/superpowers:systematic-debugging

定位 系统化调试方法论。面对 bug，它要求先复现、再形成假设、设计最小验证、定位根因，而非凭直觉四处改代码。每一步留痕、可回溯，避免「改到好像好了又不知道为什么」的黑箱修复。

/superpowers:requesting-code-review

定位 发起一次代码评审。它会准备评审所需的上下文（diff、意图、风险点），并以结构化方式提交，让评审者能快速进入、聚焦关键问题而非泛泛点评。

/superpowers:receiving-code-review

定位 接收与处理评审意见的流程。逐条评估评审建议，区分「必须改」「可商榷」「误判」，给出有依据的回复而非盲目全收或全拒。保证评审闭环，避免意见石沉大海。

/superpowers:verification-before-completion

定位 完成前的验证关卡。声明「做完了」之前，强制跑一遍端到端验证：功能是否真的按预期工作、边界是否覆盖、是否有遗漏。这是对抗「自以为完成」的最后一道闸门。

/superpowers:finishing-a-development-branch

定位 开发分支的收尾流程。在合并前完成清理、验证、文档与交接，确保分支以可交付状态结束，而不是半成品仓促并入主干。

/superpowers:writing-skills

定位 扩展能力。当现有 skill 不能覆盖你的工作流时，用它编写新的 skill，把团队沉淀的方法论固化成可复用命令。这是把 superpowers 从「用」升级到「造」的入口。

六、使用建议

按需调用，不必全跑 superpowers 的每个 skill 都是工具而非义务。日常简单任务直接做即可，只有当任务复杂度上来、需要严谨流程托底时再引入对应 skill。强行给每个小改动套全套流程，反而会拖慢节奏。

组合而非孤立 这些 skill 设计上前后衔接：brainstorming 的产出喂给 writing-plans，writing-plans 的产出喂给 executing-plans，executing-plans 完成后接 verification-before-completion 与代码评审。把它们当成流水线上的工位，按场景四推荐流程串起来用，效果最佳。

从 using-superpowers 起步 第一次用插件时，先跑 /superpowers:using-superpowers 建立全局认知，再针对当下任务挑选合适的入口，能少走弯路。

一句话原则：复杂任务用流程托底，简单任务直接动手；skill 是手段，把事做对才是目的。