Superpowers 官方全技能详解 + 场景化组合使用指南

一、官方核心技能全解析

1. brainstorming

• 官方技能标识：brainstorming
• 触发规则：新需求/新功能描述发起、需求无明确技术方案、未进入编码阶段时，编码动作前强制自动触发；支持手动调用触发
• 适用场景：
  1. 模糊需求的技术化拆解与边界定义
  2. 架构选型、技术方案对比与风险评估
  3. 遗留系统改造的边界场景与约束梳理
  4. 协作场景下的需求假设对齐与验收标准定义
• 执行逻辑与输出规范：通过苏格拉底式结构化问答，补全需求的技术约束、边界条件、非功能性要求；输出多套可落地的技术设计方案，同步输出各方案的技术优缺点、依赖条件、风险点；形成标准化需求规格文档，作为后续开发流程的唯一输入依据，禁止未完成需求对齐的前置编码行为。
• 手动调用指令：请启用 brainstorming 技能，完成本次需求的边界梳理、技术方案输出与验收标准定义

2. dispatching-parallel-agents

• 官方技能标识：dispatching-parallel-agents
• 触发规则：writing-plans输出的任务列表中存在多个完全解耦、无依赖的独立任务时，可自动触发；支持手动调用触发
• 适用场景：
  1. 批量无耦合任务的并行开发
  2. 多模块无依赖场景的同步迭代
  3. 多环境配置、批量测试用例的并行编写
• 执行逻辑与输出规范：为每个独立任务分配上下文完全隔离的子智能体，并行执行开发任务；每个子智能体的执行过程互不干扰，任务完成后输出独立的交付内容与验证结果，确保并行执行过程中无上下文污染。
• 手动调用指令：请启用 dispatching-parallel-agents 技能，为以下无耦合任务分配独立子智能体并行开发，每个任务完成后输出独立交付内容与验证结果

3. executing-plans

• 官方技能标识：executing-plans
• 触发规则：writing-plans生成的实施计划获得人工确认后，自动触发；支持手动调用触发
• 适用场景：
  1. 有前后依赖关系的任务按序执行
  2. 需设置人工检查卡点的可控开发流程
  3. 中小型功能的分步式落地执行
• 执行逻辑与输出规范：严格按照确认后的任务清单按顺序执行，支持分批次执行与人工卡点配置；每完成一个任务自动暂停，等待人工确认后再推进下一个任务，执行过程可回溯、可调整。
• 手动调用指令：请启用 executing-plans 技能，按确认后的实施计划执行，每完成1个任务暂停，等待人工确认后执行下一个任务

4. finishing-a-development-branch

• 官方技能标识：finishing-a-development-branch
• 触发规则：所有开发任务完成、全量测试通过、代码评审完成后，自动触发；支持手动调用触发
• 适用场景：
  1. 功能开发完成后的分支收尾与归档
  2. PR/MR提交前的最终校验与标准化处理
  3. 临时开发分支的清理与工作树回收
• 执行逻辑与输出规范：自动执行全量测试回归校验，输出分支变更明细与代码修改统计；提供分支合并、PR提交、分支保留/丢弃4类标准化操作选项；自动完成开发工作树的冗余文件清理与环境回收，确保仓库目录整洁。
• 手动调用指令：请启用 finishing-a-development-branch 技能，完成本次开发的分支收尾工作，输出变更明细与标准化PR模板内容

5. receiving-code-review

• 官方技能标识：receiving-code-review
• 触发规则：接收到人工Code Review评审意见、代码托管平台PR评论内容时，自动触发；支持手动调用触发
• 适用场景：
  1. 评审意见的批量整改与代码修改
  2. PR评论线程的标准化回复与解释
  3. 规范问题、安全漏洞、优化建议的对齐整改
• 执行逻辑与输出规范：逐条解析评审意见，定位对应代码范围，完成精准整改，不修改无关业务逻辑；自动生成每条评审意见的标准化回复内容，确保修改可追溯、意见全覆盖。
• 手动调用指令：请启用 receiving-code-review 技能，逐条处理以下评审意见，整改对应代码，并生成每条意见的标准化回复内容

6. requesting-code-review

• 官方技能标识：requesting-code-review
• 触发规则：每个独立开发任务完成后、全量功能开发收尾前，自动触发；支持手动调用触发
• 适用场景：
  1. 代码提交前的自动化自查评审
  2. 代码评审检查清单的生成与校验
  3. 严重问题的前置拦截与阻断
