第一次接触 Superpowers 的时候我差点以为这又是一个被营销号吹出来的“万能工具包”。但等我把它的 skills 目录完整翻了一遍又在 Claude Code 里连续跑了几个真实任务之后我得承认这个名字起得很诚实它确实是在给 AI 编程助手加“超能力”。很多朋友搜到“superpowers”这个关键词时可能会看到各种完全不同的东西。这里先明确一下我说的是开发者圈子里最近非常火的那套开源 Agent Skills 技能集合。它不是游戏不是浏览器插件而是一堆按规范组织好的 Markdown 技能包专门给 Claude Code 这类 AI 编程环境使用。这套东西不能说多高深但思路确实巧妙把复杂任务的处理方法沉淀成一个个可以被 AI 自动加载的“技能”让模型不再只是凭空回答而是按一套经过验证的步骤去思考、去行动。这篇文章我就从安装开始把“有哪些 skills”“怎么引入这些技能”“实际跑起来有什么坑”一条龙讲清楚。不论你是刚把 AI 编程助手装好的新手还是已经在大量用 Prompt 调教模型的老手这套 Superpowers 都值得花一晚上折腾折腾。1. 先别急着装Superpowers 究竟解决什么问题先说个每天都在发生的真实场景。你让 AI 助手“帮我优化这段代码”它可能会直接给你一堆修改建议但质量完全看心情有时它把变量名改得更烂有时它连需求都没理解就开干。问题不在模型本身而在你给的任务太模糊AI 缺少一套稳定的“思考框架”。Superpowers 要解决的就是这个问题。它基于 Anthropic 提出的 Agent Skills 规范把一类任务的处理流程写进一个独立的SKILL.md文件里。装上 Superpowers 之后你在对话里输入planning、code-review这类技能名AI 就会先读取这份技能文档再按照里面的步骤执行任务。相当于你给 AI 戴上了一副专业手套让它知道什么时候该拆解问题、什么时候该查资料、什么时候该停下来确认需求。1.1 它和普通 Prompt 模板有什么本质区别很多人用过 Prompt 模板比如“接下来你会扮演一名资深架构师请分步骤输出方案”。这种模板的问题在于它们只是提示词AI 可以随时无视最终还是靠临场发挥。而 Skills 更像一份“岗位说明书”里面包含的不只是角色设定还有具体的操作流程、检查清单、输出格式甚至配套的脚本和参考文件。我用过一个比较典型的技能planning。它要求 AI 在收到复杂需求后先拆出目标、约束、风险再列出可执行计划最后还要主动问用户“哪些步骤可以不需要”。这种流程感是普通 Prompt 很难稳定复现的。一旦技能写好了AI 每次执行同类任务都会按这套流程走输出质量从“时好时坏”变成“稳定可用”。1.2 它的设计思路为什么受欢迎Superpowers 受欢迎还有一个很现实的原因它解决了“经验复用”的难题。过去你在某个项目里好不容易调教出一套好用的 Prompt换个项目就失效了或者只能复制粘贴到聊天窗口里。但技能包是文件可以直接放进项目仓库跟着代码走。团队协作时这个优势尤其明显。你把自己调好的技能目录放到.claude/skills/下队友克隆仓库后就能用同样一套技能不需要每个人再花时间摸索。这有点像把老师傅的“手艺”写成了标准作业指导书新来的实习生照着做也不会跑偏。这种可复制、可版本管理、可共享的形态才是它能在开发者社区里迅速传开的核心原因。2. 安装 Superpowers从零到能用实际就那么几步现在进入实操环节。我先说清楚一个前提Superpowers 不是一个独立软件它是给 Claude Code 用的技能集合。所以第一步不是装它而是先把 Claude Code 这个运行环境备好。2.1 先把 Claude Code 环境跑通如果你机器上还没有 Claude Code那就先装它。Claude Code 是 Anthropic 出的官方命令行编程工具支持在终端里直接对话、读文件、跑命令、改代码。它依赖 Node.js 运行时建议 Node.js 版本在 18 以上安装方式官方文档写得很清楚。装好后先验证环境claude --version能在终端打印出版本号说明环境没问题。另外还要确认你已经登录了 Claude 账号并且当前终端能正常访问它。如果连基础的对话都跑不通后面装技能包也没意义。2.2 两种常见安装方式给 Claude Code 装技能本质上就是把你下载下来的技能文件放进 Claude Code 会扫描的目录里。用户级的技能目录默认是~/.claude/skills/项目级的技能目录是.claude/skills/。Superpowers 这种通用技能放用户级目录更合适所有项目都能用。方式一手动克隆并复制先在 GitHub 上找到你想装的 Superpowers 仓库复制它的 HTTPS 克隆地址然后执行# 把仓库拉到本地repo-url 换成你复制的实际地址 git clone repo-url /tmp/superpowers # 创建 Claude Code 的用户级技能目录 mkdir -p ~/.claude/skills # 把项目里 skills 子目录下的所有技能复制进去 cp -r /tmp/superpowers/skills/* ~/.claude/skills/ # 检查结果 ls ~/.claude/skills/执行完最后一条命令后如果看到一堆以技能名命名的目录比如planning、brainstorming、code-review说明文件已经就位。方式二只软链你需要的技能Superpowers 仓库里的技能可能很多但很多技能你不一定会用到。全量复制会让技能目录变得臃肿也占 Claude Code 的扫描负担。我更推荐按需链接把高频使用的几个目录软链到技能目录里。ln -s /tmp/superpowers/skills/planning ~/.claude/skills/planning ln -s /tmp/superpowers/skills/code-review ~/.claude/skills/code-review这样做的优势是以后你想更新某一个技能直接进仓库目录git pull软链自动就指向新版本了不用再复制一遍。2.3 安装后先做一次“体检”装完之后别急着开始写代码先确认 Claude Code 确实能认到这批技能。打开终端进入一个测试目录运行claude在对话里输入一个技能名比如planning 帮我规划一个 Python 脚本的迁移方案如果模型回应的内容里带着“规划”“步骤拆解”等明显的方法论结构说明技能已经生效。如果它只是当普通问题回答那很可能技能文件没放对位置或者文件名不对。注意技能目录里必须有一个名为SKILL.md的文件Claude Code 只认这个名字。如果你复制的时候漏了这个文件或者目录嵌套层次不对技能就加载不出来。检查目录结构时确认路径是~/.claude/skills/planning/SKILL.md而不是~/.claude/skills/planning/something/SKILL.md。3. 技能清单拆解哪些 Superpowers 最值得用Superpowers 的价值在于它带了一批成熟技能但你不需要全部用上。我把典型的技能按使用场景分了个类你可以根据自己的工作习惯挑选。不同仓库或不同版本的 Superpowers技能清单会有差异但思路基本一致。3.1 规划与拆解类让 AI 先想清楚再动手这组技能适合用在需求模糊、任务复杂的场景常见的有planning、brainstorming、prioritization。planning不用多说它强制 AI 先拆解问题、列计划、识别风险再开始写代码。brainstorming则适合你在没有思路时用它不会一上来就给出“标准答案”而是生成多个候选方案附上优缺点和权衡建议。这些技能能明显减少那种“AI 跑题跑出十万八千里”的情况因为它在动手之前就帮你把目标锚定了。3.2 编码与审查类把代码质量交给流程把关写代码过程中最容易出问题的环节不是“写不出来”而是“写出了烂代码”。code-review、refactoring、testing这几个技能是配合着用的。code-review会让 AI 严格检查你的代码按严重程度给出问题清单并标注修改建议。它不是简单说“这段可以优化”而是会指出问题出现在哪一行、影响是什么、怎么改。refactoring则强调保持行为不变的前提下改善结构减少重构引入新 bug 的概率。testing会帮你按优先级列出测试计划生成边界用例而不只是补几个 happy path。3.3 调试与修复类把玄学排查变成科学流程调试是最费神的日常工作也是debugging技能最值钱的地方。它会引导你先复现问题、再建立假设、然后通过二分法逐层定位而不是让 AI 凭经验瞎猜。尤其在“报错信息很诡异”的时候这套流程能省下大量时间。还有一个隐藏技能叫root-cause-analysis适合线上故障复盘。它会逼着 AI 追问“真正导致问题的根因是什么”“为什么前置防线没有拦住”避免你只修了表象没过几天同一类问题又爆出来。3.4 写作与研究类不只是写代码时有用Superpowers 里也不全是代码向技能还有writing、research、explainer这类偏文档和知识整理的技能。writing会先搭文章结构再逐段打磨写技术方案和文档时特别好用。research适合需要查资料、收集论据的场景它会明确问题边界、列出信息源、标注不确定性。explainer是我个人很喜欢的它让 AI 用生活化类比去解释复杂概念给非技术同事讲清楚原理时非常管用。这些技能扩展了 Superpowers 的使用范围哪怕你不写代码也能在知识管理、内容创作里受益。3.5 一张表看懂典型技能分布技能名适用场景核心价值planning复杂/模糊需求拆目标、列步骤、识别风险brainstorming方案探索生成多方案并比较优劣code-review代码评审按严重级别给出可执行修改建议refactoring代码重构在保持行为不变的前提下改善结构debugging异常排查复现、假设、二分定位testing测试补充按风险优先级设计测试用例writing技术文档/写作搭结构、磨表达、控制节奏research资料调研明确问题、收集证据、给出来源explainer面向非技术讲解用类比解释复杂概念这张表没有列全但已经覆盖我用过的绝大多数高频场景。装技能的时候可以按这个清单挑选先把核心的几个放进去用顺手了再补。4. 怎么引入这些技能调用姿势和实战记录很多用户卡在“装好了但不知道什么时候用、怎么用”。其实技能的引入方式非常灵活可以手动触发、按项目自动触发、甚至混合串联多个技能。4.1 用 技能名 主动召唤最简单的用法就是在 Claude Code 对话里直接写技能名。比如你想让 AI 按照规划方法论来回答问题就把planning放在问题前面planning 我们想把现有的登录模块从单体服务拆成独立认证服务请给出迁移计划。这之后Claude 会优先读取planning技能里的SKILL.md按照里面写的流程执行。相比不带技能的直接提问它的回复会更结构化、更像一份可以评审的方案。我个人经验是这句话里的描述仍然要尽量具体技能只负责“怎么干活”不负责“替你想清楚需求”。4.2 让技能在项目里被动触发如果是高频固定场景你可以让技能自动进入工作流。方法是在项目根目录的CLAUDE.md里写上一句话告诉 Claude 什么时候该使用哪个技能。比如当用户提出涉及代码重构的需求时先调用 refactoring 技能再动手。 当用户提交大段代码希望评审时先调用 code-review 技能。这样只要 Claude 读取了项目规则它就会优先考虑调用技能。它不是一条死命令但确实能显著提高技能的“出场率”。这种被动触发方式特别适合团队内部统一工作流所有人共享同样的项目规则AI 就会保持一致的做事风格。4.3 一个任务同时串起多个技能技能不是只能单独用复杂任务可以像流水线一样串起来。前几天我做了一次支付模块的改造实际对话里就连续用到了三个技能planning 帮我把支付模块的重构拆成阶段计划 code-review 先审查当前支付模块的代码找出高风险的坏味道 testing 针对改造后的支付流程设计一套回归测试用例第一步让 AI 先规划第二步让它审查现状第三步让它补测试。三个技能各司其职没有冲突反而衔接得很顺。这种“技能组合拳”比一次性让 AI 干完所有事要稳妥得多因为每一阶段都有明确的技能方法论兜底。4.4 自己动手扩展一个新技能Superpowers 的真正魅力在于你可以照着它的模式写自己的技能把个人经验固化成文件。写一个技能并不复杂核心就是创建一个目录和SKILL.md文件。比如我想做一个专门写 Git 提交信息的技能先建目录mkdir -p ~/.claude/skills/commit-message然后在这个目录里新建SKILL.md内容结构如下--- name: commit-message description: 当需要生成或优化 Git 提交信息时使用。特别适合多文件改动、需要区分 feat/fix/docs 的场景。 --- # 提交信息生成指南 1. 先读取 git diff --stat 和关键文件的 diff。 2. 判断本次改动的类型feat、fix、refactor、docs、test、chore。 3. 用一句话概括改动内容保持在 50 个字符以内。 4. 如果需要在正文里说明动机避免罗列文件清单。保存后在 Claude Code 里输入commit-message并描述改动它就会按这个流程生成提交信息。一个技能从想法到上线一般不超过十分钟。5. 常见问题与排查技巧实录我在实际使用 Superpowers 的过程中遇到过不少问题有些是文件放错的低级问题有些是设计层面的取舍。下面把踩过的坑集中总结一下。5.1 装好却调不出来最典型的表现为输入planning后Claude 完全没有反应或者只是把它当普通文本忽略。这时候按顺序排查先看技能目录位置。运行ls ~/.claude/skills确认目录下直接是技能文件夹而不是superpowers/skills这种嵌套结构。再检查每个技能文件夹里有没有SKILL.md文件名是严格大写。最后确认运行claude的目录身份如果技能放在用户级目录任何项目都能用如果放在项目级.claude/skills下别跑错目录。还有一个容易被忽略的问题Claude Code 的版本太旧可能不支持 Agent Skills。遇到这种情况升级到最新版本就能解决。5.2 技能之间互相打架有时候你让 AI 同时调用refactoring和code-review它会不知道怎么分配重心。技能的SKILL.md里通常都有“什么时候不要用本技能”的描述但多个技能同时被触发时还是可能产生冲突。我的建议是一次对话里只让一个核心技能主控其他技能用来处理阶段性子任务。比如先code-review等审查意见出完了再refactoring按意见改代码而不是让两个技能同时主宰同一个任务。另外可以在项目的CLAUDE.md里写明优先级告诉 Claude 冲突时优先执行哪一个。5.3 技能包更新之后我的改动丢了Superpowers 仓库更新很频繁如果你在旧版本基础上改了技能文件又直接git pull更新仓库本地改动很可能被覆盖或者产生冲突。这一点我吃过亏。现在我的做法是核心技能全部复制到独立的技能目录不直接改仓库里的原始文件。仓库只作为更新源每次更新后用diff比较一下新旧版本把有用的改进手动合并进去。如果是自己写的自定义技能就放在另一个目录避免被上游更新影响。5.4 哪些情况下不建议用技能包虽然 Superpowers 覆盖面很广但并不是所有任务都适合调用技能。比如一个只需要“把这段 JSON 转成 YAML”的简单操作你硬要套planning反而显得笨拙还会白白消耗上下文。技能的本质是处理“有一定复杂度、需要方法论支撑”的任务不是用来回答所有问题的。另一个不建议使用技能包的情况是你的上下文窗口已经很小了。技能描述本身会占用一部分上下文技能加得太多太重反而挤压了真正解决问题的空间。我实际用下来的稳定做法是用户级技能目录只放 8 到 12 个高频技能项目级目录按这个项目的实际需求再补充两三个专用技能。这样既不会让 Claude 失去焦点也不会把上下文撑爆。从用上 Superpowers 到现在我心里最大的感受是这类技能包不是灵丹妙药但它提供了一个非常扎实的“习惯框架”。以前我写 Prompt 全靠临场发挥遇到同一类问题每次都是重新思考和写一遍现在我把高频任务都交给了技能AI 输出更稳定我自己也能腾出精力去关注真正需要判断力的地方。如果你打算尝试建议不要全量照搬先挑三四个最能解决你痛点的技能装进去。跑通一个流程比囤积一百个技能重要得多。