关于 using-superpowers
using-superpowers 是一个 agent 技能,要求 AI Agent 在开始任何响应或操作前先检查并调用适用的技能。它适用于使用 Superpowers 技能体系的 Agent,并说明了技能优先级与平台适配的参考文件。
主要功能
- 01执行前检查适用技能
- 02技能优先级规则
- 03常见合理化借口对照表
- 04按平台读取参考文件
适用场景
- 01让 Agent 在编码任务前先查找相关流程技能
- 02统一多平台 Agent 的技能调用行为
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ obra/ superpowers --skill using-superpowers安装后在 Claude Code 中输入/using-superpowers确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/antigravity-tools.mdclaude-code-tools.mdcodex-tools.mdgemini-tools.mdhermes-tools.mdmuse-tools.mdpi-tools.md详细介绍
如果你是作为子 Agent 被派遣执行特定任务的,请忽略本技能。
如果你认为某项技能有哪怕 1% 的可能适用于当前工作,你绝对必须调用该技能。
如果某项技能适用于你的任务,你就没有选择余地,必须使用它。
这一点没有商量余地,你不能为自己找理由绕过它。
规则
在进行任何回复或操作之前调用相关或被请求的技能,包括澄清性问题、探索代码库或检查文件。如果事后发现它不适用于当前情况,你可以不使用它。
进入计划模式之前: 如果你还没有进行头脑风暴,请先调用头脑风暴技能。
然后宣布“Using [skill] to [purpose]”,并严格遵循该技能。如果技能包含检查清单,请为每一项创建一个待办事项。
技能优先级
当多个技能同时适用时,流程类技能优先。它们先确定方法,然后由实现类技能(如 frontend-design 等)来执行。头脑风暴(brainstorming)和系统化调试(systematic-debugging)是 Superpowers 中最常用的流程类技能,但该规则适用于任何流程类技能。
- “构建 X”→ 先使用 superpowers:brainstorming,再使用实现类技能。
- “修复这个 bug”→ 先使用 superpowers:systematic-debugging,再使用领域类技能。
危险信号
出现以下想法时应立即停止,这说明你正在找理由绕过流程:
| 想法 | 实际情况 |
|---|---|
| “这只是个简单问题” | 提问也是任务。先检查是否有适用的技能。 |
| “我需要先获取更多上下文” | 技能检查要先于澄清性问题。 |
| “我先探索一下代码库” | 技能会告诉你如何探索。先检查。 |
| “我可以快速检查一下 git/文件” | 文件缺少对话上下文。先检查是否有适用的技能。 |
| “我先收集一些信息” | 技能会告诉你如何收集信息。 |
| “这不需要正式的技能” | 只要存在适用的技能,就使用它。 |
| “我记得这个技能” | 技能会不断演进。请阅读当前版本。 |
| “这不算任务” | 操作即任务。先检查是否有适用的技能。 |
| “这个技能有点大材小用” | 简单的事情也可能变复杂。使用它。 |
| “我先做这一件事” | 在做任何事情之前先检查。 |
| “这感觉很有效率” | 缺乏纪律的行动会浪费时间。技能可以防止这种情况。 |
| “我知道这是什么意思” | 了解概念不等于使用了技能。请调用它。 |
平台适配
如果你的运行环境出现在下列列表中,请阅读对应的参考文件以获取特殊说明:
- Claude Code:
references/claude-code-tools.md - Codex:
references/codex-tools.md - Pi:
references/pi-tools.md - Antigravity:
references/antigravity-tools.md - Hermes Agent:
references/hermes-tools.md - Muse:
references/muse-tools.md
用户指令
用户指令(CLAUDE.md、AGENTS.md、GEMINI.md 等,以及用户的直接请求)优先于技能,技能又优先于默认行为。只有当你的人类搭档明确告知你跳过时,才可以跳过技能流程或指令。
评论
支持 Markdown