最近在 AI 编程圈子里“superpowers”这个词出现的频率高得离谱。如果你经常刷技术社区大概率已经看到不少人在说给自己的 Claude 装了一堆 skills然后整个编码体验直接“起飞”。这里的 superpowers 既不是什么超级英雄电影里的超能力也不是某个夸夸其谈的概念而是一套围绕 AI 编程助手组织起来的技能集合通俗点讲就是给你常用的 AI 编程助手装上一套“外挂”让它在写代码、查问题、做重构的时候不再像一个只会接话的聊天机器人而更像一个训练有素的工程师。我今天就想把这个东西掰开揉碎讲讲它到底是什么、怎么安装、里面到底有哪些 skills以及我实际用下来的真实感受和踩过的坑。如果你最近正好在困惑“superpowers 具体使用”“怎么引入这些技能”“想要安装 superpowers 从哪里下手”那这篇应该能直接给你一份可以照做的答案。我会从概念聊到实操最后再给你一份排查清单希望能让你少走点弯路。1. Superpowers 到底是什么为什么突然这么多人装1.1 先搞懂 Skills 这个概念在讲 superpowers 之前得先说说它依赖的底层机制Skills。你可以把 Skills 理解成一份“岗位说明书”或者是一本“操作手册”。默认情况下AI 编程助手虽然知识面很广但它并不知道在某个具体项目里应该遵循怎样的流程、输出怎样的格式、优先检查哪些风险。Skills 就是用来补上这一层的它本质上是 Markdown 文件、文本规则可能还带上一些脚本告诉模型“当你遇到某类任务时按这个步骤走先做什么再做什么输出要包含哪些部分”。举个例子你让 AI 帮你做代码审查。没有 Skills 的时候它很可能只是笼统地看一遍然后说“这里可以优化一下”。有了“代码审查”这个 Skill它就会按照预设的框架去扫描先看正确性问题再看性能隐患然后是安全问题接着是可读性和测试覆盖最后按严重程度分级输出一份结构化报告。同样是代码审查前后差距非常大。而 superpowers 这个名字本质上指的就是一套已经帮你打包好的 Skills 集合。它不是某一个技能而是一个“技能全家桶”把日常开发中高频场景里需要的思考框架、操作流程、输出模板都塞了进去。你装上之后AI 助手的表现就会像突然被“加 buff”一样所以叫 superpowers 确实挺贴切。1.2 它到底解决了什么问题我自己的感受是单模型的能力固然重要但真正让它变得可用的是稳定可复现的工作流程。没装 superpowers 之前我让 AI 改一个接口它经常会直接给我一大段代码然后我拿去一测发现边界条件没考虑、日志没打、旧逻辑被悄悄改了。问题不在模型不够聪明而在它没有一套固定的“开工前检查清单”。superpowers 解决的正是这个痛点它把那些资深工程师脑子里默认会做的事比如“先复现问题再动手修”“大改动前先写方案”“重构完必须跑一遍测试”全部固化成可触发的 skill。模型读到这些 skill 后行为方式会发生肉眼可见的变化。它会先跟你确认需求边界把影响面列出来再动手改代码改完之后还会主动提出“要不要我帮你检查测试”。这种体验上的差异用过一次就回不去了。1.3 适合谁来用如果你属于下面这几类人我觉得 superpowers 值得一试日常重度使用 AI 编程助手的人尤其是每天要写大量 CRUD、改接口、写测试的开发者。团队里希望统一 AI 协作规范的人比如技术负责人想让所有成员跟 AI 打交道的方式保持一致输出质量稳定。AI 编程新手不知道怎么跟模型提需求装了之后相当于有人给你预设好了提问模板照着用就行。反过来如果你只是偶尔用 AI 查一个函数怎么写那可能用不上这么重的东西。但如果你愿意花半小时安装和配置后面省下的时间会远超这个成本。2. 安装 Superpowers从零到跑通全流程2.1 安装前先确认这些前置条件在动手之前先确认一下自己的环境支持 Skills 机制。目前主流的方向是 Claude Code 这类基于 CLI 的开发工具它们对 skills 目录有原生支持。其他一些 AI 编程助手如果支持自定义指令或项目记忆也可以变通使用但效果会有差异。我建议优先使用支持完整 skills 读写的环境否则后面有些技能可能触发不了。另外确保你的终端能正常访问 GitHub 这类代码托管平台因为 superpowers 通常以 Git 仓库的形式分发。如果你的网络拉取速度很慢可以换个网络环境或者把仓库下载成压缩包再解压这些都不影响最终使用。最后建议你找一个干净的工作目录。比如在用户目录下建一个superpowers文件夹专门用来放这套技能不要跟某个项目的源码混在一起。这样以后升级、备份、迁移都方便。2.2 获取项目文件Clone 还是下载压缩包安装的第一步是把 superpowers 仓库拿下来。我这边是用 Git 来管理的命令大概是这样的git clone https://github.com/example/superpowers.git ~/superpowers注意我这里写的地址是示意你在实际安装时应该以项目主页提供的仓库地址为准。如果你不习惯用 Git也可以直接在网页上下载 zip 包解压到~/superpowers目录效果完全一样。拿到之后先看一眼目录结构。正常情况下你会看到类似下面这样的内容superpowers/ ├── skills/ │ ├── code-review/ │ │ ├── SKILL.md │ │ └── scripts/ │ ├── debug/ │ ├── plan/ │ ├── test/ │ └── ... ├── docs/ ├── CLAUDE.md └── README.md其中skills目录是核心里面每个子文件夹就是一个独立技能。SKILL.md是这个技能的定义文件里面写了触发条件、执行流程和输出规范。CLAUDE.md通常是全局说明文件用来告诉 AI 助手“你有这么一套技能可用以及怎么使用它们”。2.3 让 AI 助手认识这些技能路径链接与加载配置把文件下载下来不代表 AI 就会自动使用你需要让它知道去哪找这些技能定义。最常见也是最推荐的做法是把skills目录软链接到 AI 助手的全局技能目录。这样不管你在哪个项目里启动它都能读到这套技能。我的做法是执行ln -s ~/superpowers/skills ~/.config/claude/skills每个人的环境路径可能不太一样如果你不确定自己的全局配置目录在哪可以先执行一次 AI 助手的初始化命令或者查看它的配置文件路径。做软链接而不是直接复制好处是以后更新 superpowers 时只需要重新git pull一次所有项目立刻就能用上最新版本不需要逐个去复制。如果你用的是项目级的配置方式也可以在项目根目录的CLAUDE.md里追加一段说明让 AI 在进入这个项目时主动去加载。比如我有的项目是这么写的请先阅读 ~/superpowers/skills 目录下的所有 SKILL.md 文件你拥有这些技能。当遇到对应场景时请严格按照技能中描述的流程来执行。加完这句之后重启对话AI 就会把技能加载进上下文。2.4 验证安装是否成功装完别急着直接开始写代码先花半分钟验证一下。重新启动你的 AI 编程助手然后发一条消息请查看你拥有的 skills 列表特别是来自 superpowers 的那些技能然后把它们列出来。如果它准确列出了 code-review、debug、plan、test 等技能名称说明加载成功。如果它说“我没有这些技能”或者只列出一些无关内容那大概率是路径没配对或者你没有重启会话。还有一个小技巧你可以直接问一个技能触发问题比如“用 code-review 技能看一下我刚贴的这段代码有没有问题”。如果它按照预设的结构输出报告那就是真装好了。3. 里面到底有哪些 Skills核心清单与使用场景3.1 一份常见的技能全家桶我把自己实际用下来觉得最值得关注的几个技能整理成了表格方便你对照了解技能名核心作用典型触发场景输出特点plan先规划后动手大功能开发、接口重构、架构调整输出目标、方案、风险点、验证步骤code-review系统化代码审查提交 PR 前、改动完一段核心逻辑按严重程度分级列出问题并给出修改建议debug定位并修复问题线上 bug、测试失败、偶现异常先复现、再二分定位、最后给结论test自动生成测试用例写完新函数、修完 bug输出可运行的单元测试代码docs生成与维护文档新增模块、变更接口输出 README、接口说明、注释refactor安全重构代码重复、可读性差、逻辑混乱改造前后对比、影响面分析context-compactor压缩对话上下文对话太长、token 不够用保留关键决策压缩过程性内容这个列表并不是固定的不同版本的 superpowers 收录的技能可能会有增删。你自己安装完之后最好花点时间逐个打开 SKILL.md 看一眼知道每个技能能干什么。3.2 几个核心技能的实战用法先拿 code-review 来说。它的使用方式特别简单把代码 diff 或者整段代码贴给 AI然后说“用 code-review 技能检查这段代码”。它会先做静态梳理找出潜在的 Null 引用、数组越界、事务边界问题然后按“严重问题、建议修改、可忽略”三个层级输出。我试过几次确实能发现一些自己没注意到的边界情况。debug 这个技能也很实用。它最大的特点是强制 AI 不急着给修复方案。以前我让 AI 看一个报错它经常凭经验直接猜测原因然后给我改一行代码结果问题还在。有了 debug 技能它就会先要求我提供复现步骤、日志片段、最近改动然后圈定嫌疑范围再靠测试来验证假设。虽然看起来多花了几回合对话但最终定位准确率高了很多。plan 技能适合在动手写大功能前用。你只需要说“用 plan 技能帮我规划一下这个新模块”它就会像做设计文档一样把模块边界、数据流、接口定义、兼容性考虑都列出来。拿到这份规划之后你再决定要不要让 AI 继续写代码整个节奏会从容很多。3.3 技能不是孤立的组合起来效果更好如果你只是每个技能单独用那就浪费了 superpowers 的真正价值。我实际使用中最爽的场景是把多个技能串成一个工作流。比如面对一个需要重构的模块我先触发 plan让它写出改造方案方案确认后我再让它执行重构重构完立刻调用 code-review最后补上 test 技能生成的测试用例。整个过程 AI 的状态从“被动答题”变成了“按流程办事”每一步的输出都衔接得很自然。你可以在CLAUDE.md里写一个“标准工作流”让 AI 默认按这个顺序走。我自己的定义是plan 优先 → 编码执行 → code-review 兜底 → test 收尾。当然不是所有改动都这么重但涉及核心逻辑这套流程确实能避免很多低级失误。4. 实操实录把 Superpowers 用进一个真实改动4.1 场景设定前阵子我接手了一个老项目里面有个PaymentService类一千多行各种 if 嵌套连原作者都跟我说改起来要小心。产品提了个需求新增一个支付渠道但不允许影响现有渠道。这种活如果直接让 AI 动手我心里没底但手动改又要花很多时间。于是我把 superpowers 完整地用了一遍。我把需求和关键约束发给 AI然后用 plan 技能让它出方案。原话大概是使用 plan 技能。我要在 PaymentService 中新增一个支付渠道目标是不改变现有渠道的外部行为保持接口兼容。请先调研现有代码结构然后输出改造方案包含影响面和验证步骤。它没有直接给我代码而是先分析了类的结构把现有渠道的公共逻辑和差异点列了出来。最有价值的是它指出了当前类存在的一个隐藏耦合所有支付渠道的响应处理都共用一个异常捕获逻辑新增渠道时如果不注意会把新渠道的错误并入旧渠道的重试机制。4.2 方案确认后再进入编码执行plan 输出之后我仔细看了一遍觉得没有大问题于是又让它“开始执行重构遵守 plan 技能中描述的目标保留现有方法的签名不变”。这次它给出的代码就明显更有章法了。它在改动之前先标注了影响范围然后把不同支付渠道的差异部分提炼成策略方法最后保留了统一的入口。改完之后我继续指挥“用 code-review 技能审查一下你刚才的改动。”这个环节很有用。它发现我在一个异常处理分支里把NullPointerException和PaymentException混在了一起可能导致空的渠道 ID 被当成支付系统错误重试。这个地方我自己的确没注意到。它给出的建议是把空渠道 ID 在校验入口就干掉彻底隔离。接着我又说“用 test 技能为新增渠道补充测试用例。”它根据 plan 阶段列出的行为约束生成了包括成功回调、签名错误、网络超时、余额不足这几种场景的测试骨架。我稍微补了两个数据细节跑了一下测试通过了。4.3 使用前后的体验对比如果是在没装 superpowers 的状态下我估计对话会是这样我贴需求AI 直接给代码我改完自己 review发现问题再回去问 AI效率低且容易漏。装了之后最大的变化是它不会“跳步”。每一步的输出都会带上前一步的结论作为依据整个改动链路是清晰、可审计的。当然我也想说句实在话superpowers 不是银弹。它提高了 AI 的稳定性和流程感但最终的决策和责任还是在人身上。plan 输出的方案不一定都合理code-review 也可能漏掉深层业务逻辑错误。你需要把它当成一个“高水平的初级工程师”而不是“全知全能的架构师”。5. 常见问题与排查技巧实录5.1 装完之后 AI 完全没反应这个问题我遇到过好几次。最常见的原因是路径没对齐。你需要在启动 AI 助手的同一个用户环境下去检查软链接是否指向了正确目录。可以使用ls -l ~/.config/claude/skills看一下链接是否正常然后确认skills下确实有SKILL.md文件。另外如果你是在某个项目目录里启动的而项目有自己的.claude配置覆盖了全局配置也可能会导致技能没被加载。解决方法是把技能链接放到项目级的.claude/skills下或者直接移除项目级配置里的冲突设置。5.2 技能之间互相“抢话”因为 superpowers 里每个技能都有自己的触发条件有时候你只是想查个代码结果 AI 莫名其妙启动了 plan 技能把你的简单问题搞复杂了。这通常是技能定义里的触发词太重了。我的做法是打开对应技能的 SKILL.md修改里面的trigger部分把触发条件收紧一些比如只要求看到明确的动词“规划”“写方案”才触发而不是一提到“新增功能”就触发。5.3 对话变慢上下文很快被塞满每个技能文件加载进来都会占据一定的 token 空间。我当时把整个 skills 目录全都软链接过去之后明显感觉到每次新对话的开头变慢了一点而且上下文窗口被吃掉不少。解决的办法很简单只把最常用的几个技能放在全局目录其他的放在一个备用目录里。等项目真要用到时再在CLAUDE.md里用指令临时引用。5.4 我的个人避坑心得用了一个多月最大的体会就是“减少技能数量增加技能质量”。superpowers 再好也不是越多越强。我一开始把所有技能都开着结果 AI 反而不知道优先调用哪个。后来我按自己的开发习惯只保留了 plan、code-review、debug、test 这四个其余的全关掉效果反而更好了。另外不要等着 AI 自己去主动触发技能。在 prompt 里显式写明“用 xx 技能”才是最可控的。你甚至可以建立一个前缀规则比如每次提问先写plan或review让 AI 清楚知道你现在要哪套工作流。这样既保留了灵活性又避免了误触发。说实话把这个习惯建立起来之后superpowers 才算真正长在了你的工作里。