• 执行逻辑与输出规范：对照需求规格文档与开发计划，完成代码的需求合规性、代码质量、安全性、可维护性4个维度的评审；按阻断/严重/警告/建议4个等级输出问题清单与修改方案，阻断级、严重级问题自动阻断后续开发流程。
• 手动调用指令：请启用 requesting-code-review 技能，对本次开发的代码进行全量评审，按严重级别输出问题清单与修改方案

7. subagent-driven-development

• 官方技能标识：subagent-driven-development
• 触发规则：实施计划获得人工确认后，需批量执行有弱依赖关系的任务时，自动触发；支持手动调用触发
• 适用场景：
  1. 中大型功能的全流程自主开发
  2. 需双阶段评审的高要求开发场景
  3. 低人工干预的标准化任务执行
• 执行逻辑与输出规范：为每个原子任务分配独立子智能体，每个子智能体完成任务后，自动执行双阶段评审（先校验需求合规性，再校验代码质量）；评审通过后自动推进下一个任务，支持长周期自主执行，严格贴合既定实施计划，无需求偏离与上下文污染。
• 手动调用指令：请启用 subagent-driven-development 技能，按确认后的实施计划执行，每个任务完成后自动执行双阶段评审，全部完成后汇总交付内容与测试报告

8. systematic-debugging

• 官方技能标识：systematic-debugging
• 触发规则：代码运行报错、测试用例执行失败、业务异常反馈时，自动触发；支持手动调用触发
• 适用场景：
  1. 程序异常、崩溃、偶现Bug的定位与修复
  2. 依赖冲突、配置错误、中间件异常的排查
  3. 需根因定位、非临时补丁的问题修复
• 执行逻辑与输出规范：严格遵循「复现→隔离→修复→验证」四阶段根因定位流程；先构建最小可复现用例，精准定位问题根因，针对根因完成代码修复，而非仅处理表面症状；修复完成后自动执行验证用例，同步补充防御性代码。
• 手动调用指令：请启用 systematic-debugging 技能，按四阶段流程排查以下异常，定位根因，输出修复方案、验证步骤与防御性优化建议

9. test-driven-development

• 官方技能标识：test-driven-development
• 触发规则：任何业务代码编写前，全局强制自动触发，不可跳过；支持手动调用触发
• 适用场景：
  1. 核心业务代码、公共组件、工具类的开发
  2. 旧代码重构、Bug修复的回归保障
  3. 高测试覆盖率要求的项目开发
• 执行逻辑与输出规范：严格执行「红→绿→重构」TDD闭环流程：第一步编写失败的测试用例，确认测试执行失败；第二步编写最简业务代码使测试通过；第三步在保持测试通过的前提下完成代码重构优化；自动删除测试用例编写前生成的业务代码，从机制上禁止先写代码后补测试的行为。
• 手动调用指令：请严格启用 test-driven-development 技能，遵循红-绿-重构流程开发，先输出完整测试用例，再编写业务代码

10. using-git-worktrees

• 官方技能标识：using-git-worktrees
• 触发规则：brainstorming完成、技术设计方案确认后，正式开发前自动触发；支持手动调用触发
• 适用场景：
  1. 多需求并行开发的环境隔离
  2. 线上紧急Bug修复的主干代码保护
  3. 实验性功能、技术预研的风险隔离
• 执行逻辑与输出规范：自动创建与主干分支完全隔离的Git工作树与开发分支，完成项目环境初始化、依赖安装、基线测试验证；确保不同开发任务的代码、环境完全隔离，无代码污染与互相覆盖。
• 手动调用指令：请启用 using-git-worktrees 技能，为本次开发创建独立的工作树与分支，完成环境初始化与基线测试验证

11. using-superpowers

• 官方技能标识：using-superpowers
• 触发规则：Superpowers首次安装、新用户首次使用、用户查询Superpowers能力与规则时自动触发；支持手动调用触发
• 适用场景：
  1. 新手入门的能力与使用方法查询
  2. 当前生效技能、工作流规则的查询
  3. 技能触发异常、规则不生效的排查
• 执行逻辑与输出规范：输出Superpowers的标准化使用指南、全技能介绍、触发规则与配置方法；解答使用疑问，排查技能触发异常的根因，输出配置修正方案。
• 手动调用指令：请启用 using-superpowers 技能，输出当前生效的技能列表、触发规则与基础使用方法

12. verification-before-completion

• 官方技能标识：verification-before-completion
• 触发规则：每个开发任务完成后、全量功能开发收尾前，自动触发；支持手动调用触发
• 适用场景：
  1. 功能开发完成后的需求实现完整性校验
  2. Bug修复后的效果验证与回归检查
  3. 代码合并前的全场景功能验证
