第一次听说“Superpowers”的时候我以为是某个游戏模组或者程序员中二病发作的产物。后来在一次关于AI编程助手的讨论里才发现这其实是一套相当硬核的开源技能集专门给Claude Code这类AI编程工具用的。简单说你平时是“给AI下达一句提示词让它自己发挥”而Superpowers则是“把资深工程师的工作方法打包成一个个标准化的技能让AI按这套流程来干活”。它解决的痛点非常直观AI写代码越来越强但很多人用起来总感觉“不稳”——有时候它直接开写跑偏了才知道有时候问一堆问题却迟迟不动手有时候改了一个bug又引出一堆新bug。这些问题的根源往往不是模型不行而是我们没有一个稳定的工作流程约束它。Superpowers就是一套把“头脑风暴—制定计划—测试驱动—系统调试—代码审查”这些成熟工程实践做成标准技能的方案。适合谁用只要你在用Claude Code或者对Agent Skills机制感兴趣都值得花半小时装一套试试。1. 先说清楚Superpowers到底是个什么东西1.1 它不是某个单点功能而是一整套“技能集”很多第一次接触Superpowers的人都会下意识问它是一个命令一个插件还是一个提示词模板准确地说它是一个以“技能”Skills形式组织的开源项目仓库里包含了一组互相配合的Markdown技能文件每个技能都有明确的触发条件、执行步骤和输出要求。这套技能基于Claude Code的Agent Skills机制。简单理解每个技能就是一个放在特定目录下的文件夹里面有一个SKILL.md作为主文件用来描述这个技能的用途、适用场景和操作步骤。Claude Code在运行时会读取这些描述根据当前任务自动匹配合适的技能或者在你显式要求时调用它。Superpowers的特别之处在于它不是把一堆零散技能随便丢给你而是按“一个完整工程任务的生命周期”来编排的。从最开始的需求发散到中间的实现计划再到具体的编码、调试和审查每个环节都有对应的技能兜底。也就是说它试图把一位经验丰富的工程师处理任务时脑中走过的流程固化成了AI也能照做的标准动作。1.2 为什么AI编程需要“技能化”而不是单纯靠提示词这个问题我琢磨了很久。以前我们调教AI靠的是写一大段提示词比如“你先分析需求再写测试最后实现代码”。问题是提示词是一次性的换个会话就没了而且AI很容易在后面某个步骤“忘记”你前面定的规矩越跑越偏。技能化解决的是这两个问题。第一技能是持久化文件每次会话都能加载不需要重复输入。第二技能内部的流程是结构化的AI会按SKILL.md里的步骤逐条执行而不是靠上下文里的一句叮嘱撑着。你可以把它理解成给实习生一套标准作业指导书而不是每天早上口头交代一遍。对AI来说一套写清晰的技能文件比一段“你好好干”的临时提示词可靠得多。Superpowers在这一点上做得尤其彻底它不只给AI一个“建议”而是给一整套完整流程。比如调试技能它会明确要求AI先复现问题、记录当前行为、构造最小化用例然后再开始猜测原因。这种“强制流程”看起来很死板但实际跑起来能非常有效地减少AI那种“想到哪改到哪”的毛病。2. Superpowers里到底有哪些skills2.1 从工作流上分思考、计划、实施、修复Superpowers里的技能不是平级堆叠的而是围绕一个任务的自然推进顺序组织的。如果你把一次开发任务拆开看大致会经历四个阶段先想清楚要做什么再规划怎么做然后动手实现最后是验证和修复。Superpowers覆盖的就是这些阶段。在“思考”阶段它提供了头脑风暴类技能用来帮助你澄清需求、探索设计空间、识别风险和边界情况。到了“计划”阶段它能把模糊的目标拆解成可执行的步骤并输出一份可以被审查和修改的实现计划。进入“实施”阶段它强调用测试驱动开发也就是说先写一个会失败的测试再写让它通过的实现最后重构。而在“修复”阶段它提供系统化调试技能避免AI靠灵光一现瞎猜乱试。当然除了这些核心工作流技能仓库里通常还会包含代码审查、重构、写作辅助等周边技能。具体清单会随版本迭代变化但主线思路基本保持一致让AI每一步都像一个有经验的工程师那样经过思考、做出计划、稳扎稳打地执行而不是跳步。2.2 几个核心技能具体能干什么我先挑几个最常用、也最能体现Superpowers设计思路的技能展开说说。头脑风暴技能通常会在任务目标还不够清晰时触发。它会引导AI先提问题把模糊表述变成明确需求。比如你说“我想加一个用户排行榜”这个技能会要求AI先搞清楚排行榜按什么维度排、数据从哪来、更新频率多高、需不需要分页。这些信息没弄明白之前它不会急着给方案。实现计划技能则是把确认后的需求转换成一份分步计划。它会输出类似“第1步设计数据模型第2步编写查询接口第3步实现前端展示第4步补充测试”的清单并标注每一步的产出物。这份计划不是摆设AI之后会尽量按照计划推进你做代码审查时也有据可依。测试驱动开发技能大概是整个技能集里最能改变使用习惯的一个。它要求严格按“红-绿-重构”循环来先写出一个失败测试再写最简代码让它通过然后回头优化代码结构。这个技能会约束AI不要跳步尤其不允许“先写一堆实现然后补一个测试交差”这种本末倒置的做法。系统化调试技能则专门针对棘手的Bug。它会强制流程先复现问题然后建立“当前行为”和“期望行为”的对比再通过二分排除法缩小范围确认根因之后才动手修复。调试结束后它还会要求补充回归测试防止同类问题再次出现。这一套流程虽然看起来慢但对付复杂问题反而最节省时间。3. 安装与引入技能从零开始复现3.1 安装前的环境准备在动手装Superpowers之前你至少需要准备三样东西一个可用的Claude Code环境、Git、以及一个存放技能文件的目录。先确认Claude Code版本足够新因为旧版本可能不支持Agent Skills机制。在终端里输入下面命令检查版本claude --version如果你的版本偏旧建议先升级。接着确认你当前用户目录下有.claude这个配置目录。技能默认放在~/.claude/skills/下面如果你之前没配置过目录可能还不存在可以手动创建mkdir -p ~/.claude/skills还有一个容易被忽略的点不同平台下用户目录路径不一样macOS和Linux通常是/Users/你的用户名或/home/你的用户名Windows下则是用户主目录。先确认路径再继续否则技能装完了也认不到。3.2 安装Superpowers的主流方式我在实际安装中用的最多的是“目录直装”方式。思路很简单把Superpowers仓库拉下来然后把里面每个包含SKILL.md的子目录放到~/.claude/skills/下。我第一次图省事直接把整个仓库克隆到~/.claude/skills/superpowers结果Claude Code把它当成一个零散目录里面嵌套的技能根本没被识别。后来才明白技能识别的粒度是“包含SKILL.md的目录”不是仓库本身。我实测下来比较稳的做法是分两步走。先把仓库完整克隆到一个临时目录再把技能文件复制过去git clone --depth 1 https://github.com/obra/superpowers /tmp/superpowers cp -r /tmp/superpowers/skills/* ~/.claude/skills/这里假设仓库里的技能都统一放在skills子目录下。如果你拉取的版本结构有变化就打开仓库看一眼把那些包含SKILL.md的文件夹都复制到~/.claude/skills/的根目录下即可。复制完成后可以检查一下目录结构是否类似这样~/.claude/skills/ ├── brainstorming/ │ └── SKILL.md ├── implementation-planning/ │ └── SKILL.md ├── test-driven-development/ │ └── SKILL.md └── systematic-debugging/ └── SKILL.md另一些较新版本也支持通过Claude Code的插件机制安装。大致是在会话里添加插件市场然后安装对应的Superpowers插件。插件方式的优点是更新比较方便但对初学的人来说透明的目录结构反而更好排查问题。我的建议是第一次先用手动目录方式跑通了理解了这个机制再考虑要不要切到插件方式。3.3 怎么确认你的技能真的被识别了装完之后最重要的一件事是确认Claude Code真的看到了这些技能。最直接的办法是新建一个会话输入一个能触发某技能的任务观察它的行为模式。比如你可以说“我现在有一个需求不太清晰想先梳理一下再做请使用头脑风暴技能帮我问清楚问题。”如果它开始连续追问需求细节而不是直接给方案说明技能已经生效。还有更稳妥的方式是让AI列出它能看到的技能清单。通常在会话里这样问“你当前加载了哪些可用的技能请列出技能名称和用途。”如果它回答说没有找到任何技能那问题多半出在目录结构或路径上。别急着继续先回上一步检查。我遇到过最傻的情况是复制技能时手滑多建了一层目录导致所有SKILL.md都藏在二级子目录里Claude Code当然一个都认不出来。4. 实际操作把Superpowers用起来4.1 在会话中引入技能的正确姿势很多人装完技能后反而不知道怎么在日常编码里“使唤”它们。其实核心原则很简单要么让AI根据任务自动匹配技能要么你显式指定技能。自动匹配依赖技能描述写得是否精准。比如你遇到一个报错AI读到了“systematic-debugging”这个技能描述发现其适用场景是“定位复杂Bug、行为异常排查”它就可能自动加载这个技能然后按照里面的流程展开调试。显式指定则适合你已经有明确想法的时候。比如你就想让它按测试驱动开发的流程来写一个功能不要自由发挥那直接在任务描述里点名“使用test-driven-development技能来完成这个功能先写测试再写实现过程中不要跳步。”注意即使点明了技能也不代表AI一定会严格照做。如果它在执行过程中明显偏离了流程比如直接甩出一大段实现代码你需要立刻打断它重申“按照技能的步骤来”。技能工具不是魔法它是一份规则文档规则需要人去监督执行尤其在使用初期。4.2 一个完整的TDD演示场景为了让你对这个流程有更直观的感受我以“实现一个数组去重函数”为例描述一下典型过程。如果没有TDD技能AI可能直接给出一个用Set实现的函数然后你说“不错”。但有了TDD技能的约束它会按下面这套节奏走。第一步它会先和你确认函数的行为边界“输入[1, 2, 2, 3]应该返回什么遇到NaN怎么处理是否保持原有顺序”然后它会把这些问题固化成测试用例并先写一个测试文件。此时测试就是红色的因为目标函数还不存在。第二步它会写一个最简实现让刚好能通过测试。这里的关键是“最简”不要加额外特性不要提前优化。比如用Set去重看起来简单但如果你要求保持原顺序那它可能还需要调整写法。第三步测试变绿之后它才会进入重构环节清理重复代码、优化命名、调整结构。整个过程是严格分阶段的。你会明显感觉到AI不再是一次性把代码怼给你而是一步步带着你走就像有人在你旁边监督流程一样。4.3 调试类技能的使用心得调试技能是我个人觉得最值得单独拿出来讲的一个。以前用AI调试我习惯直接贴报错信息然后问“为什么出错”。AI通常会给出三五个可能原因然后你来回测试。碰上简单问题还好碰到诡异Bug就是灾难。用了Superpowers的系统化调试技能之后我发现流程变了。它不会第一时间猜原因而是先要求我提供一个能稳定复现问题的步骤或测试。如果复现不了它会建议我补充日志把现场信息抓全。然后它会要求我明确“期望行为”和“实际行为”的差异再开始切割问题的范围。印象很深的一次一个偶发性的内存问题我和AI来回搞了很久没头绪。它按调试流程帮我列出了所有可能的影响因素然后建议用二分法逐步屏蔽代码块最终定位到一个异步时序问题。这个思路本身我自己也知道但关键在于技能把这种思路变成了显式执行的步骤AI每一步都按步骤来不东一榔头西一棒子。这个价值比它直接说出答案大得多。5. 常见问题与避坑手册5.1 技能没生效问题出在哪我在不同机器上装过好几次Superpowers也帮同事排查过总结下来技能没生效的原因就这几类。路径不对是最常见的问题。技能目录必须是Claude Code实际扫描的位置通常是~/.claude/skills/。我见过有人把技能装进了项目目录下的.claude/dev/那当然不会全局生效。如果你只想让某个项目使用特定技能就要看项目级配置是否支持。目录层级错也很常见。记住一个规则技能目录的下一层应该直接是SKILL.md。像~/.claude/skills/superpowers/skills/test-driven-development/SKILL.md这种三层嵌套很容易让Claude Code只识别到顶层导致你点名“test-driven-development”时找不到对应技能。解决办法是把技能文件平铺到~/.claude/skills/根目录下。还有一个容易被忽略的问题技能描述冲突。如果你同时装了多个技能它们的描述内容过于相似AI可能匹配到错误的技能。遇到这种情况要么精简技能数量要么手动修改SKILL.md里的描述让它更精准。5.2 版本更新与目录冲突Superpowers迭代速度不算慢技能的定义和步骤可能随版本调整。手动复制方式最大的麻烦在于更新旧版本时老的技能文件不会自动清理新旧混在一起可能导致行为不一致。我的建议是更新时别图省事直接覆盖而是把旧的技能目录先清空再把新版本复制进去。比如rm -rf ~/.claude/skills/superpowers* cp -r /tmp/superpowers/skills/* ~/.claude/skills/当然删之前先确认你有没有在这个目录下放自己写的其他技能。如果你在Superpowers的基础上做过自定义修改覆盖前一定记得备份自己的改动。多人协作时更要注意最好把技能目录纳入版本管理不然每个人机器上的技能版本都不一样复现问题时会很痛苦。5.3 想自己改造一套Superpowers用熟练之后你大概率会想动手改技能。这是很自然的过程因为Superpowers本质上就是一堆Markdown文件没有黑魔法。你可以直接打开某个SKILL.md修改步骤描述、增加检查项、调整输出格式。我自己第一次改的是调试技能的流程把“记录环境信息”这一步加了进去并要求AI在修复后写出总结。改完之后它的调试输出明显更适合我复盘。这里给你一个建议不要一上来就大改先小步试。比如先只修改一个技能的描述开头确认Claude Code能识别再慢慢调整步骤细节每改一次就在实际任务中验证一次。还有一个更进阶的玩法以Superpowers为模板创建你自己的技能库。如果你发现某个任务反复需要AI按特定流程执行比如“提交代码前的检查流程”完全可以照葫芦画瓢写一个新的SKILL.md放进~/.claude/skills/。这样一来你就不再只是Superpowers的使用者而成了技能本身的维护者。我个人的体会是装好Superpowers只是第一步真正改变使用体验的是你愿不愿意去理解并维护这套技能。它把AI从一个“聪明但随性”的助手慢慢塑造成一个“遵守工程纪律”的搭档。偶尔它执行得比预期死板那通常是技能本身需要调整而不是AI变笨了。多跑几个真实任务把不顺手的地方改掉你会慢慢找到适合自己的工作流。