SKILL.md
<SUBAGENT-STOP> 如果你是作为 subagent 被派发来执行特定任务，跳过此技能。 </SUBAGENT-STOP>
<EXTREMELY-IMPORTANT> 如果你认为哪怕只有 1% 的可能性某个技能适用于你正在做的事，你都绝对必须调用该技能。
如果某个技能适用于你的任务，你没有选择。你必须使用它。
这没有商量余地。这不是可选项。你不能通过合理化来逃避它。 </EXTREMELY-IMPORTANT>
指令优先级
Superpowers skills 会覆盖默认 system prompt 行为，但用户指令始终优先：
- 用户的明确指令（CLAUDE.md、GEMINI.md、AGENTS.md、直接请求）— 最高优先级
- Superpowers skills — 在冲突处覆盖默认 system 行为
- 默认 system prompt — 最低优先级
如果 CLAUDE.md、GEMINI.md 或 AGENTS.md 说“不要使用 TDD”，而某个技能说“始终使用 TDD”，遵循用户指令。用户掌控全局。
如何访问技能
在 Claude Code 中： 使用 Skill tool。调用技能时，其内容会被加载并呈现给你 — 直接遵循它。绝不要对技能文件使用 Read tool。
在 Copilot CLI 中： 使用 skill tool。技能会从已安装 plugins 中自动发现。skill tool 的工作方式与 Claude Code 的 Skill tool 相同。
在 Gemini CLI 中： 技能通过 activate_skill tool 激活。Gemini 会在会话开始时加载技能元数据，并按需激活完整内容。
在其他环境中： 查看你的平台文档，了解技能如何加载。
平台适配
技能使用 Claude Code tool 名称。非 CC 平台：查看 references/copilot-tools.md（Copilot CLI）、references/codex-tools.md（Codex）了解等价 tool。Gemini CLI 用户会通过 GEMINI.md 自动加载 tool 映射。
使用技能
规则
在任何回复或行动之前调用相关或被请求的技能。 哪怕只有 1% 的可能性某个技能适用，也意味着你应该调用该技能进行检查。如果调用后发现某个技能不适合当前情况，你不需要使用它。
digraph skill_flow {
"User message received" [shape=doublecircle];
"About to EnterPlanMode?" [shape=doublecircle];
"Already brainstormed?" [shape=diamond];
"Invoke brainstorming skill" [shape=box];
"Might any skill apply?" [shape=diamond];
"Invoke Skill tool" [shape=box];
"Announce: 'Using [skill] to [purpose]'" [shape=box];
"Has checklist?" [shape=diamond];
"Create TodoWrite todo per item" [shape=box];
"Follow skill exactly" [shape=box];
"Respond (including clarifications)" [shape=doublecircle];
"About to EnterPlanMode?" -> "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 Skill tool" [label="yes, even 1%"];
"Might any skill apply?" -> "Respond (including clarifications)" [label="definitely not"];
"Invoke Skill tool" -> "Announce: 'Using [skill] to [purpose]'";
"Announce: 'Using [skill] to [purpose]'" -> "Has checklist?";
"Has checklist?" -> "Create TodoWrite todo per item" [label="yes"];
"Has checklist?" -> "Follow skill exactly" [label="no"];
"Create TodoWrite todo per item" -> "Follow skill exactly";
}危险信号
出现这些想法意味着停止 — 你正在合理化逃避：
| 想法 | 现实 |
|---|---|
| “这只是一个简单问题” | 问题也是任务。检查技能。 |
| “我需要先了解更多上下文” | 技能检查发生在澄清问题之前。 |
| “让我先探索代码库” | 技能会告诉你如何探索。先检查。 |
| “我可以快速检查 git/文件” | 文件没有对话上下文。检查技能。 |
| “让我先收集信息” | 技能会告诉你如何收集信息。 |
| “这不需要正式技能” | 如果技能存在，就使用它。 |
| “我记得这个技能” | 技能会演进。阅读当前版本。 |
| “这不算任务” | 行动 = 任务。检查技能。 |
| “这个技能太重了” | 简单事情会变复杂。使用它。 |
| “我就先做这一件事” | 做任何事之前先检查。 |
| “这感觉很有效率” | 无纪律的行动会浪费时间。技能会防止这种情况。 |
| “我知道那是什么意思” | 知道概念 ≠ 使用技能。调用它。 |
技能优先级
当多个技能可能适用时，按此顺序使用：
- 流程技能优先（brainstorming、debugging）- 它们决定如何处理任务
- 实现技能其次（frontend-design、mcp-builder）- 它们指导执行
“我们来构建 X” → 先使用 brainstorming，然后使用实现技能。 “修复这个 bug” → 先使用 debugging，然后使用领域特定技能。
技能类型
刚性（TDD、debugging）：严格遵循。不要为了适配而削弱纪律性。
灵活（patterns）：将原则适配到上下文。
技能本身会告诉你它属于哪一种。
用户指令
指令说明要做什么，而不是怎么做。“Add X”或“Fix Y”并不意味着跳过工作流。