• 执行逻辑与输出规范：对照需求规格文档，逐项验证功能实现的完整性；执行全量测试用例，覆盖正常流程、边界场景与异常场景；输出标准化验证报告，明确未覆盖的风险点与不符合项。
• 手动调用指令：请启用 verification-before-completion 技能，对照需求规格逐项验证本次开发的所有功能，输出完整验证报告与风险点

13. writing-plans

• 官方技能标识：writing-plans
• 触发规则：brainstorming完成、需求规格与技术方案确认后，自动触发；支持手动调用触发
• 适用场景：
  1. 需求确认后的开发任务拆解与排期
  2. 复杂功能、多文件修改、跨模块开发的任务拆分
  3. 开发任务的交付物、验证步骤的明确定义
• 执行逻辑与输出规范：将复杂需求拆解为2-5分钟可完成的原子任务，每个任务明确标注文件路径、实现内容、依赖关系、验证步骤；明确任务间的先后顺序与依赖关系，形成可评审、可调整、可追溯的标准化实施计划。
• 手动调用指令：请启用 writing-plans 技能，将确认后的需求拆解为2-5分钟的原子任务，标注每个任务的文件路径、实现内容、验证步骤与依赖关系

14. writing-skills

• 官方技能标识：writing-skills
• 触发规则：用户需要自定义Superpowers技能、修改现有技能规则时自动触发；支持手动调用触发
• 适用场景：
  1. 企业/团队私有自定义技能的开发
  2. 现有技能的规则、触发逻辑、执行流程修改
  3. 定制化技能的开发与兼容性适配
• 执行逻辑与输出规范：输出Superpowers技能开发的标准化规范、模板、测试方法与兼容性要求；指导自定义技能的开发、测试与部署，确保新技能兼容所有官方支持的AI编码平台。
• 手动调用指令：请启用 writing-skills 技能，输出自定义技能的开发规范、标准模板与测试方法

二、典型场景多技能组合应用范式

场景1：标准新功能全流程开发

• 场景定义：后端服务新增业务功能，需完成从需求到可交付代码的全流程标准化开发
• 技能组合执行链路（按执行顺序）：brainstorming → using-git-worktrees → writing-plans → subagent-driven-development → requesting-code-review → verification-before-completion → finishing-a-development-branch
• 分阶段技术执行规范：
  1. brainstorming：完成需求边界、技术选型、约束条件的梳理，输出需求规格文档与技术设计方案，完成需求确认
  2. using-git-worktrees：创建与主干隔离的开发分支与独立Git工作树，完成项目环境初始化、依赖校验与基线测试验证，确保开发环境与主干隔离
  3. writing-plans：基于确认的技术方案，拆解为2-5分钟可完成的最小原子任务，每个任务明确文件路径、实现内容、依赖关系、验证步骤，形成可执行的实施计划
  4. subagent-driven-development：为每个原子任务分配上下文隔离的子智能体，执行过程中强制绑定test-driven-development技能，每个任务完成后自动执行双阶段评审，按计划顺序推进任务执行
  5. requesting-code-review：基于需求规格与实施计划，完成全量代码的自动化评审，按等级输出问题清单与修改方案，阻断级问题禁止进入下一阶段
  6. verification-before-completion：对照需求规格文档，逐项完成功能实现完整性校验，执行全量测试用例，覆盖全场景，输出标准化验证报告
  7. finishing-a-development-branch：完成全量测试回归校验，输出分支变更明细，提供标准化操作选项，完成开发工作树的清理与归档

场景2：线上紧急Bug修复

• 场景定义：线上业务接口出现异常，需完成根因定位、代码修复与上线准备，不影响主干代码与其他业务
• 技能组合执行链路：using-git-worktrees → systematic-debugging → test-driven-development → verification-before-completion → requesting-code-review → finishing-a-development-branch
• 分阶段技术执行规范：
  1. using-git-worktrees：创建与线上主干隔离的热修复分支与独立工作树，完成对应版本的环境初始化与基线验证
  2. systematic-debugging：构建最小可复现用例，定位异常根因，输出根因分析报告与修复方案
  3. test-driven-development：先编写异常场景的复现测试用例，再完成修复代码开发，同步补充防御性代码与回归测试用例
  4. verification-before-completion：验证异常修复效果，完成全量业务场景回归测试，确保无业务影响与回归问题
  5. requesting-code-review：完成修复代码的自动化评审，校验无副作用、符合线上安全规范
  6. finishing-a-development-branch：输出热修复变更明细，生成紧急PR模板，完成分支收尾与归档

