最近在技术社区里“superpowers”这个词的出现频率高得有点反常。好几个群隔三差五就有人问“superpowers怎么安装”“装完到底有什么用”我一开始还以为是某个游戏Mod或者新的浏览器插件直到自己花了一下午装完、又实打实用了三周才算把这个名字叫得响的玩意儿彻底搞清楚。简单说Superpowers是Jesse Vincent维护的一个开源项目本质是一套给Claude Code这类AI编程助手准备的能力增强包业界一般叫它“Skills技能包”。装上之后AI的协作方式会发生一个很明显的转变以前它是你问一句、它答一句的被动工具现在它会主动拆解任务、写实施计划、系统排查报错、用测试验证结论甚至在动手改代码之前先跟你把方案对齐。这篇文章不打算写成README翻译稿就按“它到底是什么、装之前要懂什么、怎么装、装完能干什么、实际踩了什么坑”这个顺序把我这三周的实测体感完整交代一遍给想装还没装的朋友一个真实参考。1. 先说清楚Superpowers到底是个什么东西1.1 一个包还是一套方法论先说结论Superpowers既是一个具体的开源项目又是一套方法论的外壳。它把“AI编程助手应该怎么被使用”这件事从一堆散落在个人备忘录里的提示词变成了一个结构化的、开箱即用的技能库。项目本身由Jesse Vincent维护面向的是Claude Code这款终端里的AI编程工具。它的核心形态是一批预先写好的“技能”文件每个技能文件都是一份高度工程化的指令文档教AI在特定场景下应该用什么样的流程来干活。比如遇到bug时不要急着改代码而是先复现、再定位、再假设、再验证比如拿到一个陌生代码库时先梳理目录结构和数据流再动手写计划。这里有一个很多人会忽略的点Superpowers并不是给AI“注入”了什么新模型能力它做的是把Claude Code已经具备的能力通过更精细的提示词编排、更严格的工作流约束压榨出更高的上限。换句话说同一个模型装与不装在复杂任务上的表现差距可以非常明显。1.2 让人迷惑的项目名“Superpowers”这个名字其实相当容易引起误解。搜索这个词的时候你会碰到五六个同名项目——有一个是浏览器里的网页游戏制作工具有一个是VS Code的插件还有的是自媒体领域讲“个人超能力”的鸡汤文。而最近这波热搜“想要安装superpowers”指向的基本都是Jesse Vincent做的这个Claude Code技能包。判断是不是同一个东西最直接的办法是看它的安装方式。那个在代码圈口口相传的“一键安装脚本”装的不是游戏、不是插件而是一整套会写入你家~/.claude目录的配置和技能文件。搞清楚这个定位后面所有的安装步骤和概念都好理解了。1.3 什么样的人值得装我的看法是如果你满足以下任意两条就值得花半小时装一下试试日常重度使用Claude Code写代码、改bug、做代码审查经常接手自己没写过的旧项目需要快速理解陌生代码库习惯了让AI直接“一把梭”输出代码但发现它在复杂任务里容易跑偏在做涉及多文件、多步骤的重构或迁移希望AI能先给方案再动手反过来如果你只是偶尔用AI问几个语法问题、复制粘贴几个小函数那装上之后的效果感知不会太强。它不是那种装了就立刻“哇塞”的Demo型工具而是要在长周期、多步骤的真实任务里才能体现出价值的底座型配置。2. 装之前必须理解的三个底层概念2.1 先搞懂SkillsAI的程序性记忆Claude Code在2025年加入了一套叫“Skills”的机制你可以把它理解为AI的“程序性记忆”。平时我们给AI写提示词是告诉它“这一次怎么做”而Skill是告诉它“以后凡是碰到这类场景就按这套流程做”。每个技能在磁盘上就是一个目录里面有一个SKILL.md文件采用Markdown格式顶部带YAML格式的元信息。一个典型的技能文件长这样--- name: systematic-debugging description: 当用户报告bug、异常行为或测试失败时使用。适合需要定位根因而不是随手打补丁的场景。 --- # 系统化调试 当被要求修复一个bug时不要立刻改代码。按以下步骤执行 ## 第一步复现 先尝试稳定复现问题记录触发条件和频率。 ## 第二步定位 通过日志、调用链、二分法缩小嫌疑范围定位到具体文件和函数。 ## 第三步假设与验证 针对根因提出假设用最小改动验证而不是大范围重构。name是技能的唯一标识description则是AI判断“什么时候该用它”的依据。真正干活的时候模型会读取任务描述和所有技能的description做语义匹配命中哪个就用哪个。这个匹配过程是静默的、自动的不需要用户在对话里手敲技能名。2.2 技能文件放在哪里、怎么被加载安装Superpowers之后它的核心动作之一就是往你的全局Claude Code配置目录里批量放置这些技能文件。我机器上装完之后的目录结构大致是这样的~/.claude/ ├── CLAUDE.md # 全局引导配置 ├── skills/ # 全局技能目录 │ ├── brainstorming/ │ ├── code-review/ │ ├── systematic-debugging/ │ ├── ... │ └── system/ │ └── execute-command/ └── superpowers/ # 项目自身文件与辅助脚本这里面有一个关键细节技能存在全局目录意味着它对所有项目都生效。Claude Code在启动对话时会同时读取全局和项目本地的CLAUDE.md以及各个技能目录里的SKILL.md。全局配置负责定义“你是一个什么样的AI、遇到任务大致怎么思考”技能文件则负责在具体场景下触发具体流程。2.3 概念澄清Skills、CLAUDE.md、MCP不是一回事很多人第一次接触Superpowers时会把三个概念混在一起CLAUDE.md、Skills和MCP。这三者其实是不同层面的东西我直接用一个表说清楚机制作用层面一句话解释Superpowers主要用哪个CLAUDE.md会话记忆给AI设定全局规则、项目背景、工作习惯写入了引导配置教AI“怎么用技能”Skills程序性记忆场景化的工作流指令按需加载核心大量预置技能文件MCP外部工具连接把外部API、数据库、文件系统暴露给AI调用基本不涉及可选配合理解这个区分很重要如果你已经装了Superpowers但感觉“AI没什么变化”大概率是没意识到它的作用方式是间接的——它没有直接改模型而是改了模型在对话里会“读到什么、按什么流程思考”。也就是说它的价值完全取决于你给AI安排的任务复杂度。给AI的活儿越接近“多步骤工程任务”Superpowers的收益就越明显整天问“帮我把这段代码改成Python”那它和裸奔的Claude Code确实看不出多大差别。3. 安装教程三步装完跑通验证3.1 前置环境检查清单安装前先确认你的机器满足这几个条件能省掉后面90%的排查时间本机已装好Claude Code。Superpowers是它的增强包不是独立工具。有可用的账号和额度。安装本身不收费但后续使用消耗的是Claude Code本身的token额度。终端能正常访问GitHub或官方安装源。安装脚本要从远端拉取项目文件这一步不通后面全是白搭。Shell环境干净。建议用系统自带的bash或zsh避免用某些魔改过PATH的奇怪终端模拟器。可以用这条命令快速确认环境claude --version如果能正常打印版本号说明第一步通过。如果你还没装Claude Code先去官方渠道装好再来否则后面装Superpowers没有任何意义。3.2 执行一键安装脚本确认环境没问题后安装动作本身非常简单。到项目仓库的README页复制最新的安装命令目前官方给的主要是这一行curl -fsSL https://superpowers.obra.dev/install.sh | bash不建议对这条命令做任何“优化”。我见过有人自作主张把管道改成先下载再执行结果因为文件权限不一致反而报错。直接原样跑就行。脚本跑起来后主要干三件事在~/.claude/下创建superpowers目录并把项目本体拉进去在~/.claude/skills/下批量放置技能文件在~/.claude/CLAUDE.md末尾追加一段引导配置告诉AI“你拥有这些技能、应该怎么选择和使用它们”整个过程一两分钟就能跑完终端里会滚动输出大量文件操作日志。看到类似Installed N skills或者Setup complete的提示基本就算成功了。3.3 安装后的目录自检装完别急着开对话先花两分钟做个自检确认文件确实落位了。我建议跑这几条命令# 查看技能目录里有多少个技能 ls ~/.claude/skills/ # 确认全局引导配置是否被改写 tail -n 30 ~/.claude/CLAUDE.md # 确认项目本体存在 ls ~/.claude/superpowers/如果你发现skills/目录是空的或CLAUDE.md没有被追加内容那安装大概率没成功直接跳到第6节看排查方案。自检通过后新建一个Claude Code会话再开始用。不要在当前已经打开的会话里继续因为旧会话不会重新加载磁盘上的技能配置你会误以为装了个寂寞。3.4 升级与卸载的基本操作Superpowers迭代挺快的我用的这三周里就更新过两次。升级方式依然是重跑安装脚本它会覆盖旧文件并保留你的自定义修改前提是你不去动它写入的文件名。卸载则更简单把三个位置的东西删干净就行rm -rf ~/.claude/skills rm -rf ~/.claude/superpowers # 手动把 CLAUDE.md 里 Superpowers 追加的段落删掉注意第三节官方建议保留CLAUDE.md的备份或者安装前先复制一份。我自己第一次卸载重装时没留备份导致得手动清理那段很长的引导文本实在太痛苦。所以我的建议是任何结构性安装之前先cp ~/.claude/CLAUDE.md ~/.claude/CLAUDE.md.bak这个习惯能救你无数次。4. 核心能力拆解技能包里到底有什么4.1 核心技能清单与用途装完之后你大概会看到二十多个技能目录名字在不同版本里会有微调。我把这段时间实际用过的、感觉价值密度最高的几个列出来技能名触发场景实际价值brainstorming需要产出多个方案、发散思路强制先发散后收敛避免AI只给一个平庸方案就完事planning多步骤任务开始前先写实施计划拆出阶段目标和验收点systematic-debugging遇到bug或测试失败强制复现-定位-假设-验证而不是猜着打补丁code-review代码审查、合并前检查按安全性、性能、可维护性逐层检查出结构化报告execution计划已定、开始动手按计划逐条执行边做边汇报进度system/execute-command需要跑终端命令教会AI安全地执行shell命令、解析输出、失败后自主修整red-team需要攻击自己的设计或代码站在对立面找漏洞和边界情况防止自嗨4.2 技能选择机制它怎么知道该用哪个这个问题我问过自己很多次也观察过很多次。答案是全自动匹配不需要用户操心。Claude Code拿到你的请求后会把请求语义和每个技能文件头部的description字段做匹配。比如你说“帮我查一下这个报错是什么原因”模型就会匹配到systematic-debugging的description于是整个对话就切换到“先复现、再定位、后假设”的逻辑。如果你说“帮我看看这次提交有没有问题”它就更可能走code-review的流程。这里有个关键技巧技能的触发高度依赖description和当前任务的语义重合度所以你在提问时尽量把场景词说清楚。比如“请帮我审查一下这个PR”要比“帮我看看这段代码咋样”更容易精准触发对应技能。这也解释了为什么有些人装了之后觉得没区别——他们给AI的指令太模糊技能匹配不上自然只能退回默认的“自由发挥”模式。4.3 这些技能背后共享的工程理念把20多个技能摊开看你会发现它们不是零散的小技巧而是几条一致的工程原则在反复显形第一先计划后动手。多步骤任务开始前AI会先产出计划文件拆成阶段和检查点而不是一头扎进代码里。这个习惯帮我挡住了至少三次“改完才发现方向错了”的返工。第二结论必须被验证。不管是修bug还是做重构AI被要求给出可执行的验证方式——跑哪条命令、看什么输出、对比什么数据。它不再拍胸脯说“应该没问题”而是说“我改了哪几行、跑了哪组测试、结果如何”。第三允许AI用终端。system/execute-command这套技能让AI能在受控范围内执行shell命令、读日志、跑测试遇到失败还能自行修正重试。这意味着AI从“只写代码”进化到“写代码跑代码看结果”这个闭环才是装上之后体感变化最大的来源。5. 实战记录三周时间里我怎么用它5.1 场景一接手一个没有文档的旧服务前阵子我需要接手一个同事留下的内部服务代码量不大但是完全没有文档连启动方式都靠猜。以前我的做法是自己翻目录、看配置、猜入口通常要花一两个小时。这次我装完Superpowers之后直接在Claude Code会话里说了一句“帮我摸清这个项目的结构我要知道它怎么启动、核心模块有哪些、数据流大概是什么样。”它立刻进入了planning和brainstorming的节奏先让我确认了几个关键问题然后用execute-command技能自动列了目录树、读了关键的配置文件和入口文件最后产出了一份项目结构说明。整个过程大概15分钟比我预想快了非常多。更重要的是它产出的资料里标注了“基于XX文件推断”“这部分还需要确认”让我能清楚地知道哪些结论可靠、哪些得自己再看一眼。这种“知道自己不知道什么”的克制是裸装Claude Code很少见到的。5.2 场景二给一个复杂模块做重构另一个让我印象深刻的场景是重构一个历史债务很重的数据同步模块。这个模块逻辑分支多、测试覆盖很差直接让AI改很容易翻车。我当时的做法是明确说了“我要重构这个模块但我需要先有个方案”。这次它走的是planning加code-review的组合路径先分析模块的输入输出和所有调用方列出风险点然后产出了一个重构方案分成三阶段每阶段都配了对应的验证手段。最开始时我还觉得方案偏保守但实际执行时正是因为阶段拆得细我才能在第1阶段发现一个隐藏的边界情况及时叫停了后续动作。这个场景给我的启发是Superpowers真正的价值不是让AI写得更多而是让AI在动手前先形成“风险认知”。方案里它会明确标注“这个改动会影响到XXX调用方”“这里需要额外测试”这些判断以前都得靠我自己在脑海里过一遍。5.3 场景三批量清洗一个老仓库的杂务还有一个不那么“技术”的场景但也很有代表性。我想给一个老仓库统一整理代码格式、清理掉无用的注释和遗留调试代码。这种活儿重复度高、机械单独让AI做容易做过头——可能删了不该删的逻辑。这次我触发了execution加system/execute-command的组合。AI先扫描了全仓库的代码列表统计了哪些文件大概率能安全清理列成清单让我逐个确认然后才开始动手。整个过程里它每改完一批文件就跑一次编译检查确保没把仓库搞坏。最后我只需要审查一遍git diff而不是逐文件重新检查。这三周用下来我的整体体感是它不太会在“单点问答”上给你惊喜但在“连续性工程任务”上把AI的可用性提高了一个档次。这正好对应了我开头说的——Superpowers是一套方法论的外壳不是一颗银子弹。6. 踩坑记录安装与日常使用中的问题们6.1 安装失败的头号原因环境访问问题装Superpowers最常见的问题是跑安装脚本时卡住或直接报错。我帮两个同事排查过最终原因归结为两类一类是网络访问不到安装源。判断方法很简单先单独跑一下curl -I 安装脚本地址看返回状态如果连这一步都不通那就是环境问题代理和网络配置解决后才能继续。另一类是脚本执行权限问题。有时候你会看到Permission denied这时候不用慌可以先下载再用bash执行curl -fsSL https://superpowers.obra.dev/install.sh -o install.sh bash install.sh但注意这种方式只是排查手段有条件还是建议直接用官方推荐的管道命令。另外提醒一句不要用sudo跑安装脚本它只需要写入你用户目录下的.claude文件夹用sudo反而可能把文件Owner搞乱导致后续Claude Code读不了。6.2 技能的“不生效”其实有三种真相“我装完了但AI一点变化都没有”这大概是群里最常见的反馈。我自己排查过无数轮之后发现“不生效”基本可以拆成三种情况第一种旧会话缓存。你在安装前就开着的Claude Code会话不会重新加载新技能。这种情况最容易迷惑人我一开始就差点栽在这上面。解决办法很简单装完必开新会话。第二种任务描述与技能不匹配。正如前面说的技能是靠description语义匹配触发的。给的任务太模糊或者压根没说场景词AI根本不知道该调用哪个技能。这种情况的解法是换一种更具体的说法再问一次比如把“帮我看下这代码”改成“帮我审查这段代码的安全性和性能”。第三种配置被覆盖了。如果你之前手动改过~/.claude/CLAUDE.md再运行Superpowers安装脚本有可能会出现引导配置写入失败或新旧配置冲突。我在一次升级后就碰到过症状是技能目录都在但AI死活不按技能流程走。最后是把CLAUDE.md里那段引导配置手动重写了一遍问题才解决。6.3 多项目冲突与配置漂移如果你跟我一样在不同项目里会让Claude Code读取项目级的CLAUDE.md那就得留意一个问题项目级配置的优先级高于全局配置。某个项目里如果写了和Superpowers引导逻辑相冲突的规则比如“不要使用任何技能”“只管输出代码不要废话”那全局的Superpowers在这项目里就会被明显削弱。这不是bug而是机制设计使然。我的处理方式是在项目级配置里明确写一行“遵循全局技能选择规则”把它和Superpowers的关系从“覆盖”变成“兼容”。如果某个技能确实对这个项目不适用也可以按技能目录去做排除但那是高级玩法不建议新手一上来就折腾。6.4 token消耗是真的会涨最后说一个99%的人不会在安装文档里看到的点装上Superpowers之后token消耗会比裸装明显增加。原因很简单——它让AI在动手前多做了大量的规划、分析和验证这些“额外思考”都是要花token的。复杂任务里一次会话消耗翻倍甚至更多完全是正常现象。所以我给重度使用者的建议是把Superpowers用在真正复杂的任务上简单问题别开新会话。另外如果你用API按token计费建议在会话里通过配置对token预算做限制避免某些长任务跑飞了预算还浑然不知。我自己的习惯是凡是超过预期的长任务先让AI输出计划确认之后再让它执行这样既能控制成本也能避免它南辕北辙浪费token。装了这三周我最大的感受倒不是它让AI变“聪明”了多少而是它让AI的工程行为变得可预期了——先计划、再动手、最后验证这套流程在真实的研发协作里比任何花哨能力都值钱。如果你刚装完正在发愁“怎么感觉没区别”不妨找一个需要跨多个文件、多步骤、有验收标准的任务给它试试那种情况下你会立刻感受到区别。而如果只是日常问几个片段问题那就当它不存在也没关系它本来也不是为那种场景设计的。