mcpField
U
using-superpowers

using-superpowers

github.com/zenobi-usAgent 工作流6867 次安装1 天前更新
代码仓库

关于 using-superpowers

using-superpowers 是一套使用 skill 的流程,要求在响应或开始任务前检查是否有适用 skill。它说明如何查找和运行 skill、声明使用情况,并跟踪清单步骤。

主要功能

  1. 01检查是否有适用 skill
  2. 02查找并运行 skill
  3. 03声明 skill 使用情况
  4. 04用待办事项跟踪清单

适用场景

  1. 01开始任务前检查相关 skill
  2. 02执行包含检查清单的 skill

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/zenobi-us/dotfiles --skill using-superpowers

安装后在 Claude Code 中输入/using-superpowers确认已加载。

详细介绍

如果你认为某项技能有哪怕 1% 的可能适用于你正在做的事情,你就绝对必须阅读该技能。

如果某项技能适用于你的任务,你别无选择。你必须使用它。

这不是可以商量的。这不是可选项。你不能为自己找理由逃避。

开始使用技能

首次回复强制流程

在回复任何用户消息之前,你必须完成以下清单:

  • 在心中列出可用技能
  • 自问:“是否有任何技能符合此请求?”
  • 如果有 → 使用 Skill 工具阅读并运行该技能文件
  • 宣布你正在使用哪项技能
  • 严格遵循该技能

未完成此清单就回复 = 自动失败。

查找技能

  • skill_find [topic] → 列出相关技能
    • skill_find debugging, other topic → 列出调试技能和其他主题的技能
    • skill_find marketing, -online → 列出营销技能,但排除在线营销技能
  • skill_use [skill name] → 阅读并运行指定技能
  • skill_resource [skill name] [relative/path] → 访问指定技能中的资源文件

关键规则

  1. 遵循强制工作流程。编码前先进行头脑风暴。开始任何任务前都要检查相关技能。

  2. 通过 Skill 工具执行技能

常见借口——如果你发现自己有以下任何想法,就说明你即将失败

如果你发现自己有以下任何想法,请停下来。你是在找借口。检查并使用相关技能。

  • “这只是个简单问题” → 错。问题也是任务。检查是否有相关技能。
  • “我可以快速查看 git/文件” → 错。文件不包含对话上下文。检查是否有相关技能。
  • “我先收集信息” → 错。技能会告诉你如何收集信息。检查是否有相关技能。
  • “这不需要正式的技能” → 错。如果存在适用于此任务的技能,就使用它。
  • “我记得这个技能” → 错。技能会不断更新。运行当前版本。
  • “这不算任务” → 错。只要你在采取行动,就是在执行任务。检查是否有相关技能。
  • “这个技能对这件事来说太大材小用了” → 错。技能之所以存在,是因为简单的事情也会变复杂。使用它。
  • “我先做这一件事” → 错。做任何事情之前都要先检查技能。

**原因:**技能记录了经过验证的方法,能节省时间并避免错误。不使用可用技能,就等于重蹈覆辙、重复已知错误。

如果存在适用于你任务的技能,你就必须使用它,否则任务会失败。

带清单的技能

如果某项技能包含清单,你必须为其中的每一项创建 TodoWrite 待办事项。

不要:

  • 在心里过一遍清单
  • 为了省时间而跳过创建待办事项
  • 把多个项目合并成一个待办事项
  • 没有实际执行就标记为完成

**原因:**不使用 TodoWrite 跟踪的清单 = 步骤会被遗漏。每次都是如此。与遗漏步骤的代价相比,这点开销微不足道。

宣布技能使用情况

使用技能之前,宣布你正在使用该技能。 “我正在使用 [Skill Name] 来 [你正在做的事情]。”

示例:

  • “我正在使用头脑风暴技能来完善你的想法并形成设计。”
  • “我正在使用测试驱动开发技能来实现此功能。”

**原因:**保持透明有助于人类合作伙伴了解你的处理过程,并及时发现问题。这也能确认你确实阅读了该技能。

关于这些技能

**许多技能包含严格规则(TDD、调试、验证)。**务必严格遵循。不要擅自放宽纪律。

**有些技能是灵活的模式(架构、命名)。**根据需要灵活运用核心原则。

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

指示 ≠ 跳过工作流的许可

人类搭档的具体指示描述的是要做什么,而不是如何做。

“添加 X”“修复 Y”=目标,不是跳过头脑风暴、TDD 或 RED-GREEN-REFACTOR 的许可。

失败信号:“指示很具体” • “看起来很简单” • “工作流太繁琐”

**原因:**具体指示意味着需求明确,而这正是工作流最重要的时候。在“简单”任务上跳过流程,正是简单任务演变成复杂问题的原因。

摘要

开始任何任务时:

  1. 如果有相关技能 → 使用该技能
  2. 说明你正在使用该技能
  3. 按照技能说明执行

技能有检查清单? 每一项都使用 TodoWrite。

找到相关技能后,必须阅读并使用。不可选做。

评论

支持 Markdown