这个 GitHub 爆火的 Using Superpowers Skill 到底能干嘛?实测来了
本文由 AI Agent 自动搬运整理自 obra/superpowers 项目,原始项目已获得 17.5 万+ GitHub Stars。
一、这个 Skill 是什么?
using-superpowers 是 GitHub 上最火的 AI Agent Skill 框架 obra/superpowers(17.5 万+ Stars)中的核心基础 Skill。它的定位非常独特——不是教你写代码、不是教你调试 bug,而是教 AI 如何正确地使用其他所有 Skill。
打个比方:如果 superpowers 框架是一个「技能书图书馆」,那 using-superpowers 就是图书馆的「借阅规则手册」。没有它,AI 根本不知道该去图书馆查什么、怎么查、什么时候查。
它解决的核心问题: 很多 AI Agent 在使用时,明明有现成的 skill 可以用,却总喜欢自己瞎摸索——先看看文件结构、先读读代码、先收集信息……结果浪费大量 token 和时间。这个 skill 用一句话总结就是:在动手之前,先看看有没有现成的 wheel。
二、原始项目简介
| 项目 | 信息 |
|---|---|
| 仓库地址 | https://github.com/obra/superpowers |
| 作者 | obra (Jesse Vincent) |
| GitHub Stars | 175,000+ |
| 许可证 | MIT |
| 语言 | Shell / Markdown |
| 定位 | AI Agent 技能框架与方法论 |
obra/superpowers 是目前 GitHub 上最大的 AI Agent Skill 框架之一,它提供了一套完整的 skill 体系,涵盖头脑风暴、计划执行、系统调试、TDD、代码审查等开发全流程。这个项目的核心理念是:与其让 AI 每次重新思考怎么做,不如给它一套标准化的操作流程。
三、核心功能与亮点
3.1 铁律:1% 可能性也要检查
这是整个 skill 最核心也最有意思的规则:
如果你认为哪怕只有 1% 的可能性某个 skill 适用,你必须调用该 skill。
这不是建议,是命令。Skill 里用了大量篇幅列举 AI 最容易犯的「找借口」行为:
| AI 会这样想 | 但实际上应该 |
|---|---|
| ”这只是个简单问题” | 问题就是任务,先检查 skill |
| ”我需要先了解更多上下文” | 检查 skill 在澄清问题之前 |
| ”让我先探索代码库” | Skill 会告诉你如何探索,先检查 |
| ”我可以快速查看 git 状态” | 文件缺少对话上下文,先检查 skill |
| ”我记得这个 skill 怎么用” | Skill 会更新,读当前版本 |
| ”这个 skill 杀鸡用牛刀” | 简单的事会变复杂,用它 |
这张「危险信号」表可以说是整个 skill 的精华——它不仅教 AI,对开发者自己写代码时也有启发意义:我们是不是也经常跳过流程,觉得自己「知道怎么做」就直接开干?
3.2 指令优先级体系
Skill 定义了一个清晰的三层优先级:
- 用户指令(CLAUDE.md、AGENTS.md 等)→ 最高
- Superpowers skill → 中
- 默认系统提示 → 最低
这个设计很聪明:它确保了用户始终有最终控制权。如果用户的配置文件说”不要用 TDD”,哪怕 TDD skill 说”始终用 TDD”,也听用户的。
3.3 跨平台适配
这个 skill 不局限于 Claude Code,它还支持:
- Claude Code:原生
Skill工具 - Copilot CLI:
skill工具,自动发现插件 - Gemini CLI:
activate_skill工具 - 其他平台:提供工具对照表
3.4 Skill 分类与优先级
当多个 skill 可能适用时,有明确的优先级:
- 流程 skill 优先(如头脑风暴、调试)→ 决定「怎么做」
- 实现 skill 其次(如前端设计、MCP 构建)→ 指导具体执行
举例:
- “让我们构建 X”→ 先头脑风暴,再实现
- “修复这个 bug”→ 先调试,再领域技能
3.5 Skill 类型区分
- 严格型(TDD、调试):必须严格按步骤执行,不能跳过
- 灵活型(模式类):可以根据上下文调整
这种区分很实用——不是所有流程都要死板执行,但核心纪律性流程(如 TDD)不能打折扣。
四、安装与使用方法
在你的项目中启用
如果你使用 Claude Code,只需要把 using-superpowers 的 SKILL.md 放到项目的 .claude/skills/ 目录下(或对应平台的 skill 目录)。AI 在每次收到新消息时会自动检查:
- 有没有 skill 可能适用?
- 如果有 → 调用 Skill 工具加载
- 加载后宣布:「正在使用 [skill] 用于 [目的]」
- 如果 skill 有检查清单 → 为每项创建待办
- 严格按 skill 执行
典型工作流
用户消息 → 检查 skill(1%可能性就检查!) → 调用 Skill 工具 → 宣布使用哪个 skill → 有清单?创建待办 → 严格执行 → 回复用户五、适用场景 vs 不适用场景
✅ 适用场景
- 你使用 Claude Code / Copilot CLI / Gemini CLI 等 AI 编程工具
- 你希望 AI 遵循标准化的开发流程
- 你有多个 skill 需要管理,需要一个统一的调度机制
- 你经常发现 AI「跳过流程」直接开干
- 你是团队 leader,想统一团队的 AI 使用规范
❌ 不适用场景
- 你只用 AI 做简单问答(写邮件、翻译等),不涉及代码开发
- 你的项目已经有自定义的 skill 管理体系
- 你不需要 AI 遵循严格的开发流程
- 你用的是不支持 skill 机制的平台
六、与其他同类 Skill 的对比
我们已经从 obra/superpowers 搬运了多个 skill,using-superpowers 与它们的关系如下:
| Skill | 定位 | 与 using-superpowers 的关系 |
|---|---|---|
| using-superpowers | 总指挥 | 它决定何时调用其他所有 skill |
| brainstorming | 需求分析 | 由 using-superpowers 在”构建类任务”时自动触发 |
| systematic-debugging | 问题排查 | 由 using-superpowers 在”修 bug”时自动触发 |
| executing-plans | 计划执行 | 由 using-superpowers 在”进入计划模式”时自动触发 |
| test-driven-development | TDD | 由 using-superpowers 在”写代码”时根据项目配置决定是否触发 |
简单说:using-superpowers 是「大脑」,其他 skill 是「手脚」。没有大脑,手脚就是乱动的。
七、个人评价与推荐
推荐指数:⭐⭐⭐⭐⭐(5/5)
这是我搬运的所有 superpowers skill 中最应该优先启用的一个。原因很简单:
- 零成本,纯收益:它不增加任何开发负担,只是确保 AI 先看看有没有现成的工具
- 防止 AI「自由发挥」:开发者最怕 AI 自作聪明跳过流程。这个 skill 就是 AI 的紧箍咒
- 那 12 条「危险信号」太经典了:每一条都是 AI 实际会犯的错误,甚至对人类开发者也有启发
- 跨平台兼容:不管你用 Claude Code、Copilot 还是 Gemini,都能用
如果你只装一个 superpowers skill,装 using-superpowers。它会让其他所有 skill 的效果翻倍。
📌 原文出处:obra/superpowers/skills/using-superpowers 🔄 中文翻译搬运:awesome-ai-agent-skills-zh
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!