using-superpowers

name	using-superpowers
description	每次会话开始时必须使用——建立如何查找和使用技能的方法，要求在做出任何回应（包括澄清性问题）之前先调用相关技能

如果你是作为子代理被派来执行具体任务的，请跳过此技能。 如果你认为某个技能有哪怕 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 在会话开始时加载技能元数据，并在需要时激活完整内容。

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

平台适配

技能使用动作式语言来描述操作（"派遣子代理"、"创建待办事项"、"读取文件"），而不指代任何特定运行时的工具。关于各平台工具等价物和指令文件约定，请参阅 claude-code-tools.md、codex-tools.md、copilot-tools.md、gemini-tools.md、kimi-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. 流程类技能优先（brainstorming、systematic-debugging）—— 这些决定如何着手处理任务
2. 实现类技能次之（frontend-design、mcp-builder）—— 这些指导具体执行

"让我们来构建 X" → 先使用 brainstorming，再使用实现类技能。 "修复这个 bug" → 先使用 systematic-debugging，再使用领域相关技能。

技能类型

严格型（TDD、systematic-debugging）：严格遵循，不要随意放弃其中的纪律要求。

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

技能本身会说明它属于哪种类型。

用户指令

用户指令说明的是做什么，而不是怎么做。"添加 X" 或 "修复 Y" 并不意味着可以跳过工作流程。