Using Superpowers(Superpowers 入口引导)
整套 Superpowers 方法论的启动引导 skill,规定「只要有 1% 可能相关就必须调用对应 skill」
为使用技能库的编码代理提供统一的启动发现和工作流入口,能减少遗漏相关技能的风险;适用边界主要是会话初始化和技能选择,不能证明其能改善实际实现质量。其“任何响应前必须调用技能”的规则具有明确行为价值,但可能对简单问题造成过度流程化。
规则文字较明确,并提供 Codex、Pi、Antigravity 的工具映射;但依赖宿主是否支持技能加载、子代理和任务跟踪,且对未列出的运行环境没有通用失败路径。没有该技能自身的行为测试、版本兼容矩阵、冲突技能处理细则或调用失败恢复流程,因而可重复性证据有限。
技能本身没有直接执行命令、访问凭据或外部服务的指令,且声明用户指令优先,直接红线风险未见。然而强制在任何回答和澄清前调用技能,可能导致不必要的工具或子代理活动;未定义调用前的权限确认、敏感数据边界、外部副作用审批、取消和回滚机制。关于遥测的信息只在仓库 README 中出现,并非本技能的完整安全控制。
SKILL.md、其平台参考文件和仓库测试能支持存在工具映射与文档一致性的有限判断;提供的 Antigravity 测试主要检查文档字符串和文件存在性,并非验证技能行为。缺少独立评估、端到端调用记录、失败场景测试和对性能或质量主张的可追溯证据;README 中关于方法论效果的内容应视为仓库声明而非独立事实。
名称、描述、核心规则和部分平台适配说明较易发现,用户通常无需额外输入;但缺少清晰的输入输出契约、首次安装后的验证步骤、调用失败时的排障和退出方式。不同 harness 的能力差异由参考文件部分说明,仍未覆盖所有兼容性限制、成本和技能冲突情形。
仓库提供 MIT 许可证、package.json 版本 6.1.1、贡献说明、更新说明和问题渠道,具备一定维护信号;但选定技能文件自身没有版本、变更记录、负责人或响应承诺,README 的“often automatic”更新表述不够具体。发布者在给定信息中未经过企业注册验证,因此不能据此增加治理或维护分数。
- 不要将“任何响应前必须调用技能”视为无条件授权;在触发工具、子代理、文件修改或外部操作前,应先确认宿主能力、权限和用户意图。
- 在未验证当前 harness 支持情况时,可能出现不存在的技能加载、任务跟踪或子代理能力;应准备人工或顺序执行的降级路径。
- 不要把仓库 README 的方法论效果、测试声明或平台覆盖范围当作该选定技能已经独立验证的事实。
它能做什么 & 适用场景
这是 Superpowers 整个体系的入口点,本身不做具体工作,只负责在会话一开始(以及每次上下文压缩后)建立一条硬规则:只要判断某个 skill 可能适用(哪怕只有 1% 概率),就必须先调用它,包括在做澄清提问、探查代码库这类看似「还没真正开始做事」的动作之前。文档很短(62 行),核心是一张常见「合理化借口」对照表,逐条反驳「这只是个简单问题」「我已经知道这个 skill 讲什么」这类跳过检查的心理。
规定调用顺序:多个 skill 都适用时,流程类 skill(brainstorming、systematic-debugging)先于实现类 skill;给出两个具体触发例子(「我们来做 X」→ 先用 brainstorming;「修一下这个 bug」→ 先用 systematic-debugging);列出一张「哪些想法意味着你正在找借口跳过检查」的对照表;声明用户指令(CLAUDE.md/AGENTS.md/直接要求)优先级高于 skill、skill 优先级高于默认行为,只有用户明确要求才能跳过某个 skill 或指令;针对被当作子代理派发执行具体任务时,明确豁免——不需要再走「先检查有没有相关 skill」这一层。
- 任何新会话开始时,作为强制的第一道检查——在做任何澄清提问或探索代码库之前,先判断是否有相关 skill
- 被当作子代理派发执行一个具体任务时,明确跳过这层检查(SUBAGENT-STOP 标记),避免子代理还要反过来判断「要不要用 Superpowers」
- 会话经历上下文压缩(compaction)之后重新建立这条规则,防止压缩后规则被遗忘
优缺点一览
- 把「1% 可能相关也必须用」写得非常绝对,减少了「这个不算」「我知道这个 skill」之类边界模糊的自我豁免空间
- 明确区分「作为主会话」和「作为子代理被派发执行具体任务」两种角色,避免子代理层层递归触发不必要的检查
- 清楚声明用户明确指令的优先级高于 skill 规则,留了一个合理的人工干预出口,不是完全不可协商
- 只在会自动读取和遵循 SKILL.md 指令的 harness 里可靠工作(Claude Code、Codex CLI 等);纯聊天式界面里等于一份说明文档,需要人工照做。
- 这类「强制自我检查」规则本身没有技术强制力,完全依赖模型认真执行,一旦模型选择性忽略,规则形同虚设
- 对每个动作都先过一遍「有没有相关 skill」的检查,在简单任务上会带来额外的决策开销,不是零成本的
如何安装
作为 obra/superpowers 插件的一部分安装,不能单独安装某一个 skill:
- Claude Code:官方市场
/plugin install superpowers@claude-plugins-official;或先注册 Superpowers 自建市场/plugin marketplace add obra/superpowers-marketplace,再/plugin install superpowers@superpowers-marketplace - 也支持 Antigravity、Codex App/CLI、Cursor、Factory Droid、GitHub Copilot CLI、Kimi Code、OpenCode、Pi 等 harness,具体命令见仓库 README
装好后这个 skill 会和其余 13 个 Superpowers skill 一起启用,由 using-superpowers 统一引导、按场景自动触发,无需单独调用。
如何使用
不需要手动触发,它是整个插件的引导入口,理论上每个新会话或每次压缩后都会重新生效,确保后续行为始终先检查相关 skill 再动手。
对比同类
跟没有这类引导 skill、完全依赖模型自行判断「要不要查一下有没有相关文档」相比,这个 skill 把「检查 skill」从可选动作变成强制第一步;跟系统提示里简单写一句「优先使用可用工具」相比,这里给出了具体场景示例、反例对照表和角色区分,规则密度和可操作性更高。