using-superpowers

using-superpowers

热门

在任何对话开始时使用——建立如何查找和使用技能,要求在包括澄清问题在内的任何回复之前调用 Skill 工具

23万Star
2.2万Fork
更新于 2026/5/4
SKILL.md
readonly只读
name
using-superpowers
description

在任何对话开始时使用——建立如何查找和使用技能,要求在包括澄清问题在内的任何回复之前调用 Skill 工具

<SUBAGENT-STOP>
如果你作为子代理被派去执行特定任务,请跳过此技能。
</SUBAGENT-STOP>

<EXTREMELY-IMPORTANT>
如果你认为即使只有 1% 的可能性某个技能适用于你正在做的事情,你也绝对必须调用该技能。

如果某个技能适用于你的任务,你没有选择。你必须使用它。

这是不可协商的。这不是可选的。你不能找理由逃避。
</EXTREMELY-IMPORTANT>

指令优先级

超级技能覆盖默认系统提示行为,但用户指令始终优先

  1. 用户的明确指令CLAUDE.mdGEMINI.mdAGENTS.md、直接请求)——最高优先级
  2. 超级技能——在冲突时覆盖默认系统行为
  3. 默认系统提示——最低优先级

如果 CLAUDE.mdGEMINI.mdAGENTS.md 说“不要使用 TDD”,而某个技能说“始终使用 TDD”,请遵循用户的指令。用户是控制者。

如何访问技能

在 Claude Code 中: 使用 Skill 工具。当你调用一个技能时,其内容会被加载并呈现给你——直接遵循它。切勿使用 Read 工具读取技能文件。

在 Copilot CLI 中: 使用 skill 工具。技能会自动从已安装的插件中发现。skill 工具与 Claude Code 的 Skill 工具工作方式相同。

在 Gemini CLI 中: 技能通过 activate_skill 工具激活。Gemini 在会话启动时加载技能元数据,并在需要时激活完整内容。

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

平台适配

技能使用 Claude Code 的工具名称。非 CC 平台:请参阅 references/copilot-tools.md(Copilot CLI)、references/codex-tools.md(Codex)获取工具对应关系。Gemini CLI 用户通过 GEMINI.md 自动加载工具映射。

使用技能

规则

在任何回复或操作之前调用相关或请求的技能。 即使只有 1% 的可能性某个技能适用,你也应该调用该技能进行检查。如果调用的技能最终不适用于当前情况,则无需使用它。

digraph skill_flow {
    "收到用户消息" [shape=doublecircle];
    "即将进入计划模式?" [shape=doublecircle];
    "已经进行过头脑风暴?" [shape=diamond];
    "调用头脑风暴技能" [shape=box];
    "可能有技能适用?" [shape=diamond];
    "调用 Skill 工具" [shape=box];
    "宣布:'使用 [技能] 来 [目的]'" [shape=box];
    "有检查清单?" [shape=diamond];
    "为每个项目创建 TodoWrite 待办" [shape=box];
    "精确遵循技能" [shape=box];
    "回复(包括澄清)" [shape=doublecircle];

    "即将进入计划模式?" -> "已经进行过头脑风暴?";
    "已经进行过头脑风暴?" -> "调用头脑风暴技能" [label="否"];
    "已经进行过头脑风暴?" -> "可能有技能适用?" [label="是"];
    "调用头脑风暴技能" -> "可能有技能适用?";

    "收到用户消息" -> "可能有技能适用?";
    "可能有技能适用?" -> "调用 Skill 工具" [label="是,即使只有 1%"];
    "可能有技能适用?" -> "回复(包括澄清)" [label="绝对不适用"];
    "调用 Skill 工具" -> "宣布:'使用 [技能] 来 [目的]'";
    "宣布:'使用 [技能] 来 [目的]'" -> "有检查清单?";
    "有检查清单?" -> "为每个项目创建 TodoWrite 待办" [label="是"];
    "有检查清单?" -> "精确遵循技能" [label="否"];
    "为每个项目创建 TodoWrite 待办" -> "精确遵循技能";
}

危险信号

这些想法意味着停止——你在找理由:

想法 现实
“这只是一个简单的问题” 问题也是任务。检查是否有技能。
“我需要更多上下文” 技能检查在澄清问题之前。
“让我先探索代码库” 技能告诉你如何探索。先检查。
“我可以快速检查 git/文件” 文件缺乏对话上下文。检查是否有技能。
“让我先收集信息” 技能告诉你如何收集信息。
“这不需要正式技能” 如果技能存在,就使用它。
“我记得这个技能” 技能会演变。阅读当前版本。
“这不算是任务” 行动 = 任务。检查是否有技能。
“这个技能杀鸡用牛刀” 简单的事情会变得复杂。使用它。
“我先做这一件事” 在做任何事情之前先检查。
“这感觉很高效” 无纪律的行动浪费时间。技能可以防止这一点。
“我知道那是什么意思” 知道概念 ≠ 使用技能。调用它。

技能优先级

当多个技能可能适用时,按此顺序使用:

  1. 先处理流程技能(头脑风暴、调试)——这些决定如何完成任务
  2. 再处理实现技能(前端设计、mcp-builder)——这些指导执行

“我们来构建 X” → 先头脑风暴,然后实现技能。
“修复这个 bug” → 先调试,然后领域特定技能。

技能类型

刚性(TDD、调试):精确遵循。不要调整以逃避纪律。

柔性(模式):根据上下文调整原则。

技能本身会告诉你属于哪种类型。

用户指令

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