已经习惯每天开一个Claude Code会话干活的人多少都有过这种感受同一个项目的代码规范同一套测试流程每次新开会话都得重新交代一遍你费劲写进CLAUDE.md的东西它有时候看了有时候看了一个寂寞。我一度以为这就是AI编码助手的日常直到花了一天时间把superpowers这套开源技能集装进自己的工作流才意识到问题不在模型能力而在工作方法——我从来没有给过AI一套正经的、职业级的工作方法论。superpowers说白了就是一堆精心设计过的skills能让Claude按照资深工程师的方式去写代码、查代码、改代码、写计划、做设计。它不是某个单一技巧而是一整套技能库安装之后AI会自动知道在什么场景该用什么方法。这篇文章不打算念一遍README只讲三件事它到底是什么、怎么装、装完之后哪些skills能真正改变你的日常开发方式以及我跑通之后踩过的那些坑。1. Superpowers到底是什么一套给AI编码助手的职业技能包1.1 从教AI怎么干活到给AI发工具书先理解一个核心概念Claude Code这类AI编程工具支持一种叫skills的东西。每个skill就是一个文件夹里面放一个SKILL.md文件可能还带几个辅助脚本。SKILL.md的开头有一段YAML格式的元信息包含这个技能的名字和描述下面则是正文告诉模型当你使用这个技能时应该按什么步骤、什么标准去做事。可以把它想象成工具箱里的说明书。你平常跟AI说帮我检查代码问题AI全凭当时的发挥去猜。但如果你告诉它用code-review技能来做它就会先去读那份说明书然后严格按说明书里写的流程执行先看改动范围再逐文件检查最后按严重程度汇总问题。人的大脑靠经验吃饭模型靠的是上下文里的说明你想让它稳定输出高质量结果就得给它一套可复用的操作手册。superpowers就是这样一个手册集合由开发者社区里的obra维护开源托管。官方叫它技能包或者插件市场——里面涵盖了几十个技能从代码审查、调试、写测试到理解陌生代码库、做系统设计、拆解大任务基本覆盖了日常开发里最费口舌的那些环节。1.2 它和CLAUDE.md、普通prompt模板的差别很多人可能跟我一样刚开始会想这不就是另一种形式的prompt模板吗我自己也有写CLAUDE.md里面塞了几十条项目规范AI不也能照着做吗区别非常明显我用一个表来对比对比维度CLAUDE.md / 全局指令Superpowers技能加载时机每次会话都读占用上下文惰性加载用到时才读SKILL.md内容定位项目规范、审美偏好、禁止事项做事的方法论完整操作流程维护成本写多了AI会看不过来每个技能独立按需组织可复用性绑定当前项目跨项目跨团队通用触发方式一直在靠AI自觉遵守模型根据描述自动选或你显式点名举个实际例子我以前习惯在CLAUDE.md里写提交代码前必须检查是否有调试残留、测试是否通过、是否有不必要的改动。问题是这句话每次都占上下文AI看了也不一定当成流程来执行。而superpowers里的代码审查技能会要求模型先列变更文件再逐个文件读diff然后对照代码规范输出一个带严重级别的问题清单。一个是提醒一个是按SOP办事产出质量完全不是一个量级。这一点理解透彻之后你就会明白为什么社区里很多人说superpowers改变了使用AI编程的方式——因为它解决的是系统性方法论问题而不是某一次对话的质量问题。2. 安装Superpowers的完整路径与前置检查2.1 前置条件先确认自己的底座没问题安装superpowers之前先把环境检查一遍。我当时没看文档直接装结果第一个skill都没跑起来浪费了半小时。前置条件其实就三条第一本地装好Claude Code。superpowers的核心运行环境就是Claude Code模型本身可以是Claude系列也可以配置其他兼容模型但底座程序必须是Claude Code。第二Node.js环境要可用。很多技能会调用本地脚本比如提取PR信息、操作文件、运行测试脚本这些依赖Node运行时。我建议Node版本至少在18以上装太老版本容易出现兼容问题。第三磁盘上有权限的用户目录因为skills默认安装在~/.claude/skills或对应的插件目录下如果权限不对安装过程会静默失败。还有一点容易被忽略公司内网环境通过代理访问npm源时安装依赖可能超时。如果你平时用npm装包没问题那这步一般不会卡住。装之前顺手跑一句node -v和npm -v确认版本号能正常输出即可。2.2 安装方式两种主流路径的完整操作superpowers的安装方式前后迭代过几版。我装的时候用的还是会话内引导的方式现在已经支持插件市场一键安装。两种我都跑过记录一下各自的操作。第一种插件市场方式我推荐这个。打开Claude Code在输入框里依次执行两条命令/plugin marketplace add obra/superpowers-marketplace /plugin install superpowerssuperpowers-marketplace第一条命令是把superpowers的插件市场源添加进来第二条是从这个源安装superpowers本体。安装完成后重启当前会话让插件列表刷新。这种方式的好处是能直接拿到官方维护的最新版本后续更新也方便直接在插件管理界面里点更新就行。第二种通过会话对话引导安装。如果你拿到的是一个旧版本或者不想敲那两条斜杠命令直接在会话里对Claude说安装superpowers它会自己拉取仓库、解压技能包、放到正确的目录。我当时试过这个方式它还会一步步问你是否要覆盖已有技能是否安装完整技能集合交互体验比较友好但流程更长不如插件市场方式干脆。无论走哪条路装完以后推荐顺手确认一下自己的用户目录里是否出现了一堆以技能名命名的文件夹。如果找到了说明装成功了。2.3 装完怎么确认真的生效了验证这一步非常重要因为superpowers装完之后Claude不会像普通应用那样弹个安装成功的窗。我测试过三种确认方式按效率从高到低排第一种打开新会话直接问它你现在有哪些可用的skills请列出你技能库里所有技能的名字和适用场景。如果安装成功它会列举出一长串技能并且能准确说出每个技能大概干什么。如果它回答得很模糊甚至说自己没有技能那大概率是技能目录没加载。第二种在会话里输入/plugin查看插件列表确认superpowers出现在已安装插件里。这种方式适合装有插件市场版本的情况能直接看到插件状态。第三种到命令行里看目录结构。执行类似ls ~/.claude/skills的命令看是否存在code-review、testing-toolkit这类技能文件夹。补充一句插件市场方式安装的技能实际存放路径可能跟着插件走不一定全在skills目录下所以目录里没找到不必慌张以会话内的插件列表为准。提示Claude Code各个版本的skills加载机制细节有差异命令写法和目录位置可能不同。遇到对不上的情况优先查看当前版本的/help或官方文档再决定下一步。3. 内置技能盘点拿来就能用的skills有哪些3.1 按工作场景拆解核心技能安装完第一件事肯定是想看看里面到底有什么。我当时也跟不少人一样上来就问有哪些skills列出来的清单很长一开始看着有点晕。用了一段时间之后我习惯把技能按工作场景分成四类这样记忆成本低日常也知道该用哪个场景技能名它实际做了什么代码审查code-review按资深工程师的CR习惯走完全流程逐文件输出问题清单带严重级别理解陌生代码库codebase-forensics从目录结构、依赖关系、核心入口入手快速画出一张项目地图拆解大任务writing-plans把一个含糊的目标改写成可执行的步骤列表带验收标准调试排查debugging按假设驱动的方式一步步缩小问题范围不靠乱试编写测试testing-toolkit辅助写测试用例覆盖正常路径和边界情况系统设计system-design先画逻辑结构、定接口边界再落到代码层面Git工作流git-workflow帮忙理清git操作包括分支管理、提交信息规范等头脑风暴brainstorming强迫AI先发散再收敛避免一上来就动手写代码这份清单不是官方文档的全部只是我实际使用频率最高的几个。每个技能都是一个独立的SKILL.md意味着你用哪一个就加载哪一个的方法论不相关的不会跑出来干扰。3.2 一个SKILL.md内部到底长什么样明白了有哪些技能再往里拆一层看看一个技能包内部的结构。这里我用一个简化示例模仿官方格式但不是抄某一份原文说明原理--- name: code-review description: 用于对代码变更做系统化审查。当用户要求检查PR、审查代码改动、发现潜在bug时使用。 --- # Code Review 技能 ## 执行步骤 1. 请求用户提供变更范围若无则用git diff获取 2. 列出变更文件清单确认审查优先级 3. 逐个文件读取diff检查逻辑、边界条件和安全隐患 4. 汇总为问题清单每个问题标注严重级别和建议修复方案这个结构看起来简单妙就妙在YAML里的描述字段。Claude在每次对话中不会把所有SKILL.md的正文都读一遍它只看每条技能的描述。当用户的请求和某条技能的description匹配时它才会打开对应的md文件按正文执行。这就是所谓按需加载的核心机制也是superpowers能在一堆技能里保持上下文干净的原因。了解这个机制之后你会明白自定义技能也是一种可行玩法——你只需要照着这个格式写好SKILL.md放进技能目录AI就能自动发现并调用它。可以说superpowers把给AI定制工作流这件事从玄学变成了工程学。4. 实战把技能引入日常开发流4.1 什么时候它自己会触发什么时候要显式点名把技能引入日常开发流第一个要搞清楚的问题是触发的时机。我在实际使用中总结出两条经验第一很多技能是可以被自动触发的。比如你提交了一个PR然后跟Claude说帮我检查一下这次改动的代码质量它会自动匹配code-review的description然后加载那份方法论来干这件事。你根本感觉不到技能被调用这个动作体感上就是AI突然变得更专业了会主动问你要变更范围、会按文件清单逐项审查。第二有些技能必须显式点名。尤其当用户请求比较模糊、或者同时涉及多个技能的时候AI可能拿不准。我遇到最典型的情况是writing-plans。如果你说帮我规划一下这个新功能怎么做AI可能会直接开干写出代码来了。但你如果说用writing-plans技能先写一份开发计划它就会老老实实先拆解任务、列验收标准等到计划确认了再动手。我的习惯是日常的代码审查、调试、查找文件依赖自动触发但凡涉及比较大的目标任务一律显式点名指定技能参与进来。这样既不打断正常对话流也能在关键环节获得方法论的支持。4.2 一次完整的code-review实战拆解讲一个真实的例子。当时我在改一个用户权限模块改了大概两百行代码涉及角色校验逻辑和数据库查询。开发完我没让Claude直接帮我改代码而是提了一句用code-review技能审查一下我这次的改动。它第一件事不是看代码而是先列了一个变更文件清单问我这些文件是否都在审查范围内。确认之后它逐个文件读取diff中途还会追问一些上下文比如这里新增的查询逻辑和原有的角色表是什么关系这个字段默认值是否有依赖。最后输出了一个分级问题清单。其中有一条是当role为空字符串时校验逻辑会走默认分支导致越权风险级别标为严重并给出了具体的修复建议。这个过程中给我触动最大的不是它发现了问题而是它执行的方式完全具备了流程感——先定范围、再逐个检查、最后给缺陷分级。这跟我平时在团队里让同事做代码评审的习惯几乎一模一样。更关键的是它没有一上来就改我的代码而是先把问题清单展现出来等我来决定改还是不改。这种只审查不改动的边界意识对维护干净的代码历史太重要了。如果换成普通对话我大概率得到的是直接改好的一版代码那我既不知道哪里有问题也无法判断改动是否合理。4.3 组合技能的进阶玩法单个技能用好已经很有价值了superpowers真正让我惊喜的是多个技能可以组合成一条完整的流水线。举一个新功能从零到落地的例子。我接到一个需求要给现有的数据看板加一个导出报表功能。以前我是直接打开编辑器就开写这次我换了一套组合方式第一步用codebase-forensics快速摸清楚项目里数据看板相关的模块有哪些、导出功能有没有可复用的基础库。这一步让我省掉了到处翻代码的时间半小时就搞清楚了原本要花一下午才能弄明白的项目结构。第二步用writing-plans把这个功能拆成几个阶段后端查询接口、前端导出按钮、文件生成与下载、异常处理。每个阶段都写清楚交付物和验收标准。第三步写代码过程中每完成一个阶段就让Claude用testing-toolkit补充对应的测试用例再跑一遍看有没有漏掉边界情况。最后用code-review做一次整体审查。这一套流程下来我一个原本预期要花一整天的功能半天基本完成而且过程里每一步的思路都是有迹可循的。组合技能的最大价值就在于它把软件开发方法论拆成了标准动作你可以像拼乐高一样自由组合。组合得多了甚至不需要刻意依赖某个技能自己脑中对接下来该做什么会有更清晰的感觉。5. 跑通之后踩过的坑和优化建议5.1 技能装太多上下文开始膨胀装完superpowers的第一周我面临一个新鲜的问题技能太多了AI在每次对话里要扫描的技能描述也变多了虽然SKILL.md正文是惰性加载但description列表本身还是会占用一部分上下文。这段时间我明显感觉到会话稍微长一点模型的响应质量就开始下降有点像一个人脑子里装了太多任务清单之后突然转不动了。解决思路不复杂按需精简。我现在只保留当前项目真正会用到的技能其它的一律移出加载目录。比如我正在做的后端项目留着code-review、debugging、testing-toolkit就够了shell-scripts这类用得少的直接挪走。等哪天要用再临时启用也不迟。这个操作不影响技能文件本身只是加载清单的变化随时可以调整。5.2 description写得不好会让AI乱调技能还有一次折腾了我挺久的坑和自定义技能有关。我自己写了一个技能用来统一处理日志格式SKILL.md里的description写得特别宽泛比如帮助处理日志相关的问题。结果后面在实际工作中每次我提到日志这个词AI都有可能调用这个技能有时候甚至是查一个问题时莫名加载了一个不相关的流程导致回答多绕了几步弯路。后来我才明白description的精确度决定了AI在什么场景下才会使用这个技能。写得宽泛就容易被当成万能工具写得具体AI才能准确判断触发条件。我自己现在写description时会包含三部分技能负责的任务、典型的用户请求示例、不该使用这个技能的场景。所以后来我给那个日志技能重写了description明确限定为仅当用户需要统一格式、脱敏、轮转等日志治理需求时使用简单的日志查看无需调用。之后再没出现过乱触发的情况。提示如果你打算自己写SKILL.md一个比较有用的判断标准是——把description拿给另一个同事看问他什么情况下你会让AI用这个技能。如果他说不准说明还要再收窄。5.3 把Superpowers当方法论来源而不是银弹最后说说心态层面的问题。我使用superpowers一段时间后最大的感受是它真正值钱的不是一次性给AI开了多少外挂而是那些SKILL.md文件本身可以被当成prompt工程教科书来读。每个官方技能背后都藏着作者在实际开发中积累的思考方式。比如它规定的审查步骤为什么是先列文件再逐个读diff、为什么不直接给你改代码、为什么输出问题清单时要带严重级别。这些设计往小了说是prompt往大了说是一套成熟的软件工程实践。我当时做的第一件额外的事就是打开几个最常用技能的SKILL.md把里面的方法论摘出来整理成适合自己团队习惯的版本然后写成自己的技能库。从那之后superpowers在我这儿不只是个工具更像是一个启动器——它的存在提醒我真正高质量的AI编程输出从来不靠撞大运而是靠可复制、可沉淀的操作流程。现在我的做法很简单日常会话保持精简技能清单遇到新场景先去翻一眼官方技能的思路再决定是直接用还是改造成自己的。这套流程试了这么久还没遇到过解决不了的问题。