Agent Skills
› obra/superpowers
obra/superpowers
GitHub在创建新功能或执行任何创造性工作前，通过开放式提问澄清用户真实意图、目标和约束，确保理解‘为什么’再做设计。
Install All Skills
npx skills add obra/superpowers --all -g -y
Skills in Collection (15)
在创建新功能或执行任何创造性工作前，通过开放式提问澄清用户真实意图、目标和约束，确保理解‘为什么’再做设计。
需要规划新功能
构建组件
添加功能
修改行为
策划非软件类创意项目
npx skills add obra/superpowers --skill brainstorming -g -y
用于分析 Superpowers 会话故障，通过读取转录记录定位问题（如重复工作、耗时过长），生成带证据的报告或提交 Bug 报告。
Superpowers 会话出现异常或结果不佳
用户需要构建并提交 Bug 报告
npx skills add obra/superpowers --skill diagnosing-superpowers -g -y
指导在多任务并行处理时，将独立问题分派给专用代理并发执行。通过隔离上下文和精确指令，提升多故障排查与修复效率，避免串行等待和资源浪费。
多个相互独立的测试失败或子系统故障
需要同时处理多个无共享状态的独立任务
npx skills add obra/superpowers --skill dispatching-parallel-agents -g -y
指导 Agent 以 inline 模式直接执行实现计划，逐任务完成开发并通过 TDD 验证，最终进行整体代码审查。适用于无子代理或选择内联执行的场景，强调持续执行与决策记录。
用户选择内联执行模式
无子代理工具可用时
npx skills add obra/superpowers --skill executing-plans -g -y
用于在开发分支实现完成且测试通过后，辅助开发者验证环境、确定基础分支，并提供合并、创建PR或保留分支等集成选项，最终执行选择并清理工作区。
开发分支功能实现完毕
所有测试通过需要决定集成方式
npx skills add obra/superpowers --skill finishing-a-development-branch -g -y
指导Agent在接收代码审查反馈时，遵循验证优先原则。要求先理解并核实建议的技术合理性，拒绝盲目执行或表演性回复。针对模糊反馈需澄清，对不合理建议进行技术反驳，并按优先级有序实施修复。
收到代码审查意见
需要评估外部评审建议的合理性
npx skills add obra/superpowers --skill receiving-code-review -g -y
指导在完成任务、实现大功能或合并前，通过分发子代理进行代码审查。强调提供精准上下文而非会话历史，并规定处理反馈及常见误区应对策略。
完成子代理驱动开发中的任务后
实现重大功能后
合并到主分支前
npx skills add obra/superpowers --skill requesting-code-review -g -y
一种通过为每个独立任务分派全新子代理、执行后审查及最终全分支审查来高效实施开发计划的技能。强调隔离上下文、持续执行与自主裁决，旨在提升代码质量与迭代速度。
存在包含多个独立任务的实现计划
需要并行或串行处理解耦的开发任务
npx skills add obra/superpowers --skill subagent-driven-development -g -y
提供系统化调试方法论，强调先查明根本原因再修复。涵盖错误分析、复现、变更检查及多组件诊断，防止盲目修补，适用于各类技术故障排查。
遇到任何Bug或测试失败
出现意外行为或性能问题
尝试修复前需确定根因
npx skills add obra/superpowers --skill systematic-debugging -g -y
遵循TDD原则，先写失败测试再实现代码。涵盖红绿重构流程，强制验证测试失败与通过，禁止无测试生产代码，确保功能正确性。
实现新功能
修复Bug
重构代码
npx skills add obra/superpowers --skill test-driven-development -g -y
用于在开始新功能开发前自动检测并创建隔离的 Git 工作区，优先使用原生工具，否则回退到 git worktree 命令，确保当前分支不受干扰。
需要隔离的工作区环境
执行实现计划前的准备
npx skills add obra/superpowers --skill using-git-worktrees -g -y
定义AI Agent在启动对话或执行任何任务前必须优先检查并调用相关Skill的强制规则，确保行为规范化。
用户发起新的对话请求
Agent准备进行代码探索、文件检查或澄清提问前
npx skills add obra/superpowers --skill using-superpowers -g -y
规定在宣称工作完成或修复前，必须先运行验证命令并获取证据。禁止仅凭推测、信心或代理报告就断言成功，确保所有结论都有实测输出支持，防止虚假完成声明。
准备提交代码或创建PR前
宣称测试通过或构建成功时
声称Bug已修复时
npx skills add obra/superpowers --skill verification-before-completion -g -y
用于将需求规范转化为可执行的开发计划。指导如何拆解任务、设计文件结构及细化步骤，确保每步独立可测，辅助未接触代码的工程师高效实现功能。
收到多步骤任务的规格说明或需求文档
准备进行新功能开发前需制定实施计划
npx skills add obra/superpowers --skill writing-plans -g -y
将TDD应用于技能文档编写，通过红绿重构循环验证Agent行为。用于创建、编辑和验证SKILL.md，确保Agent在部署前正确遵循规范。
创建新的Agent技能
编辑现有技能文档
验证技能在部署前的有效性
npx skills add obra/superpowers --skill writing-skills -g -y
