superpowers 技能说明文档

Superpowers 是一套内置于 Claude Code 的技能体系，用于规范和提升开发工作流。以下按使用阶段分类说明。

一、规划阶段

1. brainstorming（头脑风暴）

触发时机：任何创造性工作之前——新增功能、构建组件、添加行为或修改已有逻辑。

作用：在写代码之前，先探索用户意图、需求和设计方案，确保方向正确再动手。

2. writing-plans（编写计划）

触发时机：拿到需求或规格说明后，在动手写代码之前。

作用：将多步骤任务分解为可执行的实现计划，明确涉及的文件、步骤和架构决策。

二、开发阶段

3. test-driven-development（测试驱动开发）

触发时机：实现任何功能或修复 Bug 之前。

作用：强制先写测试再写实现代码，遵循”红灯 → 绿灯 → 重构”的 TDD 循环。

4. subagent-driven-development（子代理驱动开发）

触发时机：执行实现计划中可并行的独立任务时。

作用：将实现计划中的独立任务分派给多个子代理并行执行，加快开发速度。

5. dispatching-parallel-agents（并行代理调度）

触发时机：面对 2 个以上互不依赖、可同时进行的独立任务。

作用：将无共享状态的独立工作并行分发给多个代理，最大化效率。

6. using-git-worktrees（Git 工作树隔离）

触发时机：开始需要与当前工作区隔离的功能开发时，或执行实现计划之前。

作用：创建独立的 Git 工作树，确保功能开发不影响主工作区，支持多分支并行开发。

三、验证阶段

7. verification-before-completion（完成前验证）

触发时机：声称工作”完成””修复””通过”之前，或提交/创建 PR 之前。

作用：强制执行验证命令并确认输出，做到”先拿证据再下结论”，防止未经验证的声明。

8. systematic-debugging（系统化调试）

触发时机：遇到任何 Bug、测试失败或非预期行为时，在提出修复方案之前。

作用：采用系统化的调试方法论——先复现、再定位根因、最后修复，避免盲目猜测。

9. requesting-code-review（请求代码审查）

触发时机：完成任务、实现主要功能、或合并代码之前。

作用：将代码提交给审查代理，验证实现是否符合需求，发现潜在问题。

10. receiving-code-review（接收代码审查反馈）

触发时机：收到代码审查反馈后，在实施建议之前。

作用：对审查意见进行技术严谨性验证，避免盲目接受或敷衍了事。

四、收尾阶段

11. finishing-a-development-branch（完成开发分支）

触发时机：实现完成、所有测试通过后，需要决定如何整合代码时。

作用：提供结构化的收尾选项——合并、创建 PR、或清理分支，确保代码妥善落地。

12. executing-plans（执行计划）

触发时机：有已编写好的实现计划，需要在独立会话中分步执行时。

作用：按照计划分步执行，在检查点进行审查，确保实施与设计一致。

五、Meta 技能

13. using-superpowers（使用超级能力）

触发时机：每次对话开始时自动触发。

作用：教会 Claude 如何发现和使用所有技能，确保不会遗漏可用的能力。

14. writing-skills（编写技能）

触发时机：创建新技能、编辑现有技能、或部署前验证技能时。

作用：指导技能文件的编写、组织和验证，确保技能符合规范、可正常工作。

15. simplify（代码简化）

触发时机：代码变更完成后。

作用：审查变更代码的复用性、质量和效率，发现并修复冗余或过度设计。

技能优先级规则

当多个技能可能适用时，按以下顺序使用：

流程技能优先（如 brainstorming、debugging）—— 决定怎么做事

实现技能其次（如 TDD、subagent）—— 指导具体执行

红牌警示

以下想法说明你需要立即检查是否遗漏了技能：

想法 现实

“这只是个简单问题” 问题也是任务，先检查技能

“我先探索一下代码库” 技能会告诉你怎么探索

“这不需要正式的技能” 有技能就用，不要自己判断

“我记得这个技能的内容” 技能会更新，请读最新版本

生成日期：2026-05-09