superpowers 技能体系总览****
┌────────────────────────────────────────────┬────────────────────────┬────────────────────────────┐
│ 技能名称 │ 用途 │ 触发时机 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:using-superpowers │ 技能使用指南(本介绍) │ 每次会话开始时 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:brainstorming │ 创意工作前的头脑风暴 │ 创建功能、组件、添加功能前 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:writing-plans │ 多步骤任务的实施计划 │ 有需求后,动手编码前 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:executing-plans │ 执行已有的实施计划 │ 已有书面计划需执行时 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:test-driven-development │ 测试驱动开发 │ 实现功能或修复 bug 前 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:systematic-debugging │ 系统调试 │ 遇到 bug、测试失败时 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:verification-before-completion │ 完成前的验证检查 │ 声称工作完成前 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:requesting-code-review │ 请求代码审查 │ 完成任务或实现主要功能后 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:receiving-code-review │ 处理收到的代码审查反馈 │ 收到审查反馈后 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:finishing-a-development-branch │ 完成开发分支的收尾 │ 实现完成、测试通过后 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:using-git-worktrees │ 使用 Git 工作树隔离 │ 开始功能开发需隔离时 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:dispatching-parallel-agents │ 并行派发独立任务 │ 面临 2 个以上独立任务时 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:subagent-driven-development │ 子代理驱动开发 │ 当前会话中执行独立任务计划 │
├────────────────────────────────────────────┼────────────────────────┼────────────────────────────┤
│ superpowers:writing-skills │ 创建/编辑技能 │ 创建新技能或编辑现有技能 │
└────────────────────────────────────────────┴────────────────────────┴────────────────────────────┘
---
核心原则
强制规则:只要任务有 1% 的可能性 适用某个技能,就必须调用该技能。不可跳过、不可认为"太简单"、不可凭记忆代替。
优先级:
1. 用户明确指令(CLAUDE.md、GEMINI.md、AGENTS.md、直接请求)
2. superpowers 技能
3. 默认系统提示
执行顺序:
- 创意工作 → 先 brainstorming,再具体实现技能
- 修复 bug → 先 systematic-debugging,再领域相关技能
- 构建功能 → 先 test-driven-development,再编码
---
常用技能详解
1. brainstorming(头脑风暴)****
- 何时使用:创建功能、构建组件、添加功能或修改行为前
- 作用:探索用户意图、需求和设计,避免盲目实现
- 注意:任何创意工作前都必须使用
2. writing-plans(写计划)
- 何时使用:有需求或规格说明后,触摸代码前
- 作用:为多渠道任务制定分步实施计划
- 输出:书面实施计划
3. executing-plans(执行计划)
- 何时使用:已有书面实施计划需要执行
- 作用:在独立会话中执行计划,包含审查检查点
- 关联:常与 using-git-worktrees 配合使用
4. test-driven-development(测试驱动开发)
- 何时使用:实现任何功能或修复 bug 前
- 作用:先写测试,再写实现代码
- 刚性:必须严格遵循,不可偏离
5. systematic-debugging(系统调试)
- 何时使用:遇到 bug、测试失败或意外行为
- 作用:在提出修复前进行系统性诊断
- 刚性:必须严格遵循调试流程
6. verification-before-completion(完成前验证)
- 何时使用:声称工作完成、修复成功或测试通过前
- 作用:运行验证命令,确认输出后再做成功声明
- 原则:先有证据,后有断言
7. using-git-worktrees(Git 工作树)
- 何时使用:开始需要与当前工作区隔离的功能开发
- 作用:创建隔离的 git 工作树,智能目录选择和安全验证
---
使用方式
在 Claude Code 中,使用 Skill 工具调用:
Skill({ skill: "superpowers:brainstorming" })
---
注意事项
- 技能覆盖默认行为:superpowers 技能会覆盖默认系统提示中的冲突行为
- 用户指令始终优先:如果用户文件说"不要用 TDD",即使技能要求也必须遵从用户
- 不要凭记忆调用:技能可能已更新,每次都要通过 Skill 工具加载最新版本
- 简单任务也要检查:即使只是简单问题,也要检查是否有适用技能