关于 using-superpowers
using-superpowers 是一套使用 skill 的流程,要求在响应或开始任务前检查是否有适用 skill。它说明如何查找和运行 skill、声明使用情况,并跟踪清单步骤。
主要功能
- 01检查是否有适用 skill
- 02查找并运行 skill
- 03声明 skill 使用情况
- 04用待办事项跟踪清单
适用场景
- 01开始任务前检查相关 skill
- 02执行包含检查清单的 skill
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ zenobi-us/ dotfiles --skill using-superpowers安装后在 Claude Code 中输入/using-superpowers确认已加载。
详细介绍
如果某项技能适用于你的任务,你别无选择。你必须使用它。
这不是可以商量的。这不是可选项。你不能为自己找理由逃避。
开始使用技能
首次回复强制流程
在回复任何用户消息之前,你必须完成以下清单:
- 在心中列出可用技能
- 自问:“是否有任何技能符合此请求?”
- 如果有 → 使用 Skill 工具阅读并运行该技能文件
- 宣布你正在使用哪项技能
- 严格遵循该技能
未完成此清单就回复 = 自动失败。
查找技能
skill_find [topic]→ 列出相关技能skill_find debugging, other topic→ 列出调试技能和其他主题的技能skill_find marketing, -online→ 列出营销技能,但排除在线营销技能
skill_use [skill name]→ 阅读并运行指定技能skill_resource [skill name] [relative/path]→ 访问指定技能中的资源文件
关键规则
-
遵循强制工作流程。编码前先进行头脑风暴。开始任何任务前都要检查相关技能。
-
通过 Skill 工具执行技能
常见借口——如果你发现自己有以下任何想法,就说明你即将失败
如果你发现自己有以下任何想法,请停下来。你是在找借口。检查并使用相关技能。
- “这只是个简单问题” → 错。问题也是任务。检查是否有相关技能。
- “我可以快速查看 git/文件” → 错。文件不包含对话上下文。检查是否有相关技能。
- “我先收集信息” → 错。技能会告诉你如何收集信息。检查是否有相关技能。
- “这不需要正式的技能” → 错。如果存在适用于此任务的技能,就使用它。
- “我记得这个技能” → 错。技能会不断更新。运行当前版本。
- “这不算任务” → 错。只要你在采取行动,就是在执行任务。检查是否有相关技能。
- “这个技能对这件事来说太大材小用了” → 错。技能之所以存在,是因为简单的事情也会变复杂。使用它。
- “我先做这一件事” → 错。做任何事情之前都要先检查技能。
**原因:**技能记录了经过验证的方法,能节省时间并避免错误。不使用可用技能,就等于重蹈覆辙、重复已知错误。
如果存在适用于你任务的技能,你就必须使用它,否则任务会失败。
带清单的技能
如果某项技能包含清单,你必须为其中的每一项创建 TodoWrite 待办事项。
不要:
- 在心里过一遍清单
- 为了省时间而跳过创建待办事项
- 把多个项目合并成一个待办事项
- 没有实际执行就标记为完成
**原因:**不使用 TodoWrite 跟踪的清单 = 步骤会被遗漏。每次都是如此。与遗漏步骤的代价相比,这点开销微不足道。
宣布技能使用情况
使用技能之前,宣布你正在使用该技能。 “我正在使用 [Skill Name] 来 [你正在做的事情]。”
示例:
- “我正在使用头脑风暴技能来完善你的想法并形成设计。”
- “我正在使用测试驱动开发技能来实现此功能。”
**原因:**保持透明有助于人类合作伙伴了解你的处理过程,并及时发现问题。这也能确认你确实阅读了该技能。
关于这些技能
**许多技能包含严格规则(TDD、调试、验证)。**务必严格遵循。不要擅自放宽纪律。
**有些技能是灵活的模式(架构、命名)。**根据需要灵活运用核心原则。
技能本身会告诉你它属于哪种类型。
指示 ≠ 跳过工作流的许可
人类搭档的具体指示描述的是要做什么,而不是如何做。
“添加 X”“修复 Y”=目标,不是跳过头脑风暴、TDD 或 RED-GREEN-REFACTOR 的许可。
失败信号:“指示很具体” • “看起来很简单” • “工作流太繁琐”
**原因:**具体指示意味着需求明确,而这正是工作流最重要的时候。在“简单”任务上跳过流程,正是简单任务演变成复杂问题的原因。
摘要
开始任何任务时:
- 如果有相关技能 → 使用该技能
- 说明你正在使用该技能
- 按照技能说明执行
技能有检查清单? 每一项都使用 TodoWrite。
找到相关技能后,必须阅读并使用。不可选做。