superpowers教程-让 AI 写代码更靠谱的技能框架

导语：superpowers 是面向 AI 编程助手的技能框架，把「资深工程师的工作流程」打包成即插即用的技能，让 Claude Code、Codex 等 AI 写代码时更靠谱。本文是零基础向的超详细完整教程，先讲清「AI 编程助手」和「技能」是什么，再教你如何上手。

项目地址：https://github.com/obra/superpowers

一、superpowers 是什么？

先给一个最直白的定义：superpowers 是一套「给 AI 编程助手用的技能包」，它把资深工程师的做事方法（怎么想需求、怎么写代码、怎么测试、怎么查 bug），打包成一个个「技能」，装进 Claude Code、Codex 这类 AI 编程工具里，让 AI 写代码时更靠谱、更专业。

要理解它，需要先搞懂两个背景概念：

背景 1：什么是「AI 编程助手」？

「AI 编程助手」是一类能帮你写代码的 AI 工具，最知名的有 Claude Code、GitHub Copilot、Cursor、Codex 等。它们的用法是：你告诉它「帮我写一个功能」，它就能自动生成代码。这大大提升了编程效率。

背景 2：AI 编程助手的「短板」在哪？

但是，AI 编程助手有一个普遍的问题：它写代码很快，但「不够靠谱」。具体表现是：

• 它可能没想清楚需求就急着写代码，结果写出来的东西不是你要的；
• 它可能写完代码就不管了，没有测试，埋下 bug；
• 它遇到 bug 时，可能乱试一通，而不是系统性地排查；
• 它可能做完就交差，没有验证结果对不对。

这些问题，本质上是因为AI 缺了「资深工程师的工作方法论」——一个靠谱的工程师，动手前会先想清楚需求、写的时候会考虑测试、出问题会系统排查、做完会验证。而这些「方法论」，AI 默认是没有的。

superpowers 做的，就是把这些「资深工程师的方法论」打包成一个个「技能」，塞给 AI 编程助手，让它在写代码时，也能像靠谱的工程师一样：先规划、再动手、写测试、查 bug、最后验证。

打个比方：如果把 AI 编程助手比作一个「手很快但做事毛糙的学徒工」，那 superpowers 就是给他的一整套「老师傅的操作规范」——照着这套规范干活，他就不容易出错、出活了。

二、它到底有多火？

以下数据来自 GitHub 官方仓库（统计截止 2026 年 11 月 4 日）：

• Star 数：约 31.2 万（312,000+），是当下 AI 编程工具类项目里最火的一个，堪称现象级。
• Fork 数：约 2.8 万（27,700+）。
• 创建时间：2025 年 10 月，一年多时间就突破了 30 万 star，增长速度快得惊人，说明它精准命中了开发者的痛点。
• 主语言：Shell。
• 许可证：MIT，完全开源免费。

它这么火，是因为它解决了一个非常真实、非常普遍的痛点：「AI 写代码很快，但不靠谱」。几乎所有用过 AI 编程助手的人，都吃过「AI 乱写、埋 bug、做完不验证」的亏，而 superpowers 正是对症下药。

三、核心功能有哪些？

superpowers 的核心，是一套「软件开发技能」，它把资深工程师的工作流程拆成了下面这些环节（每个都是一个独立技能）：

• 1. 头脑风暴（Brainstorming，带审批门）：动手写代码前，先和 AI 一起把需求想清楚、把方案定下来，并且设了「审批门」——方案没确认前，不让 AI 乱写。
• 2. 写计划（Planning）：把任务拆成清晰的步骤计划，让 AI 照着计划一步步做，而不是东一榔头西一棒子。
• 3. 测试驱动开发（TDD）：先写测试，再写代码，确保代码真的能用。这是资深工程师的招牌做法。
• 4. 代码审查（Code Review）：让 AI 像审阅者一样检查自己（或别人）写的代码，找出问题。
• 5. 系统化调试（Debugging）：遇到 bug 时，按系统性的方法排查，而不是乱试。
• 6. 完成前验证（Verification）：做完后，主动验证结果是否真的符合要求，而不是「写完就交差」。

此外，它支持 10+ 个 AI 编程平台（Claude Code、Codex、Cursor 等都能装），所以你不用换工具，直接给你现有的 AI 编程助手「加装」这套技能即可。

四、怎么安装和使用？（手把手）

superpowers 的安装很简单，核心就是「装进你的 AI 编程助手里」。下面以最常用的 Claude Code 为例说明（其他工具类似，详见官方文档）。

第一步：确认你有一个 AI 编程助手

