superpowers技能概览

4 阅读3分钟

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 工具加载最新版本                                                 

  - 简单任务也要检查:即使只是简单问题,也要检查是否有适用技能