8月底那天晚上我把Claude Code升级到最新版本之后干的第一件事就是安装一个叫superpowers的开源插件。当时圈子里很多人都在聊它我一开始真没太当回事觉得无非又是一个“更全能的提示词合集”。结果一个下午用下来我发现自己对“给AI配技能”这件事的理解确实过时了。这个项目不是塞给你几百条咒语而是给Claude装上了一整套真实的skills——能做头脑风暴、能出实施计划、能写代码、能自己审代码、能修bug、还能事后复盘。这篇就当成一份安装和使用笔记来写重点覆盖三件事它到底有哪些skills、怎么把技能引入到自己的Claude Code里、以及装完之后你的工作流会发生什么变化。不管你是刚接触Claude Code的新手还是已经用它写了一阵子代码的老手只要觉得现在这种“你问我答”的单线程模式有点不够劲那就值得往下看。1. 为什么需要Superpowers裸Claude Code的技能短板先聊一个很多人忽略的问题默认状态下的Claude Code其实并不缺“聪明”它缺的是“章法”。1.1 裸Claude Code更像“临时工”不是“项目搭档”如果你只用默认对话模式跟Claude Code打交道你会发现一个很明显的感受每一轮对话都像临时找了个人来干活。你交代一句它就闷头执行一句上下文稍微长一点它就容易跑偏换一个新会话它又把你之前说过的话全忘了。原因倒不复杂。默认模式下Claude是拿着你当前这轮prompt去直接生成回复的它没有一个稳定的“工作框架”来约束自己先做什么、再做什么、做完之后要检查什么。遇到复杂任务比如“帮我重构这个模块”它可能会直接开始写代码但并不会先确认接口边界、不会考虑测试覆盖、不会反思这个改动会不会影响其他调用方。这种体验用一句话概括就是干活的意愿很强但干活的方式很随缘。我见过不少朋友抱怨Claude Code“会用但不好用”其实问题就出在这。模型本身的能力已经够了缺的是把能力组织成流程的那层胶水。1.2 Skills机制到底是什么给Claude预设“肌肉记忆”Claude Code从某个版本开始支持一种叫做skills的能力扩展机制。你可以把它理解为给Claude准备了一叠“工作说明书”和配套工具脚本放在约定的目录里。当任务命中某个技能的场景时Claude会主动把对应的说明书读出来按里面的步骤和要求去执行。这个机制本身其实挺早就有了但真正把它玩明白的是superpowers这个项目。它不满足于给你三五个零散技能而是把一整条软件开发流程都编码进了skills里从最初的需求发散、到方案设计、到动手实现、到代码审查、再到bug修复和事后复盘每个环节都有对应的技能文件。你不需要在一段话里把需求说得天衣无缝只需要给出目标Claude会自己判断当前应该调用哪个skill来推进。我自己的理解是裸Claude像一个工地上的临时工你指哪儿他打哪儿而装了superpowers的Claude像是一个带着SOP和工具箱进场的资深工程师他会先看图纸、再动工具、最后还会检查自己的施工质量。这个差别用过一段时间之后会特别明显。顺带说一句很多人会把skills和MCP混为一谈其实这两个不在一个层面。MCP解决的是“Claude能不能调用外部数据源和工具”的问题比如查数据库、调浏览器skills解决的是“Claude用什么方式、按什么流程完成任务”的问题。superpowers专注在后者所以它并不需要你做额外的MCP配置装完就能跑。2. Superpowers内置Skills全景一次看懂它到底给了Claude什么装完superpowers之后我做的第一件事就是让Claude把目前可用的skills列出来。它像报菜名一样给我报了一串当时我还有点懵但真正摸清每个技能的用途之后就会发现这套东西的分工其实非常清晰。2.1 从Brainstorm到Implementation的完整工作流superpowers最有价值的一点是它把“从想法到落地”的全过程拆成了几个相互衔接的技能阶段。正常情况下你给它抛一个需求它会按顺序走下面这一套Brainstorming先跟你把需求聊透。它会围绕目标提出一系列问题比如“你希望解决的核心痛点是什么”“这个功能的使用频率和场景是什么”“有没有参考实现”。这个阶段它的角色是提问者帮助你把模糊的想法收束成一个明确的问题定义。Creating a Plan问题定义清楚之后它会把实现路径拆解成一份计划包含任务列表、阶段目标、涉及的文件和接口。这相当于写了一份可执行的施工方案。Implementing a Change计划确认完它才开始动代码。这一步它会按计划逐项落地并且通常会同步维护相关文档和测试。Code Review实现完成后它会切换到审查者视角把刚写的代码重新看一遍指出潜在的边界问题、性能隐患和可维护性坑点。Fixing Bugs如果review阶段发现问题或者运行时报错它会进入修bug模式系统性地定位根因而不是瞎猜。Reflection最后做一个简短的复盘总结这次变更里哪些地方做得好、哪些做法效率不高。我第一次看到这个流程时的感觉是这不就是正规研发团队的标准工作流吗确实如此。它本质上就是把一份“软件工程方法论”做成了几个可以随时调用的技能包让Claude不要跳过规划直接写代码也不要写完就跑。2.2 其他你可能会用到的高频技能除了上面这个核心开发工作流superpowers还自带了一些实用技能我挑几个常用的列在下面技能典型触发场景实际效果Brainstorming需求模糊、方案不明确通过连续提问帮你收敛想法Creating a Plan任务复杂、涉及多文件输出结构化的分步实施计划Implementing a Change开始写代码/改代码按计划落地并更新文档Code Review代码写完后需要自检以审查者视角发现问题Fixing Bugs程序报错、逻辑异常系统定位根因并验证修复Reflection一次完整任务结束时复盘过程并沉淀经验Processing有大量文件、文档要归纳批量读取并整理信息Next Steps任务完成后不知道做什么基于现状给出后续行动建议Inbox Zero待办和消息堆积时帮你整理收件箱和待办清单需要说明的是Claude并不会死板地要求你按顺序把每个阶段走完。它会根据任务的复杂度和你的要求去裁减流程。比如你只是让它改一个变量名它不会非要先来一场头脑风暴。但如果是“帮我搭建一个完整项目”这种粒度那它基本会把这套流程走全。2.3 关键特性技能是“代码”而不是“提示词”superpowers让我服气的还有一个原因它的技能不只是文字说明而是背后有真实脚本的。按照官方说法一个skill可以包含SKILL.md描述文件和对应的脚本程序脚本可以用TypeScript等语言实现。这就带来一个质的区别纯提示词方案的问题在于“每次发挥不稳定”可能这次效果好下次同样的词效果就跑偏了。但用代码实现的技能行为是确定的、可复现的——它说要做代码审查就会真的去调用文件读取、静态分析这些工具而不是靠嘴输出一段“我觉得这里该优化”的泛泛而谈。这也是为什么superpowers推荐你“放心让Claude自己选技能”因为它选完之后背后是一套实际在工作的程序和工具链而不是换了个说话腔调。3. 安装Before You Start版本、环境与两种安装方式对比如果你看到这里已经动心了那接下来这部分可以照抄。我装的时候踩了几个不算深但很烦的坑提前说明白能省不少时间。3.1 前置条件检查清单首先superpowers对Claude Code版本有要求。我装的时候要求至少是v2.2.2以上如果你版本太旧命令跑起来会直接报提示让你升级。顺手也检查一下Node版本官方建议用22以上。我之前在一台Node 18的机器上试技能脚本跑起来就不太利索切到22之后就没再出过幺蛾子。claude --version node -v在终端里先确认这两项再继续下一步。如果你平时用nvm管理Node版本记得切到项目目录或者全局的22版本再启动Claude Code。3.2 方式A插件市场安装适合长期使用我个人最推荐的是走Claude Code的插件市场因为后续升级维护都省心。大致步骤如下在终端里运行claude进入Claude Code交互界面。输入下面的命令把superpowers的marketplace添加进来/plugin marketplace add obra/superpowers-marketplace添加完成后再输入安装命令/plugin install superpowerssuperpowers-marketplace按照提示确认启用插件并根据需要安装默认的skills集合。装完之后Claude Code的单斜杠命令列表里会多出对应的管理入口你可以随时查看已安装的插件状态。我这边装完看到默认的skills文件夹已经自动铺到了对应目录里说明安装是成功的。3.3 方式B通过npx快速体验如果你不想走插件市场只是想先快速体验一把官方也提供了npx方式。开发者在项目根目录执行对应命令之后superpowers会以“配置向导”的身份出现帮你把skills准备到当前环境里然后你回到Claude Code的对话里告诉它“use your superpowers”就行。两种方式我建议这样选想长期、稳定地用就优先插件市场只是想花十分钟尝鲜、看看它长什么样那npx方式更轻量。我个人装机时是先用了npx体验确定要正式引入项目之后又回到插件市场装的算是把两条路都走过一遍。提示如果安装过程中遇到网络拉取失败的情况最省事的做法是检查终端代理或干脆过几分钟重试不要在一个错误上反复挣扎。3.4 装好的第一件事验证技能是否生效很多人在这一步犯迷糊装了半天不知道自己到底装没装上。装完后的第一个动作我建议直接在Claude Code对话里输入列出你现在可用的skills如果它像模像样地把brainstorming、plan、implementation这些技能名报出来就说明技能已经生效。我还会顺手加一句“请使用你的superpowers来处理”这是一个很直接的调用信号让Claude明确切换到增强模式。4. 第一次实战让Superpowers带着你开发一个“番茄钟”小工具纸上谈兵没意思。为了验证这套东西到底值不值我拿了一个最常见的需求来跑开发一个网页番茄钟。结构不复杂但足够体现整个工作流的变化。4.1 先别急着让它写代码这里我想特意提醒一句装了superpowers之后哪怕明知最终要写代码也先克制住直接让它“写一个番茄钟”的冲动。因为这套技能最大的价值恰恰在写代码之前的那几步。我的实际操作是先跟Claude说了一句“我想做一个网页番茄钟帮我从零开始做”。然后它没有立刻打开编辑器一路狂写而是先触发了Brainstorming技能抛给我一连串问题你要纯前端还是要带后端存储番茄时长想设定成固定的还是可配置的需不需要统计和图表界面风格有偏好吗是否要考虑移动端说实话第一次被这么“盘问”的时候我有点不耐烦。但冷静下来想想这些问题如果等代码写完再发现改造成本就大了。尤其是“可配置时长”和“本地存储”这两个需求如果不是它先问了一句我是不会主动想起来的。我的建议是在这个阶段你不需要答得特别细甚至可以对大部分问题回答“你来定就好”。它的作用是帮你把需求关键分支过一遍而不是真的要你当产品经理。4.2 完整对话现象记录我大致描述了我想要的形态之后它进入了下一阶段—— Creating a Plan。这时候它给我输出了一份实施计划包括页面结构、功能模块、文件清单、技术选型建议以及一个简单的时间线。这份计划贴在那个状态窗口里我当时的反应是这比我带过的实习生写的方案还规整。我确认计划之后它开始调用Implementing a Change。具体动作包括创建了项目目录、写好了HTML骨架、补上CSS样式、实现了JavaScript逻辑、加了一个README.md说明文档。期间它还会自己停一下确认某些实现细节比如“倒计时的精度我用requestAnimationFrame处理可以吗”。这种“边说边干”的节奏确实很接近真人协作了。更让我意外的是它进入Code Review阶段后的表现。代码跑通之后它主动回头审查了一遍自己的实现指出一个问题如果我切换了浏览器标签页setInterval会被浏览器节流导致倒计时不准。它随即进入Fixing Bugs环节把时间计算改成了基于时间戳差值的实现。这一步如果是裸Claude Code多半要等我自己发现bug后再次提给它去修而它现在是自己发现问题、自己修。整个过程走完它还做了次简短的Reflection跟我总结说这次实现里基于时间戳的计时方案是更稳妥的选择以后做类似功能可以直接沿用。你看它甚至把通用经验都提取出来了。4.3 过程中可能遇到的卡点这个流程也不是完全一帆风顺。我遇到的一个问题是如果任务比较简单它依然会保持“先问几步再动手”的节奏效率看着有点慢。解决办法也很简单在指令里明确告诉它“不要问太多直接按最佳实践实现”它就会自动跳过头脑风暴阶段进入快速实施模式。skill机制本身是有弹性的具体路径取决于你在对话里的反馈。还有个容易卡住的点是磁盘权限。如果项目放在系统保护目录下创建文件时会报权限错误。把项目放到用户目录下运行基本就能绕过去。5. 把Superpowers变成自己的自定义Skills与团队共享用了一段时间之后你会发现最有意思的部分不是装好的现成技能而是它提供的这套框架允许你往里面塞自己的技能。这部分的灵活性才是superpowers真正值钱的地方。5.1 Skill文件长什么样一个技能本质上是放在skills目录下的一组文件核心是SKILL.md里面用固定的格式描述技能触发条件、用途和使用步骤。目录结构大致长这样skills/ └── daily-report/ ├── SKILL.md └── scripts/ └── generate_report.pySKILL.md的开头需要几个关键字段技能名称、触发描述、允许使用的工具列表。描述写得好不好直接决定Claude会不会在合适的时机主动调用它。我自己的经验是描述里要把“什么时候不该用”也写清楚否则它会在一些八竿子打不着的任务里也试图触发这个技能。5.2 写一个最简单的“日报生成”技能假设你希望Claude帮你根据今天的git提交记录生成一份日报。你可以在.claude/skills/daily-report/SKILL.md里这样写--- name: daily-report description: 根据当前git仓库的提交记录生成今日工作日报。当用户要求写日报、总结今天工作、汇总git log时使用。 allowed-tools: - Read - Bash --- # Daily Report ## 使用步骤 1. 运行 git log --sincetoday --prettyformat:%h %s 获取今日提交。 2. 对提交信息进行分组整理。 3. 按“功能开发 / Bug修复 / 其他”分类输出日报。然后在scripts/里放一个实际生成报告的脚本也行不放脚本、只靠Claude执行命令也可以。技能描述足够清晰时Claude会自动按步骤执行。我自己写的第一个自定义技能就是这么跑起来的整个过程不到十分钟。5.3 Skills要不要进Git仓库这个我建议分场景看。放在~/.claude/skills里的技能属于个人全局技能任何项目都能用放在项目根目录.claude/skills下的技能则应该随项目走因为它通常和当前项目的上下文强相关。对团队来说项目级的skills目录天然适合入库。只要把.claude/skills提交到git仓库组里所有人clone下来之后Claude Code都能自动读到这些技能。这就等于把你的团队规范、代码约定、发布检查清单全都变成了AI的标配行为。我目前最想做的就是把团队的code review检查项写成一个skill让大家提交代码前让Claude先用这套标准过一遍。6. 用了一个多月之后几个最值得说的坑和调优现在superpowers已经在我日常开发环境里跑了一个多月。新鲜感褪去之后它的一些边界和问题也暴露出来了说几个我认为最有参考价值的。6.1 别让自主性变成失控什么时候值得关掉skills这套机制最大的优点——自主性同时也是它最大的风险点。有一次我只是想让它帮我算一个简单的字符串长度结果它也非要按完整流程来先问我的使用场景再给我列方案。这种时候就很膈应。后来我学到的经验是给它一个明确的范围开关。简单问答类请求直接在指令开头带上“本次不使用skills直接回答”工程类任务才让它完整发挥。另外如果你开了某些“无限制模式”的增强设定Claude会更激进地自主行动建议日常开发保持默认配置就好否则它会做一些你可能没预期到的额外操作比如自动给你装依赖、自动创建文件。6.2 token与成本的观察必须实话实说完整走一遍superpowers工作流消耗的token比普通单轮对话要多不少。一次中等复杂度的功能开发可能要比裸模式多用一部分上下文量。原因也很直观它要读技能说明、要写计划、要审代码、要复盘每一步都在消耗上下文。我的应对策略是分级使用小改动、临时脚本、快速验证走普通模式新项目搭建、模块重构、代码审查才全量开启skills。你把它当成一个“全流程咨询顾问”而不是所有问题的默认答案生成器性价比就会健康很多。6.3 三个我实际踩过的坑列一下我踩过、而且大概率你也会遇到的三个问题版本不匹配导致脚本报错如果技能脚本执行时出现奇怪的报错优先检查Claude Code版本和Node版本。我经历过一次Node 18环境下脚本崩溃的情况切到22之后一切正常。旧技能干扰新技能如果你之前往skills目录里放过同名技能superpowers安装后可能会冲突。排障时先看看~/.claude/skills和项目.claude/skills下面有没有重名文件。它做出你没要求的改动自主模式下它可能会顺手“帮”你重构了某段你没提到的代码。代码审查时如果发现无关改动直接让它剥离别不好意思。给它清晰的变更边界是长期稳定使用的前提。说实话用了这一个月之后我已经回不到裸模式了。倒不是说裸Claude Code不能用而是体验过“有人帮我把流程兜着”的感觉之后再回到全凭自己盯紧每一步的状态总觉得少了点什么。对于用Claude Code做正经开发的人来说这套技能集合值得花一个晚上装好、试透再按自己的习惯调教一遍。它能稳定复现的那套工作流才是它真正让你“拥有超能力”的地方。