superpowers 本身不是独立的软件，它是「给 AI 编程助手用的插件」。所以你需要先装一个支持的 AI 编程助手（比如 Claude Code、Codex、Cursor）。如果你还没装，先去装一个。

第二步：安装 superpowers

在命令行里执行安装命令（以 Claude Code 为例，具体命令以官方 README 为准，这里给出典型流程）：

# 通过 npx 安装（需要 Node.js 环境）
npx superpowers install

或者按官方 README 提供的最新安装命令执行。安装完成后，superpowers 的技能就会「注入」到你的 AI 编程助手里。

第三步：开始使用

安装后，你不需要改变太多使用习惯，直接照常给 AI 布置任务即可。区别在于：

• AI 动手前，会先进入「头脑风暴」模式，跟你确认需求（而不是直接乱写）；
• 写代码时会考虑测试；
• 做完后会主动验证。

你也可以用特定的「技能触发词」来主动调用某个技能（比如让它「先做个计划」「系统排查这个 bug」），具体触发词见官方文档。

五、它和「提示词」有什么区别？（一个常见疑问）

很多人会问：superpowers 不就是一堆「提示词」吗？这里帮你理清区别：

• 形式上像，但本质不同：提示词是你「手动输入」的一段指令；而 superpowers 是「装进 AI 助手里的技能包」，装好后它自动生效，不需要你每次手动输入大段提示词。
• 它是「方法论」，不是「几句话」：superpowers 不只是「告诉 AI 要测试」，而是把「测试驱动开发」这套完整的方法论（含具体步骤、标准、流程）都封装进去，比单条提示词系统得多。
• 一句话总结：提示词是「临时嘱咐一句话」，superpowers 是「给 AI 换上一套专业的工作方法」。

六、哪些人适合用？

• 正在用 AI 编程助手的开发者：这是最核心的目标用户。如果你已经被「AI 乱写代码」坑过，superpowers 能明显改善体验。
• 想用 AI 写代码但担心质量的新手：superpowers 的「先规划、写测试、验证」流程，能帮你避免很多低级错误。
• 团队管理者：让团队统一用这套规范，能提升 AI 辅助开发的代码质量。
• 想学习「专业开发流程」的人：superpowers 封装的方法论（TDD、系统化调试等），本身就是很好的学习材料。

七、哪些人不建议用 / 需要避坑

• 完全不会编程、也不用 AI 编程助手的人：superpowers 是给「AI 编程」场景用的，如果你不写代码，它对你没有意义。
• 追求「AI 一次性全自动写完」的人：superpowers 反而会「让 AI 慢下来」——因为它要求 AI 先规划、先确认、写测试。这是「用一点效率换靠谱」，如果你只追求快、不在乎质量，可能会觉得它啰嗦。
• 要注意它改变了 AI 的行为方式：装上后，AI 不会像以前那样「秒回代码」，而是会先问需求、先做计划。这是特性，不是 bug，但你要适应这种工作节奏。
• 不同平台的安装方式不同：虽然支持 10+ 平台，但每个平台的安装命令略有差异，要按官方文档对应的部分来操作。

八、常见问题（FAQ）

问题 1：superpowers 是独立的软件吗？

不是。它是「给 AI 编程助手用的技能包」，需要先装一个支持的 AI 编程助手（如 Claude Code、Codex），再把它装进去。

问题 2：装上之后，AI 怎么好像变「慢」了？

这是正常现象。superpowers 会要求 AI 先规划、先确认需求、写测试，所以 AI 不会像以前那样「秒回代码」。这是用「一点速度」换「可靠性」，是它的设计初衷。

问题 3：它收费吗？

完全免费开源（MIT 许可证）。你只需要承担 AI 编程助手本身调用的费用（大模型 API 费用）。

问题 4：我不是程序员，能用吗？

如果你不写代码、不用 AI 编程助手，那它对你就没有用武之地。它主要面向「用 AI 辅助编程」的人群。

九、总结

superpowers 是目前最火的 AI 编程技能框架，它精准地解决了「AI 写代码快但不靠谱」这个普遍痛点——把资深工程师的「先规划、写测试、查 bug、做验证」这套方法论，打包成即插即用的技能，装进你的 AI 编程助手里。

它的核心理念很务实：与其追求「让 AI 写得快」，不如「让 AI 写得对」。虽然装上后 AI 会「变慢」一点，但换来的是更可靠的代码、更少的返工。对于正在用 AI 辅助编程、又被「AI 乱写」困扰的开发者来说，这是一款非常值得尝试的工具。