场景3：批量无耦合任务并行开发

• 场景定义：项目需开发多个完全解耦的独立工具类/组件，无业务依赖与执行顺序要求
• 技能组合执行链路：brainstorming → writing-plans → dispatching-parallel-agents → test-driven-development → requesting-code-review → verification-before-completion → finishing-a-development-branch
• 分阶段技术执行规范：
  1. brainstorming：完成每个独立组件的需求边界、接口规范、约束条件定义，输出统一的设计规范与验收标准
  2. writing-plans：将每个组件拆解为独立的无耦合任务，明确每个任务的交付标准、接口规范、验证步骤
  3. dispatching-parallel-agents：为每个独立任务分配上下文隔离的子智能体，并行执行开发任务
  4. test-driven-development：每个子智能体执行任务时，强制遵循TDD流程，先编写测试用例，再完成代码开发
  5. requesting-code-review：每个任务完成后自动执行代码评审，校验符合统一设计规范，输出问题清单与整改方案
  6. verification-before-completion：完成每个组件的功能验证与全量测试，输出统一的验证报告
  7. finishing-a-development-branch：汇总所有组件的交付内容，输出变更明细，完成分支收尾

场景4：PR评审意见批量整改

• 场景定义：代码PR收到多维度评审意见，需完成逐条整改、验证与PR更新
• 技能组合执行链路：receiving-code-review → test-driven-development → verification-before-completion → requesting-code-review → finishing-a-development-branch
• 分阶段技术执行规范：
  1. receiving-code-review：逐条解析评审意见，完成对应代码的精准整改，生成每条意见的标准化回复内容
  2. test-driven-development：为整改的边界场景、逻辑修改补充对应的测试用例，确保整改可验证
  3. verification-before-completion：完成整改内容的功能验证，执行全量回归测试，确保无回归问题
  4. requesting-code-review：自查整改内容是否全覆盖所有评审意见，校验无额外问题
  5. finishing-a-development-branch：更新PR内容，生成整改说明文档，完成分支更新与归档

场景5：核心业务代码重构

• 场景定义：核心业务逻辑重构，优化代码结构与性能，不改变原有业务行为
• 技能组合执行链路：brainstorming → using-git-worktrees → writing-plans → test-driven-development → systematic-debugging → requesting-code-review → verification-before-completion → finishing-a-development-branch
• 分阶段技术执行规范：
  1. brainstorming：明确重构范围、边界约束、性能目标、回滚方案，输出重构技术方案与不变更业务行为的核心约束规则
  2. using-git-worktrees：创建独立的重构开发分支与工作树，隔离重构代码与主干代码
  3. writing-plans：拆解重构任务为原子步骤，明确每个步骤的重构范围、验证标准、不修改的业务逻辑边界
  4. test-driven-development：先补充全量业务场景的回归测试用例，确保原有业务行为可被完整校验，再按计划执行重构
  5. systematic-debugging：针对重构过程中出现的测试不通过问题，执行四阶段根因定位，确保无业务行为变更
  6. requesting-code-review：完成重构代码的全量评审，校验符合重构方案、无业务逻辑修改
  7. verification-before-completion：执行全量回归测试，校验业务行为一致性与性能目标达成情况，输出验证报告
  8. finishing-a-development-branch：输出重构变更明细，生成PR内容，完成分支收尾与归档

场景6：多需求并行开发

• 场景定义：多个独立需求同步开发，需求间无业务依赖，需分别交付、独立上线
• 技能组合执行链路：brainstorming → using-git-worktrees → writing-plans → dispatching-parallel-agents → （单需求独立执行test-driven-development+requesting-code-review+verification-before-completion） → finishing-a-development-branch
• 分阶段技术执行规范：
  1. brainstorming：完成每个独立需求的边界梳理、技术方案设计与验收标准定义，输出每个需求的独立需求规格文档
  2. using-git-worktrees：为每个需求分别创建独立的开发分支与Git工作树，确保需求间完全隔离、互不影响
  3. writing-plans：为每个需求分别拆解原子开发任务，明确每个任务的执行标准与验证步骤
  4. dispatching-parallel-agents：为每个需求分配独立的子智能体，并行执行开发流程
  5. 单需求独立执行流程：每个子智能体按计划完成开发，同步执行test-driven-development、requesting-code-review、verification-before-completion，完成单需求的开发、测试与评审
  6. finishing-a-development-branch：汇总每个需求的交付内容，分别输出每个需求的变更明细、PR模板，完成各分支的独立收尾与归档