关于 using-superpowers
using-superpowers 是一项面向 Agent 的技能,规定了何时以及如何调用相关技能,并要求在响应或行动前先检查技能是否适用。
主要功能
- 01行动前检查适用技能
- 02说明技能调用要求
- 03定义指令优先级
- 04提供技能访问指引
适用场景
- 01判断任务是否适用某项技能
- 02Agent 工作时遵循技能指引
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ pcvelz/ superpowers --skill using-superpowers安装后在 Claude Code 中输入/using-superpowers确认已加载。
详细介绍
如果你是作为子 Agent 被派遣来执行特定任务,请跳过此技能。
如果你认为某项技能哪怕有 1% 的可能适用于当前任务,就绝对必须调用该技能。
如果某项技能适用于你的任务,你别无选择,必须使用它。
这不可协商,也不是可选项。你不能找理由回避。
指令优先级
Superpowers 技能优先于默认系统提示行为,但用户指令始终优先:
- 用户的明确指令(CLAUDE.md、直接请求)——最高优先级
- Superpowers 技能——在与默认系统行为冲突时优先
- 默认系统提示——最低优先级
如果 CLAUDE.md 写着“不要使用 TDD”,而技能写着“始终使用 TDD”,请遵循用户的指令。由用户做主。
如何访问技能
在 Claude Code 中: 使用 Skill 工具。调用技能后,其内容会加载并呈现给你——请直接遵循。
绝不要使用 Read 工具读取技能文件。
使用技能
规则
在回复或采取任何行动之前,先调用相关或被请求的技能。 即使只有 1% 的可能适用,也应该调用技能进行确认。
digraph skill_flow {
"User message received" [shape=doublecircle];
"About to EnterPlanMode? DON'T" [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];
"TaskCreate for each checklist item" [shape=box];
"Follow skill exactly" [shape=box];
"Respond (including clarifications)" [shape=doublecircle];
"About to EnterPlanMode? DON'T" -> "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?" -> "TaskCreate for each checklist item" [label="yes"];
"Has checklist?" -> "Follow skill exactly" [label="no"];
"TaskCreate for each checklist item" -> "Follow skill exactly";
}
警示信号
出现以下想法时,请停下来——你正在找借口:
| 想法 | 实情 |
|---|---|
| “这只是个简单的问题” | 问题也是任务。检查技能。 |
| “我需要先了解更多背景” | 检查技能必须先于澄清问题。 |
| “让我先探索代码库” | 技能会告诉你该如何探索。先检查技能。 |
| “我可以快速查看 git/文件” | 文件缺少对话上下文。检查是否有适用技能。 |
| “让我先收集信息” | 技能会告诉你如何收集信息。 |
| “这不需要正式技能” | 如果存在技能,就使用它。 |
| “我记得这个技能” | 技能会更新。请阅读当前版本。 |
| “这不算任务” | 行动就是任务。检查技能。 |
| “技能太复杂了” | 简单的事也可能变复杂。使用技能。 |
| “我先做这一件事” | 先检查,再行动。 |
| “这样很有效率” | 缺乏纪律会浪费时间。技能可以避免这种情况。 |
| “我知道这是什么意思” | 了解概念不等于使用技能。调用它。 |
技能优先级
当多项技能可能适用时,请按以下顺序使用:
- 先使用流程技能(头脑风暴、调试)——它们决定如何处理任务
- 再使用实现技能(frontend-design、mcp-builder)——它们指导执行
“我们来构建 X” → 先头脑风暴,再使用实现技能。
“修复这个 Bug” → 先调试,再使用特定领域技能。
技能类型
严格型(TDD、调试):严格遵循,不要偏离规范。
灵活型(模式):根据情况调整原则。
技能本身会说明属于哪种类型。
用户指令
指令说明做什么,而不是怎么做。“添加 X”或“修复 Y”并不意味着可以跳过工作流程。
评论
支持 Markdown