using-superpowers

如果你是作为子 Agent 被派遣来执行特定任务，请跳过此技能。 如果你认为某项技能有哪怕 1% 的可能适用于当前任务，就绝对必须调用该技能。

如果某项技能适用于你的任务，你别无选择，必须使用它。

这不是可以协商的事项，也不是可选项。你不能为自己找理由而不使用它。

指令优先级

Superpowers 技能优先于默认系统提示行为，但用户指令始终优先：

1. 用户的明确指令（CLAUDE.md、GEMINI.md、AGENTS.md、直接请求）——最高优先级
2. Superpowers 技能——在与默认系统行为冲突时优先
3. 默认系统提示——最低优先级

如果 CLAUDE.md、GEMINI.md 或 AGENTS.md 写明“不要使用 TDD”，而某项技能要求“始终使用 TDD”，请遵循用户指令。用户拥有决定权。

如何访问技能

切勿使用文件工具手动读取技能文件——始终使用你所在平台的技能加载机制，以便正确激活技能。

在 Claude Code 中： 使用 Skill 工具。调用技能后，其内容会加载并呈现给你——请直接遵循。

在 Codex 中： 技能会原生加载。遵循技能激活时呈现的指示。

在 Copilot CLI 中： 使用 skill 工具。技能会从已安装的插件中自动发现。

在 Gemini CLI 中： 使用 activate_skill 工具。Gemini 会在会话开始时加载技能元数据，并按需激活完整内容。

在其他环境中： 查看你所在平台的文档，了解如何加载技能。

平台适配

技能会以操作描述（例如“派遣子 Agent”“创建待办事项”“读取文件”）来说明步骤，而不会指定某个运行时工具。有关各平台对应工具和指令文件约定的信息，请参阅 claude-code-tools.md、codex-tools.md、copilot-tools.md、gemini-tools.md、pi-tools.md 和 antigravity-tools.md。Gemini CLI 用户会通过 GEMINI.md 自动加载工具映射。

使用技能

规则

在作出任何回应或采取任何行动之前，先调用相关技能或用户要求的技能。 即使某项技能适用的可能性只有 1%，也应该先调用它进行确认。如果调用后发现该技能不适用于当前情况，则无需使用。

digraph skill_flow {
    "User message received" [shape=doublecircle];
    "About to enter plan mode?" [shape=doublecircle];
    "Already brainstormed?" [shape=diamond];
    "Invoke brainstorming skill" [shape=box];
    "Might any skill apply?" [shape=diamond];
    "Invoke the skill" [shape=box];
    "Announce: 'Using [skill] to [purpose]'" [shape=box];
    "Has checklist?" [shape=diamond];
    "Create a todo per item" [shape=box];
    "Follow skill exactly" [shape=box];
    "Respond (including clarifications)" [shape=doublecircle];

    "About to enter plan mode?" -> "Already brainstormed?";
    "Already brainstormed?" -> "Invoke brainstorming skill" [label="no"];
    "Already brainstormed?" -> "Might any skill apply?" [label="yes"];
    "Invoke brainstorming skill" -> "Might any skill apply?";

    "User message received" -> "Might any skill apply?";
    "Might any skill apply?" -> "Invoke the skill" [label="yes, even 1%"];
    "Might any skill apply?" -> "Respond (including clarifications)" [label="definitely not"];
    "Invoke the skill" -> "Announce: 'Using [skill] to [purpose]'";
    "Announce: 'Using [skill] to [purpose]'" -> "Has checklist?";
    "Has checklist?" -> "Create a todo per item" [label="yes"];
    "Has checklist?" -> "Follow skill exactly" [label="no"];
    "Create a todo per item" -> "Follow skill exactly";
}

危险信号

出现以下想法时，必须停下来——你是在为自己找理由：

想法	事实
“这只是个简单问题”	问题也是任务。先检查是否有适用技能。
“我需要先了解更多背景”	检查技能要先于提出澄清问题。
“让我先探索代码库”	技能会告诉你如何探索。先检查技能。
“我可以快速查看 git/文件”	文件中没有对话上下文。先检查技能。
“让我先收集信息”	技能会告诉你如何收集信息。
“这不需要正式技能”	如果有技能，就使用它。
“我记得这个技能”	技能会不断更新。请阅读当前版本。
“这不算任务”	行动就是任务。检查技能。
“技能太繁琐了”	简单的事情也可能变复杂。使用技能。
“我先做一件事再说”	行动之前先检查。
“这样做很有效率”	不遵循规范会浪费时间。技能可以避免这种情况。
“我知道这是什么意思”	了解概念不等于使用技能。调用技能。

技能优先级

当多个技能都可能适用时，请按以下顺序使用：

1. 先使用流程类技能（头脑风暴、系统化调试）——它们决定如何处理任务
2. 再使用实现类技能（前端设计、mcp-builder）——它们指导具体执行

“我们来构建 X” → 先头脑风暴，再使用实现类技能。 “修复这个错误” → 先系统化调试，再使用领域特定技能。

技能类型

严格型（TDD、系统化调试）：严格遵循。不要偏离规范。

灵活型（模式）：根据上下文调整原则。

技能本身会说明所属类型。

用户指令

指令说明要做什么，而不是如何做。“添加 X”或“修复 Y”并不意味着可以跳过工作流程。