SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场using-superpowers

using-superpowers

智能体与模型

查看项目

更新于 10-16 15:20

技能介绍

using-superpowers 是一个用于指导 AI 编码助手正确使用「技能」（skills）体系的元技能，属于 zed-industries/superpowers 项目。它的定位不是完成某个具体业务任务，而是建立一条基础工作纪律：在任何对话开始时，如何发现、调用并遵循适用的技能。按其描述，该技能应在「开始任何对话」时使用，并且要求在给出任何响应（包括澄清性问题）之前，先调用 Skill 工具。

【核心原则】 该技能主张：如果某项技能适用于当前任务，执行者没有选择余地，必须使用它。这一要求被描述为不可协商、不可选、不可通过自我辩解绕过。

【指令优先级】 技能规定了三层优先级：

  1. 用户的显式指令（CLAUDE.md、GEMINI.md、AGENTS.md、直接请求）——最高优先级。
  2. Superpowers 技能——在冲突时覆盖默认系统行为。
  3. 默认系统提示词——最低优先级。 举例说明：如果 CLAUDE.md、GEMINI.md 或 AGENTS.md 写明「不要使用 TDD」，而某个技能要求「始终使用 TDD」，则应遵循用户指令，因为控制权在用户手中。

【如何访问技能】

  • Claude Code：使用 Skill 工具。调用技能后，其内容会被加载并呈现，直接遵循即可。不要用 Read 工具读取技能文件。
  • Copilot CLI：使用 skill 工具。技能会从已安装插件中自动发现，其工作方式与 Claude Code 的 Skill 工具相同。
  • Gemini CLI：技能通过 activate_skill 工具激活。Gemini 在会话开始时加载技能元数据，并按需激活完整内容。
  • 其他环境：查阅所在平台的文档，了解技能如何加载。

【平台适配】 技能使用 Claude Code 的工具名称。非 Claude Code 平台可参考工具等价映射：references/copilot-tools.md（对应 Copilot CLI）、references/codex-tools.md（对应 Codex）。Gemini CLI 用户会通过 GEMINI.md 自动加载工具映射。

【使用规则】 在任何响应或动作之前，调用相关或被请求的技能。即使某项技能只有 1% 的可能性适用，也应调用该技能以进行检查。如果调用后发现该技能不适用于当前情况，则不必使用它。

资料中给出了一个技能调用流程的有向图说明，大致环节包括：收到用户消息后判断是否可能适用任何技能；若适用则调用 Skill 工具；接着宣布「Using [skill] to [purpose]」；检查该技能是否含清单；若有清单则用 TodoWrite 为每一项创建待办；然后严格遵循技能执行；最后再响应（包括澄清）。此外，若即将进入 PlanMode，则先检查是否已进行头脑风暴，若未进行则先调用头脑风暴技能。

【需要警惕的自我合理化】 技能列出了一组「危险信号」想法及其对应的现实情况，用以阻止执行者绕过技能检查，例如：

  • 「这只是个简单问题」——问题是任务，应检查技能。
  • 「我需要先获取更多上下文」——技能检查先于澄清性提问。
  • 「让我先探索代码库」——技能会告诉你如何探索，应先检查。
  • 「我可以快速查看 git/文件」——文件缺少对话上下文，应检查技能。
  • 「让我先收集信息」——技能会告诉你如何收集信息。
  • 「这不需要正式技能」——如果存在技能，就使用它。
  • 「我记得这个技能」——技能会演进，应读取当前版本。
  • 「这不算任务」——动作即任务，应检查技能。
  • 「这个技能是大材小用」——简单的事会变复杂，仍应使用。
  • 「我先只做这一件事」——做任何事之前先检查。
  • 「这感觉很有效率」——缺乏纪律的行动浪费时间，技能可以避免这一点。
  • 「我知道那是什么意思」——知道概念不等于使用技能，应调用它。

【技能优先级】 当多个技能可能适用时，按以下顺序：

  1. 流程类技能优先（如 brainstorming、debugging）——它们决定如何着手任务。
  2. 实现类技能其次（如 frontend-design、mcp-builder）——它们指导执行。 示例：「Let's build X」应先进行 brainstorming，再使用实现类技能；「Fix this bug」应先 debugging，再使用领域相关技能。

【技能类型】

  • 刚性技能（如 TDD、debugging）：严格遵循，不得以变通方式放弃纪律。
  • 柔性技能（如 patterns）：将原则适配到具体情境。 技能本身会说明它属于哪一类。

【用户指令的边界】 用户指令说明的是「做什么」（WHAT），而不是「怎么做」（HOW）。「Add X」或「Fix Y」并不意味着要跳过工作流程。

【限制与暂未提供信息】 资料未提供该技能的安装命令、版本号、收费情况、具体价格、平台支持矩阵或性能效果数据，暂未提供。适用平台以资料中列出的 Claude Code、Copilot CLI、Gemini CLI 及其他环境说明为准。