Superpowers 是一套面向开发过程的插件化技能系统，旨在帮助个人开发者与团队更高效地完成从需求探索到代码交付的全流程。其内置的十余项技能覆盖了软件开发生命周期的各个关键节点，并且可以按照自然的工作流顺序进行分组与调用。
本文将基于 Superpowers 技能的实际分组和排序，详细介绍每项技能的功能、适用场景以及典型的触发时机，帮助读者快速建立起对这套工具链的整体认知。
技能分组与工作流顺序
为获得最顺畅的开发体验，建议按照以下八个阶段使用相应的技能：入门、规划、环境准备、开发与执行、调试、代码审查、验证与完成、扩展。下面逐一展开。
第一阶段：入门
using-superpowers
学习如何使用 Superpowers 插件系统，包括技能启用、调用方式和工作流概览。这是新用户的起点。技能会解释 Superpowers 的核心概念、完整的技能列表、协作文档规范以及各阶段推荐的技能组合。当用户首次使用 Superpowers，或询问“如何使用 Superpowers”、“有哪些技能”时，此技能会被触发。
第二阶段：规划
brainstorming
在编写任何代码或计划之前，通过结构化头脑风暴理解需求或问题。该技能引导用户进行多角度发散思考、问题分解、替代方案对比，并记录关键假设、约束条件和风险点，最终输出清晰的探索总结。通常在开始新功能、处理模糊需求或面对多个未知方案时触发，并且应该在 writing-plans 之前使用。
writing-plans
基于头脑风暴的结果制定可执行的实施计划。计划包含任务拆解、依赖关系、验收标准和时间估算，将大目标分解为小步骤，明确每个步骤的输入输出、负责人（或代理）以及测试策略。计划通常采用 Markdown 清单格式。触发时机为完成头脑风暴后、准备进入开发阶段前，或者用户明确要求“写一个开发计划”。
第三阶段：环境准备
using-git-worktrees
利用 Git Worktree 功能为不同任务创建独立的工作目录，避免分支切换带来的上下文中断。该技能指导如何创建、管理、清理 worktree，并推荐在并行开发、代码审查、实验性修改时使用。当准备开始实施计划中的某个任务且需要与当前工作区隔离时，或者用户询问“如何同时开发多个分支”时触发。
第四阶段：开发与执行
subagent-driven-development
将计划中的子任务委托给子代理执行，主代理负责监督、集成和最终验证。技能会定义子代理的职责、接口规范、输入输出格式，适合复杂项目中的并行或隔离开发。触发条件是计划中有多个独立模块，或用户希望分工执行。
executing-plans
按计划逐步执行任务，跟踪进度，处理执行中的异常，并记录每一步的实际结果。该技能提供执行循环：读取计划，执行当前任务，验证结果，标记完成，然后进入下一项。遇到阻塞时会触发调试或重新规划。当计划已就绪且选择手动执行或由主代理直接执行时触发。
test-driven-development
严格遵循测试驱动开发循环：先写失败的测试，再写最少代码使测试通过，最后重构。该技能确保代码质量与可测试性，每一步都要求输出测试用例、实现代码和测试运行结果。当计划中包含模块级开发任务且团队或项目要求 TDD，或者用户明确要求“用 TDD 方式实现”时触发。
dispatching-parallel-agents
同时启动多个独立代理执行互不依赖的任务，并合并各自的结果。适用于任务分解后存在无依赖关系的子任务。技能包括如何定义并行单元、同步结果和处理冲突。当计划中有多个可并行的任务且系统支持多代理执行时触发。
第五阶段：调试
systematic-debugging
采用科学调试法（假设-验证-排除）定位缺陷根因，而不是随机修改代码。技能指导记录现象、复现步骤、提出假设、设计验证实验、收敛到最小复现案例，并最终修复。在执行计划或测试时遇到未预期的失败，或者用户报告 bug 时触发。
第六阶段：代码审查
requesting-code-review
主动向同伴（或审查代理）提交代码变更进行审查，提供必要的上下文、测试结果和自查清单。该技能生成格式化的审查请求，包含变更范围、设计决策、潜在风险点以及希望重点关注的部分。完成一个功能分支或重要提交、准备合并前触发。
receiving-code-review
接收并处理他人提交的代码审查意见，逐条回应、修改代码或讨论建议。该技能帮助审查者（或 AI）生成结构化的反馈，包括优先级、具体行号位置、修改建议和理由。收到审查请求时，或者用户要求“审查这段代码”时触发。
第七阶段：验证与完成
verification-before-completion
在认为工作完成前，自动或手动执行全面的验证清单，包括测试、构建、静态分析、文档更新等。该技能强制进行最终验证，避免“我以为没问题”的错误，输出验证报告以及任何未通过项。当完成所有计划任务、通过代码审查后，准备标记为完成之前触发。
finishing-a-development-branch
合并或关闭开发分支、清理 worktree、更新主分支、删除临时分支，并记录最终结果。技能遵循团队的 Git 工作流（如 GitHub Flow、Git Flow）执行合并、打标签、推送和通知，同时清理本地环境。验证通过后，准备将功能集成到主分支时触发。
第八阶段：扩展
writing-skills
创建或修改 Superpowers 的自定义技能，定义技能的名称、描述、触发条件和执行逻辑。该技能提供技能模板、最佳实践和工具函数库，让高级用户扩展系统能力。当用户需要添加新的领域专用技能，或者询问“如何创建一个新 skill”时触发。
总结
Superpowers 的技能集并不是孤立的工具，而是一条环环相扣的开发流水线。从入门指南到规划、环境准备、开发执行、调试、审查、验证、完成再到扩展，每项技能都有明确的输入输出和触发场景。团队或个人开发者可以按照上述顺序单向推进，也可以在遇到阻塞时回溯到之前的阶段（例如在 executing-plans 中遇到失败就跳转到 systematic-debugging）。通过合理应用这些技能，能够显著提升开发效率、减少沟通成本，并降低遗漏关键步骤的风险。
希望这篇指南能帮助你快速上手 Superpowers，并顺利将其融入日常工作流。
