最近在折腾AI编程辅助工具的路上我又发现了一个值得好好聊聊的项目superpowers。如果你已经在用Claude Code、Codex CLI或者Worbuddy这类大模型编程代理并且觉得聊天式写代码已经不够用了那这个项目大概率能帮到你。简单说superpowers是一套面向AI编程代理的技能扩展包它把提示词工程、开发流程、代码审查、测试驱动这些经验固化成了可以直接复用的规则和脚本让AI从你问一句它答一句变成你给它一个目标它按一套成熟流程自己推进。适合谁适合已经被AI编程工具钩住、但总觉得差口气的开发者也适合刚想入坑、希望一开始就建立正确使用姿势的新手。这个项目不改变你现有的工具链它做的是叠加和增强——你原来怎么用Claude Code现在还怎么用只是它的表现会明显更稳、更懂规矩。下面我从安装到实战把整个使用过程掰开揉碎了讲。1. 先搞清楚superpowers到底是什么——它解决的其实是提示词工程之外的效率问题很多人第一次接触AI编程工具第一反应是这玩意儿能不能听懂人话。用久了才发现真正的问题不是听不懂人话而是它太听话了——你让它写个登录接口它就老老实实写个登录接口不考虑异常处理、不写单元测试、不更新接口文档甚至把原有的代码风格都带偏了。问题出在哪出在缺少一套职业素养约束。1.1 技能Skills机制是怎么运作的superpowers的核心机制是技能Skills。你可以把技能理解成给AI编程代理的一份份岗位说明书。每一份说明书都规定了在特定场景下AI应该遵循什么步骤、调用什么脚本、产出什么格式的成果。比如一个创建测试计划的技能它会让AI先分析当前代码的变更范围再列出需要覆盖的测试用例最后生成一份可以直接执行的测试方案。这不再是简单的提示词模板而是带有实际逻辑的规则包。我在实际使用中最直观的感受是它的技能文件不只是一个文本提示而是能够触发具体行为的指令集。AI收到技能文件后会按照文件里定义的流程一步一步执行就像一个新员工入职时拿到一份SOP先做什么后做什么、做到什么程度算完成全都写得明明白白。这种机制的好处是你不需要在每次对话里反复叮嘱AI记得写测试记得看代码规范技能文件已经在背后帮你把这些要求全部配置好了。1.2 为什么说它是给编程助手装上外挂我自己的体会是用了superpowers之后AI编程工具的靠谱程度有了质的提升。之前用原生Claude Code写代码经常出现一种情况它确实把功能写出来了但代码质量和工程化水平明显不足。比如不处理边界条件、不写单元测试、不更新文档、不遵循项目的代码规范。这些不是AI能力不行而是你缺了一套约束它行为的机制。superpowers把行为约束做成了标准化的技能包。它里面涵盖了大量真实开发场景怎么做规格驱动开发、怎么写测试计划、怎么做代码审查、怎么重构代码、怎么分析仓库结构。每一类场景都有对应的技能文件AI遇到这些场景时会被引导执行正确流程。我打个比方原来你用AI编程工具像雇了一个脑子很好使但毫无经验的新手装上superpowers之后这个新手突然有了三年工作经验知道什么时候该问、什么时候该自己查、什么时候该写测试。这就是外挂的意义。1.3 项目整体结构与核心能力一览superpowers这个项目本身是一套开源脚本和技能文件的集合设计上特别容易上手。它最核心的部分是放置技能文件的目录里面按功能分成各种技能每个技能都是一个独立的说明文件AI编程代理通过读取这些说明文件来获得对应的能力。同时项目还附带了一些辅助脚本用来处理仓库分析、文本清理、备份恢复等任务。从使用场景来看它的核心能力我归纳为四类第一类是流程类技能负责把开发过程拆成规范的阶段动作比如从需求分析到测试计划到编码实现第二类是文件操作类技能负责让AI更好地读写、检索、重构代码文件第三类是协作类技能通过引入子代理Subagents机制让AI能在后台并行处理多个独立任务第四类是场景类技能针对具体开发场景做专项增强比如浏览器自动化、数据库操作、文档生成等。后面我会结合实际使用把这四类能力的实操方法逐个讲清楚。2. 环境准备与安装——把superpowers装进你的AI编程工作流安装这块网上能搜到不少零散的介绍但很多都语焉不详。我把自己实际跑通的流程整理出来从零开始每一步都告诉你为什么这么做。2.1 前置条件你需要哪些工具先说清楚superpowers本身不是一个独立的AI编程工具它需要依托一个主程序来运行。目前我测试过能够完美配合的是Claude Code和Worbuddy这两者都是基于大模型的编程代理工具。也就是说你的电脑上需要先安装好其中一个并且保证它能正常联网调用大模型API。操作系统的要求上superpowers在macOS和Linux环境下跑得最顺畅Windows用户可以借助WSL来使用。我个人的开发机是MacBook Pro整个安装过程非常顺利没有遇到兼容性问题。如果你的主力环境是Windows建议先搭一个WSL环境后面所有命令都在WSL里执行体验会好很多。另外要确认你的Node.js版本在18以上因为superpowers的辅助脚本依赖较新的JavaScript运行时特性。查看版本很简单终端输入node -v就行。如果版本太低建议先升级不然后面跑脚本会报各种莫名其妙的错误。2.2 安装步骤详解克隆、放置skills目录、配置CLAUDE.md安装过程本身不复杂核心就是把技能文件放到AI编程工具能读到的地方。以Claude Code为例它的技能目录通常位于用户主目录下的.claude/skills也就是~/.claude/skills。你只需要把superpowers项目里的技能文件同步到这个目录再在主配置文件CLAUDE.md里做一下引用让AI工具知道去读哪些技能说明。我实际操作时的命令是这样的# 1. 克隆项目到本地 git clone https://github.com/obra/superpowers.git # 2. 进入项目目录 cd superpowers # 3. 将技能目录同步到 Claude Code 的技能目录 mkdir -p ~/.claude/skills cp -R skills/* ~/.claude/skills/ # 4. 将项目自带的配置文件集成到你的主配置中 cat CLAUDE.md ~/.claude/CLAUDE.md这里有个细节值得注意cp复制完之后最好检查一下目标目录的文件结构确认技能文件不是被嵌套复制了。我遇到过因为多了一层目录导致AI工具根本读不到技能的情况折腾了半天才发现是目录路径多了个层级。如果你用的是Worbuddy配置方式类似只是技能目录的路径略有不同。Worbuddy会读取项目目录下的.worbuddy/skills或者也兼容~/.claude/skills这种标准位置。我的建议是你在安装前先去官方文档确认一下自己用的工具具体读取哪个路径避免复制完了发现放错位置。2.3 安装后的目录结构长什么样安装完成之后你可以快速验证一下目录结构是否正常。正常情况下的~/.claude/skills目录应该包含一系列子目录每个子目录对应一个技能。整个目录结构看起来是这样的~/.claude/skills/ ├── bug-fixing/ ├── code-review/ ├── documentation/ ├── spec-driven-development/ ├── subagents/ ├── test-driven-development/ └── ...这里我不建议你一次性把所有的技能全部启用。我踩过的坑是技能文件太多AI工具每次对话都要扫描全部技能不仅反应速度变慢有时候还会出现技能之间的规则冲突。比较好的做法是先保留几个最常用的核心技能比如规格驱动开发、测试驱动开发、代码审查用熟了之后再逐步增加。2.4 配置过程中的几个关键注意事项配置完成后有几步验证工作不能省。第一次启动AI编程代理时你要专门问一句你现在有哪些技能可用它会列出已经加载的技能清单。如果清单里没有superpowers相关的技能说明文件没放对位置或者主配置没有成功引入需要回头检查路径和配置内容。还有一个容易忽略的点是技能文件的命名要与AI工具解析逻辑匹配。比如某个技能目录下必须有一个SKILL.md文件AI工具靠这个文件名来识别技能。如果你复制的时候只拷了一部分文件缺少SKILL.md那这个技能就不会被加载。我建议你复制完成后再用find命令检查一下关键文件是否完整find ~/.claude/skills -name SKILL.md | wc -l这个命令会统计SKILL.md的总数你对照一下自己复制进来的技能数量就能知道文件是否完整。3. 核心技能拆解与实操——四个我每天都会用到的能力装好superpowers只是第一步真正让它发挥作用的关键是理解每个技能的适用场景和触发方式。这一节我重点讲四个我每天高强度使用的核心能力每一个都是实战中验证过效果的。3.1 Spec-Driven Development把模糊需求变成可执行的开发计划Spec-Driven Development规格驱动开发是我觉得superpowers里最值钱的一个技能没有之一。它解决的核心问题是AI编程工具在接到一个模糊的开发任务时常常直接开写代码写了一堆才发现理解错了需求。这个技能强制AI在开始编码之前先做需求分析、写规格说明、列关键决策、建立验收标准。整个过程就像软件开发里的先画图纸再施工。我实际使用的场景是这样的我会把产品经理发的几句话需求原封不动丢给AI比如用户可以在个人中心页面修改头像支持jpg和png格式大小不能超过2MB。在没有这个技能之前AI可能直接就生成一堆文件。启用技能之后它会先和我确认几个关键问题头像是否需要裁剪是否需要在服务端做格式校验是否需要更新用户表这些问题确认完它给出一个完整的规格文档包含需求背景、功能模块、边界条件、数据设计、验收标准然后问我规格没问题的话我就按这个开始写了。这里我强烈建议你配合项目的严格模式Strict Mode一起使用。开启严格模式后AI会严格遵循技能定义的流程不会自作主张跳过某些步骤。虽然一开始会觉得它有点啰嗦但产出质量的提升是实打实的。尤其是涉及复杂需求时这种先规格后编码的流程能把返工率降下来一多半。3.2 子代理Subagents协作让AI学会分工子代理机制是superpowers的另一个亮点。它的设计思路非常朴素与其让一个AI从头到尾处理所有事情不如把任务拆分成几个独立的子任务让AI分头去处理最后再汇总结果。你可能觉得这不就是多线程吗实际操作起来确实有类似的效果。我最常用的子代理场景是代码审查和架构分析同时进行。比如你让AI新增一个功能模块默认情况下它会写代码、自查、然后交付。有了子代理技能它会自动派生一个代码审查员子代理站在挑剔的审查者角度检查新代码有没有安全隐患、有没有违反项目规范同时再派生一个架构师子代理评估这次改动对整个系统架构的影响。这些子代理是并行运作的不会阻塞主任务的执行。从配置上讲子代理的定义在subagents目录下每个子代理都有独立的说明文件。你可以按项目的需求自定义调整子代理的定位和关注点。比如我的前端项目里就专门配置了一个UI一致性审查子代理让它检查新页面的样式是否与设计系统一致。这个功能用起来没有太多额外负担AI会自动决定什么时候该调度子代理你需要做的只是在技能文件里预先把子代理的角色定义好。3.3 上下文管理告别聊着聊着就失忆用过AI编程工具的人都有一个体会对话长度一上来AI就开始失忆前面说过的重要约束它可能突然忘了。superpowers对这个问题有一套组合拳式的解决方案包括规范化的上下文存档、项目档案管理和文档生成机制。它会在对话的关键节点自动生成文档把讨论结论、已完成的变更、待办事项记录到项目的指定文件中保证AI在后续对话中随时可以查阅。我印象最深的是它的文档汇编Docs Assembler技能。每完成一个功能模块AI会自动把开发过程中积累的信息整理成结构化的文档更新到项目的文档目录里。这些文档不仅对AI自己有追溯价值对团队成员来说也是现成的设计文档不需要额外花时间另写。这就意味着你用AI开发的时间越长项目里的文档积累越丰富AI后续的开发效率也会随之提升形成良性循环。3.4 文件与仓库操作从检索到改写的完整闭环superpowers在文件和仓库层面的操作能力也值得专门说。它提供了一套文件检索、分析、备份和重写的工具让AI能够更安全地操作代码库。比如在改动大规模代码之前AI会先做一次仓库结构分析理清模块依赖和数据流向然后再动手。这个分析过程不是简单地列一下目录树而是会生成依赖图、识别关键文件、评估改动影响范围。在使用中你会发现它对文件操作的安全性非常敏感。默认配置下涉及删除文件、批量替换、全局重命名这类高风险操作时AI都会停下来跟你二次确认并且优先采用可回滚的方案。我遇到过几次AI在重构时误伤了无关代码正是因为项目配置了文件操作的备份机制才让我能够完整恢复。这一点对于拿AI做大型项目重构的人来说价值无可估量。4. Java场景实战用superpowers改造Maven项目开发的完整流程很多人在网上搜superpowers java其实是想看看这工具在Java这种相对传统、工程化要求高的语言里到底好不好用。我用Java的时间最长对这块的感触也最深。直接说结论superpowers在Java项目里发挥的作用比在动态语言项目里还要明显因为Java项目本身对流程、规范、结构的要求更高而这些恰好是superpowers的强项。4.1 典型Java任务从需求到可评审的代码我拿一个实际场景来演示假设现在要在一个Spring Boot的Maven项目里新增一个用户积分查询接口。需求很简单——根据用户ID返回当前积分和积分明细接口路径是/api/users/{id}/points。整个过程可以分为几个阶段需求分析、规格确认、代码生成、测试编写、代码审查。第一阶段AI会先扫描项目结构确认这是Maven项目识别出Spring Boot的版本、已有的Controller/Service/Repository三层架构、以及项目的统一返回格式。这些信息它会先和规格文档里的假设比对确保自己没理解错技术栈。第二阶段AI开始整理规格入参校验规则、异常处理方案、是否要加缓存、积分明细的分页策略等。如果你没有明确指定这些AI会主动向你提问而不是自作主张。第三阶段编码实现阶段AI会严格按照项目现有的打包结构和命名规范生成新文件绝对不会出现类名随意、注释风格不统一的情况。第四阶段AI会自动为这个接口生成单元测试覆盖正常返回、参数异常、用户不存在等典型场景。第五阶段AI会对刚写的代码做一轮自查检查是否有潜在的并发问题或者数据库查询性能隐患。4.2 实操演示为现有服务新增一个接口为了让你有更具体的感知我把AI在生成代码阶段实际产出的核心逻辑概括一下。比如它写完Controller之后会在交付说明里特别提示你它做了哪些设计决定。我的经验是Java项目里AI生成的代码在能用这个层面完全没有问题真正的差别在于是否遵循项目规范。superpowers的技能文件里专门包含了代码风格一致性相关的规则比如会强制AI参考项目里已有的同类代码来对齐命名风格、返回格式、日志输出方式。举个例子假设你的项目里所有Controller都返回一个统一的结果类Result 而没有superpowers时AI很可能生成一个裸的ResponseEntity。有了superpowers之后AI会先读现有的Controller代码提取Result类的用法再照葫芦画瓢应用到新接口上。这种基于项目现状进行编码的能力是它与普通提示词最大的区别。我建议你在项目根目录专门维护一份PROJECT.md把项目特有的约定、技术选型、目录结构、编码规范写清楚。superpowers的执行流程里有一个环节就是读取这类项目文档你在里面写清楚什么它就越贴近你的预期。这个文件不需要写得很长但信息要对格式大致如下项目技术栈、分层结构、命名约定、常见异常处理方式、测试要求。4.3 Java开发者最容易踩的坑和解决思路Java项目用superpowers的时候有几个坑值得单独提一下。第一个坑是构建工具识别不准确。如果你的项目是用Gradle构建的而AI默认按照Maven的思路处理会出现依赖文件改错的问题。解决思路是在PROJECT.md里明确指出构建工具和版本AI在执行过程中会优先读取这些信息来调整自己的操作方式。第二个坑是Java版本与代码特性的匹配。比如项目还在用Java 8但AI基于自身知识生成了Java 11的var关键字或者List.of方法编译直接报错。这个问题我在刚开始用的时候经常遇到。后来我在PROJECT.md里明确写了maven.compiler.source和maven.compiler.target是1.8AI生成代码时就会避开高版本语法。你不需要懂原理只需要让AI知道你项目用的Java版本是哪个它就会自动约束代码风格。第三个坑是测试框架版本差异。JUnit 4和JUnit 5的注解和断言写法完全不同如果AI用了错误的版本测试跑不通是小事误导你排查方向才是大麻烦。技能的自动化流程能在动手之前先识别项目里的测试依赖版本再据此生成匹配的测试代码。我在使用中确实遇到过AI默认输出JUnit 5代码的情况但因为技能流程先做了分析后来生成的代码全部是JUnit 4风格运行一次全过。5. 与Worbuddy等工具的联动配置最近不少人在问Worbuddy怎么用superpowers这个组合确实值得好好说一说。Worbuddy本身是一个轻量级的AI编程代理和Claude Code定位类似但在安装方式和协作机制上各有侧重。superpowers的设计并没有绑定特定工具它通过标准的技能目录规范实现兼容因此可以灵活接入多个工作流。5.1 Worbuddy是什么怎么和superpowers配合简单来说Worbuddy是一个能运行在你本地项目里的编程代理它的特点是可以更自然地读取项目上下文而且交互方式更适合在IDE里嵌入使用。superpowers为它提供的是专业能力增强层。两者配合起来实际效果是Worbuddy负责和项目仓库对话、执行命令、调整文件superpowers负责告诉Worbuddy在具体场景下该用什么专业流程。一个管执行一个管方法论各司其职。我在Worbuddy里启用superpowers的时候没有做任何代码层面的改动只需要让Worbuddy能够读取~/.claude/skills目录即可。因为Worbuddy在设计时就兼容了Claude Code的技能目录规范所以superpowers复制进去之后Worbuddy启动时会自动扫描并加载这些技能。5.2 联动配置实录具体操作上Worbuddy的配置入口一般是一个配置文件在项目根目录或者用户主目录下。你需要在配置里确认技能读取路径是否包含了~/.claude/skills。如果默认没有包含手动加进去就行。改完配置重启Worbuddy然后在对话里输入列出你当前可用的技能它会把加载到的superpowers技能列出来。看到列表就说明联调成功了。这里我想多讲一个细节Worbuddy和Claude Code对技能文件中技能名称字段的解析逻辑略有不同。Claude Code主要读取文件名而Worbuddy还会解析技能文件里的name字段。所以如果你遇到Claude Code里能用的技能在Worbuddy里不生效大概率就是这个字段缺失或者命名不规范导致的。解决办法是在每个技能文件的元数据区检查一下name字段是否填写并且和目录名保持一致。这个细节网上很少有人提我踩过这个坑之后专门记了下来。5.3 工具链的取舍建议同时装了Claude Code和Worbuddy之后我的使用习惯是日常开发主用Worbuddy因为它轻快、和IDE集成得好适合高频的小步快跑式编码做重大架构调整或者复杂需求拆解时我会切回Claude Code配合superpowers的规格驱动开发技能把整个流程完整走一遍。这种双工具策略让superpowers的价值得到了最大化发挥也避免了对单一工具的过度依赖。如果你只选一个工具我建议根据你的工作习惯来定。喜欢在终端里直接对话、希望流程感更强一些的选Claude Code更喜欢在IDE里开发、希望AI辅助尽量隐形一点的选Worbuddy。无论选哪个superpowers在技能层面的增强效果都是实打实的。6. 常见问题与排查技巧实录说实话再好的项目安装和使用过程中都会遇到问题。这一节我把实际使用中碰到的问题和对应的排查思路整理出来。我尽量直接给结论不绕弯子。6.1 问题速查表症状可能原因解决办法AI工具对话中没有显示superpowers技能技能目录放错位置确认技能文件在~/.claude/skills下而非嵌套的二级目录技能列表出现了但具体技能不生效技能文件缺少SKILL.md元数据检查技能目录结构是否完整补充缺失的SKILL.md文件启用技能后AI响应明显变慢技能加载数量过多精简技能文件只保留高频使用的几个技能运行辅助脚本时报Node版本错误Node.js版本过低执行node -v确认版本升级到18以上生成代码不符合项目规范缺少项目文档约束在项目根目录建立PROJECT.md写明技术栈和编码约定Worbuddy中技能未按预期工作元数据name字段缺失检查技能文件里的name字段并确保与目录名一致6.2 排查思路与日志技巧当你发现superpowers某功能不工作时第一反应不要去改AI提示词先查技能文件是否被正确加载。我在排查时最常用的调试命令是让AI自己描述执行过程。你可以直接问你刚才执行这个任务时用了哪些技能执行到哪一步停止的AI会把它调用的技能文件和执行阶段完整说出来问题往往就暴露在某个具体阶段上。比如它告诉你我在生成测试计划阶段技能库中没有找到测试计划技能那你立刻就能判断是技能文件缺失而不是流程配置问题。另一个实用技巧是开启工具的调试日志模式。Claude Code和Worbuddy都有日志开关打开后你可以看到命令执行过程中读取了哪些文件、调用了哪些脚本。有一次我怀疑AI根本没有读取我配置的PROJECT.md日志里一看果然它只扫描了根目录文件名没有读取文件内容。问题找到了解法是在技能文件里加一条开始任务前必须读取PROJECT.md全文的规则此后这个环节再也没漏过。6.3 实操中总结的几条独家心得最后再分享几条我自己用出来的心得算是在这个项目的实际操作中沉淀下来的经验。第一条技能文件不是越多越好。我一开始把所有技能全部装上结果发现AI在处理简单任务时也要做一大堆不必要的分析。后来我把技能精简到五六个核心项反而觉得AI的反应速度和完成质量都提升了。工具是死的使用策略是活的不要让工具绑架你的效率。第二条让AI记录决策过程。我习惯要求AI在完成每一个小任务后把关键决策和改动摘要写入一个CHANGELOG.md文件。这个习惯让我的项目维护成本显著降低一个星期后回头看当时的改动所有逻辑一目了然。这对AI也是正向反馈它在后续开发中会更注重保持决策记录的一致性。第三条善用暂停确认机制。面对高风险操作我会在技能配置里要求AI在执行删除文件、批量替换这类操作前暂停并把影响范围解释清楚再继续。有不少开发者担心AI乱改代码造成不可逆的破坏而配置了暂停确认机制之后你的控制权始终在手里AI再怎么激进也不会造成灾难性后果。这也是我敢放胆让AI做大规模重构的前提。这套工具链用顺之后我最大的感受是写代码的重心开始从敲键盘转向做决策和设计。AI负责按流程执行我负责在关键节点拍板和验收。如果你也在高强度使用AI编程工具正为它不够职业而头疼建议认真试一试superpowers它会让你对AI编程的体验有明显改观。