最近圈子里聊 AI 编程绕不开一个词skills。如果你用的是 Claude Code 或 Cursor 这类能执行任务的 agent 工具应该已经体会到光有一个聪明的大模型还不够它还得会拆任务、查文件、跑命令、改代码。superpowers 就是冲着这件事来的——它不是某个单一插件而是一整套打包好的技能库装完之后AI 助手能按项目流程干活而不是每次都临场发挥。我自己也是从“在对话里反复调教 AI”的阶段过来的。一开始让 AI 改个 bug得先描述背景、给文件路径、贴报错、说清楚期望结果最后还得祈祷它别把其他地方改坏。后来用了技能库整个体验完全不同我只需要说“请用 superpowers 帮我处理”它会自己启动一个工作流先读代码、再给计划、逐步执行、最后自查。这篇就把我实际安装和使用 superpowers 的过程完整写出来把“具体使用”“有哪些 skills”“怎么引入这些技能”这些问题一次性说透。1. 先搞清楚superpowers 到底解决了什么问题1.1 AI 助手的“知识”和“技能”是两回事很多人第一次接触 skills 时会有一个误解大模型已经什么都会了为什么还需要额外装技能这里的关键区别在于大模型拥有的是“知识”而不是“可执行的流程”。举个例子。你让一个刚毕业的实习生“把这个接口加个鉴权”他可能知道 JWT、OAuth、Session 这些概念但你如果不告诉他项目里用的是什么框架、鉴权中间件放在哪、代码风格是什么他一定会按教科书里的标准做法来结果大概率和你现有代码完全对不上。AI 助手在没有 skill 时也是这个状态——它知道很多但它不了解你的项目约束也没有一套固定的执行步骤。skills 本质上是“提示词 规则 可选脚本”的打包体。它把某个场景下的最佳实践写进结构化的说明里让 AI 按固定的流程走。superpowers 的定位更进一层它不只是几个零散技能的集合而是一个带“总调度”的技能体系由核心 skill 分析你的意图再决定调用哪些子技能去配合完成。1.2 它适合谁解决什么痛点如果你属于下面这几种情况superpowers 大概率值得一试经常用 AI 写代码但每次都要花很长一段话解释上下文需要 AI 做代码审查、写测试、补文档这类“流程性”的工作希望 AI 不是一上来就改代码而是先读代码库、出方案、再动手团队里想沉淀一套统一的 AI 辅助开发规范。我见过很多团队把 AI 当成“更快的搜索引擎”只用来问问题和生成零散代码片段。这样不是不行但浪费了 agent 工具最大的优势——执行能力。superpowers 解决的核心痛点就是把 AI 从“聊天机器人”变成“按流程办事的执行者”。2. 想安装 superpowers先把环境准备好2.1 依赖环境清单我在安装前花的十分钟都在排查环境这里先列一个检查单避免你走弯路Node.js 版本建议 18 及以上。superpowers 的很多脚本依赖现代 JavaScript 语法版本太低会直接报错Git部分安装方式需要 clone 仓库Git 是必须的支持 agent 的终端工具Claude Code 或 Cursor 均可。我这里以 Claude Code 为例网络连通性安装过程需要访问 GitHub 或插件市场确保终端能正常 clone 和拉取更新。检查版本用两个命令node -v git --version如果 Node 版本过低我建议直接用 nvm 安装一个 LTS 版本别用系统自带的旧版。装完记得重开终端让 PATH 生效。2.2 安装路线一通过插件市场直接引入这是最省事的方式也是我目前日常使用的方式。在 Claude Code 的终端会话里直接执行插件市场命令/plugin marketplace add obra/superpowers执行完之后再安装插件本体/plugin install superpowers安装成功后会看到一次确认信息然后重启一次会话让技能目录重新加载。重启后可以用下面这个命令检查插件是否生效/plugin list如果列表里出现 superpowers就说明核心编排技能已经被加载了。这条路径适合绝大多数用户因为后续更新也简单重新进入会话执行一次插件更新命令即可。需要说明的是不同版本的 Claude Code 对插件命令的命名可能略有差异如果你在指令补全列表里看不到上面的命令可以输入/plugin查看当前版本支持的子命令。以你实际环境里的帮助提示为准。2.3 安装路线二手动 Clone 到本地技能目录如果你不想依赖插件系统或者你用的是 Cursor 这类不支持/plugin命令的工具也可以手动安装。先把仓库克隆到本地git clone https://github.com/obra/superpowers.git然后把skills目录里的内容复制到你自己工具的技能目录。Claude Code 一般会从~/.claude/skills目录读取技能其他工具可能不一样建议先确认配置路径。mkdir -p ~/.claude/skills cp -r superpowers/skills/* ~/.claude/skills/复制完之后重启工具随便打开一个项目会话输入“列出你能用的技能”如果能弹出 superpowers 的技能清单就说明手动安装成功了。我最初就是走这条路线装的好处是对目录结构心里有数以后想加自定义技能可以直接扔进去。坏处是更新得自己git pull不像插件市场那样一键搞定。3. superpowers 有哪些 skills完整盘一盘3.1 核心编排技能才是灵魂装完之后你打开skills目录会发现里面有很多子目录每个目录对应一个 skill。但所有技能里最核心的是同名的superpowers主技能。这个主技能的作用是“编排调度”。当你提出一个任务时它不会直接动手而是先做三件事分析任务类型是写新功能、修 bug、做重构还是要写文档决定子技能组合匹配最合适的几个技能来协同完成输出执行计划先在对话里把步骤列出来征求你的确认后再动手。这个设计非常像项目经理的角色。好处是 AI 不再一上来就改代码而是先跟你对齐思路避免方向错了白干。3.2 高频技能清单与适用场景我按工作阶段整理了一份比较有代表性的技能清单方便你对号入座工作阶段对应技能实际作用需求澄清brainstorming把模糊想法拆成具体问题生成功能要点技术方案architecture分析现有代码结构设计实现路径任务规划planning把大任务拆成可执行的小步骤编码实现implementation按计划逐文件生成或修改代码测试驱动tdd先写测试用例再实现功能保证覆盖率问题排查debugging定位报错原因分析日志提出修复建议代码审查code-review检查代码质量、边界条件、潜在风险文档输出documentation生成 README、接口文档和变更日志发布流程release整理版本号、CHANGELOG、发布清单这些技能不是摆设我自己用得最多的是brainstorming、tdd和code-review。特别是brainstorming以前我总习惯直接让 AI 写代码结果经常写完再推倒重来。现在先让它问几个澄清问题把边界条件理清楚后面实现的返工率低了很多。3.3 组合使用一次复杂任务由多个技能接力单个技能再强也是单点能力。superpowers 真正值钱的是主技能会自动把多个子技能串成工作流。举个例子我想给现有项目加一个“数据导出”功能。在没有超能力的情况下我可能要分五次对话先说需求再让它看代码再让它写实现再让它补测试最后再让它审查。用了 superpowers 之后一条指令就能触发完整链路superpowers主技能会先调用brainstorming澄清导出格式和范围再用architecture找到现有导出逻辑的接入点然后用tdd先写测试用例最后实现功能并调用code-review自查一遍。这条链路不用我手工控制全程在对话里自动推进。中间任何一步你觉得不对都可以打断让它调整。这种“控制权在自己手里、执行细节交给 AI”的体验是我愿意继续用它的最大原因。4. 具体使用怎么把你的需求变成 superpowers 的执行计划4.1 最直接的触发方式使用 superpowers 不需要学一套新语法你只要在对话里明确提到它并给出一个具体任务就行。我常用的触发句式是请使用 superpowers 技能帮我实现一个用户反馈接口包含字段校验和错误处理。如果当前项目上下文信息不足主技能会主动询问或先扫描项目结构。你可以在指令里补充“先分析一下项目结构再给方案”这样它会更稳妥。有一个小技巧任务描述越接近“目标 约束”效果越好。比如“给订单模块加一个取消接口需要校验订单状态并且只有未支付订单能取消”。这个描述就比“加一个取消订单功能”清晰得多。4.2 手动调用某个具体技能有时候我不想走完整编排流程只想单独用某个技能完成一个环节。比如我改完一个文件只想让它审查代码不想让它动代码。这时可以显式指定技能名称使用 code-review 技能检查 src/services/order.ts 这个文件重点关注异常处理和边界条件。如果你的工具支持斜杠命令也可以直接输入/code-review类似的命令入口。不同工具对技能引用的语法不完全一样但大方向一致把技能名说清楚AI 就会优先匹配对应的 skill而不是自由发挥。我实际踩过的一个坑是早期我分不清“显式调用技能”和“对话中说请帮我检查代码”的区别。前者会让 AI 严格按照技能里的步骤走后者则可能只是临时扮演一个审查者的角色深度完全不一样。如果你发现 AI 的行为太随意记得检查自己有没有把技能名说清楚。4.3 一次完整实操给现有代码库加接口这里记录一次我最近做的实际任务给一个 Node.js 项目新增POST /api/feedback接口用于提交用户反馈。首先我输入了这样一段需求使用 superpowers 技能。项目是 Node.js Express请先了解项目结构然后为反馈模块新增一个接口POST /api/feedback请求体包含 content、rating、contact需要做字段校验保存到内存数组。先出计划再实现。superpowers 的第一个响应是输出执行计划大概分为四步分析现有路由结构、创建反馈模块、接入路由、补充基础测试。我确认计划后它才开始动手。执行过程中有几个细节值得注意它先读取了package.json和routes目录确认使用 CommonJS 还是 ESM以及现有路由的注册方式实现完成后它主动提议补一个简单的接口测试不是等我提要求最后它又自动运行了一次node -c之类的语法检查来避免低级错误。整个过程大约十分钟。我没有写一行代码但每一步都在对话里留下了可审查的记录。最后我自己 review 的时候改了变量命名和校验正则其他内容基本可以直接用。如果你也想复制这个流程核心诀窍只有一个第一句话就让 AI 进入“先计划、后执行”的模式。superpowers 的设计刚好就是做这件事但前提是你别跳过确认计划的步骤。让 AI 一口气全部做完确实爽但一旦方向错了返工成本比慢一点高得多。4.4 怎么引入自己团队的技能和规范官方技能之外superpowers 是支持自定义技能扩展的。如果你团队有自己的一套开发规范比如 commit 信息格式、代码风格要求、发布流程你完全可以把它写成一个自定义 skill放进技能目录。最简单的格式是创建一个文件夹里面放一个SKILL.md文件用 Markdown 描述这个技能的使用场景和执行步骤。例如--- name: team-commit description: 按照团队规范生成 git commit message --- ## 步骤 1. 执行 git status 和 git diff --stat 查看变更 2. 根据变更类型选择 feat、fix、refactor 等前缀 3. 生成符合团队模板的 commit message保存后重启工具这个新技能就会被加载。之后你在对话里说“用 team-commit 技能帮我提交代码”它就会按你写的规范执行。这也是我后来最推荐大家投入时间的地方直接用别人的技能当然方便但把自己团队的最佳实践沉淀成自定义技能才是把 superpowers 价值最大化的路子。5. 使用中常见的坑与排查技巧实录5.1 安装后找不到 superpowers很多人在安装后遇到的第一个问题就是明明装成功了但在对话里提到 superpowers 却毫无反应。先检查插件是否真的被加载执行/plugin list或查看 skill 目录下有没有对应文件。如果插件列表里没有大概率是安装命令没有真正执行成功重新执行一次即可。如果列表里有但对话不响应优先重启终端。还有一种情况是权限问题。有些系统上Claude Code 读取~/.claude目录时会受到文件权限限制。你可以用ls -la ~/.claude/skills检查目录是否可读如果权限有问题就chmod -R urwx修复。5.2 触发了 AI 却不按技能流程走我遇到过的最诡异的情况是明明说了“使用 superpowers”但 AI 还是直接写代码完全无视计划。排查后发现是我把技能名放在了指令中间被长上下文中其他的指令给稀释了。现在我的做法是把“使用 superpowers 技能”放在最开头并且单独成句。其次是任务描述要具体尤其是“先出计划再实现”这类控制指令一定要显式说清楚。AI 是概率模型你不提的关键约束它很可能就默认跳过。如果说了还是不听可以试着先用一句话单独确认“请先使用 superpowers 分析我的需求然后输出计划等我确认后再执行。”把这个确认动作前置基本能避免 AI 自作主张。5.3 多个技能互相冲突怎么办默认配置下superpowers 会加载全部技能但这并不意味着所有技能都适合你的项目。比如一个纯前端项目根本不需要数据库迁移相关的技能一个内部脚本项目也不需要发布流程。技能多并不会让 AI 变笨但确实会增加误匹配的概率。我现在的做法是只保留核心编排技能 每周真正会用的三四项技能其余从技能目录里移到备份文件夹需要时再放回来。这样既减少了干扰也让主技能的选择更精准。5.4 权限与安全纪律必须提前定好由于 superpowers 会驱动 AI 读取文件、执行命令、修改代码安全纪律一定要前置。我给自己定了三条铁律这里直接分享不明来源的仓库不要用完整流程先关掉高风险技能AI 要执行写操作、删除操作、安装依赖这类命令时必须停下来等我批准涉及密钥、环境变量、生产数据的操作一律先做脱敏。如果你用的是团队项目最好在.claude配置里维护一份允许/禁止的技能清单避免任何成员在一个不安全的环境下开启全部技能。工具的便利性和安全性永远是跷跷板你多留一分心就能少踩很多坑。5.5 更新 superpowers 后有些技能失效有一段时间我频繁git pull更新技能库结果发现某个自定义技能总是覆盖掉官方同名文件。后来我把自定义技能全部移到了一个独立的custom-skills目录并在配置里指定加载路径才彻底解决冲突。如果你是插件市场安装的更新后偶尔也会碰到技能缓存问题。遇到这种情况重启工具基本能解决如果还不行删掉旧的技能目录重新安装一次大概率会恢复。别害怕重装技能本身没有状态重装不会损失你的项目代码。最后再分享一点个人经验用了这段时间 superpowers我最明显的变化不是代码写得快了而是我越来越清楚“什么时候该让 AI 动手”。以前我总是希望 AI 一口气把整个功能写完结果经常在细节上翻车。现在我会先让它出计划、拆步骤每一步都把住方向执行变成体力活思考留在自己这边。如果你也想试我建议先挑一个小项目装好之后只保留核心编排技能和 code-review、tdd 这两个高频技能先把流程跑通。等你熟悉了它的工作方式再慢慢加其他技能甚至开始写自己的自定义技能。工具是好工具但真正让你变强的是你怎么用它来沉淀自己的工作流程。