这段时间好几个群都在聊 superpowers起因多半是某个视频里演示了一下代码写到一半IDE 自动补全测试、自动修 Bug、自动生成提交信息整个过程顺畅得像开了外挂。很多人第一反应是“这又是什么新工具”但其实它是 VS Code 里面一套扩展技能包的统称核心思路是把 AI 编程助手的常用能力拆成一个个“技能”skills然后通过指令直接调用。如果你已经装了 GitHub Copilot 或者类似插件但觉得用起来不够顺手——比如会写代码但不会写测试会补全但不会重构或者压根不知道还能让它解释报错、生成命名、优化逻辑——那这套东西大概率能解决你的痛点。这篇文章不会跟你讲什么玄乎的“AI 革命”就老老实实说清楚superpowers 到底是什么、里面有哪些 skills、怎么把它装进 IDE、怎么在实战里用起来以及我踩过哪些坑。1. 先搞懂 superpowers 到底是什么1.1 它不是替代品而是 Copilot 的“能力扩展层”很多人误以为 superpowers 是某个独立的 AI 模型或者新的编程助手。实际不是。它更像是在 VS Code 和 GitHub Copilot 之间加了一层“技能管理层”。打个比方Copilot 本身像一个“什么都会一点但不会主动干活”的实习生你问一句它答一句你不问它就闷着。而 superpowers 给这个实习生装了一套“任务执行手册”把常见的开发动作——写测试、找 Bug、解释代码、生成提交信息、重构逻辑——全部预定义成标准流程。你只需要告诉它“用哪本手册”它就能按手册里的步骤一步步把活干完而不是每次都要从零组织语言。这个定位决定了它的安装逻辑。你不需要额外配置什么模型密钥也不用离开 VS Code 去另一个网页工具只需在 VS Code 里装好扩展它自动复用 Copilot 的底层能力。也就是说你身边已经有了 AI 能力但之前不会系统调度superpowers 补齐的正是这套调度方案。1.2 一个命令搞定所有技能调用我最早看它的 README 时第一感觉是“项目描述写得真克制”列表干干净净就列了十几个技能点。真正让我觉得有价值的是它的调用方式所有技能都通过一个统一的命令入口触发。具体来说装好扩展并重启 VS Code 后你用快捷键CmdShiftPWindows 上是CtrlShiftP打开命令面板输入“Superpowers”就能看到所有可用命令。比如想生成测试就执行Superpowers: Generate Tests想解释选中代码就执行Superpowers: Explain Code想查找并修复 Bug执行Superpowers: Find and Fix Bugs这种设计的好处很明显你不需要记忆一大堆 prompt 模板不用背“请用 Jest 框架为下面这个函数写单元测试包含边界条件注释要详细”这种话术直接用命令即可剩下的事情交给技能内部预设的 prompt。尤其对不擅长写 prompt 的开发者来说这相当于把“和 AI 对话的技巧”做成了菜单点单就行。1.3 为什么我建议你把它当成“AI 助手使用指南”还有一个容易忽略的价值superpowers 的源码本身就是一套极好的“AI 编程 prompt 参考”。每个技能对应一个 Markdown 文件里面写满了人类专家总结出来的提示词模板。比如“Generate Tests”这个技能它的 prompt 不是简单一句“写测试”而是包含了测试框架识别、代码上下文提取、边界情况检查、断言风格统一等一堆细节要求。我自己后来甚至把它当成学习材料来用遇到 AI 输出质量不稳定的场景就去翻对应技能文件里的 prompt看它是怎么组织约束条件的。这个方法比网上那些零散的“AI 提示词技巧”实用得多因为那是有具体场景、经过实战检验的逻辑。2. 拆解核心superpowers 到底有哪些“技能”2.1 分成三大类代码编写、修复改进、解释梳理我翻遍项目的文档和源码把技能大致整理了一下。虽然具体版本之间可能有一点差异但核心能力基本是这几块技能名称所属大类核心作用典型使用场景Generate Tests代码编写自动生成单元测试写完一个函数后需要快速补测试Find and Fix Bugs修复改进定位并修复代码问题测试跑挂或逻辑有误Explain Code解释梳理用自然语言解析代码逻辑接手别人代码、Code ReviewGenerate Commit Message代码编写生成规范的提交信息提交代码时懒得起标题Refactor Code修复改进重构选中代码或整个文件想让代码结构更清晰Generate Documentation解释梳理生成 README 或代码文档开源项目补文档Generate Naming代码编写生成变量、函数、类名起名困难症晚期患者Generate Checks修复改进为代码追加条件检查和防御逻辑处理输入校验、空指针等表格整理出来的好处是直观但我要提醒一句上面这些并不是把所有能力都列完了。因为项目迭代很快而且技能列表是异步加载的新版会持续增加。我建议你装好以后直接在命令面板里输入“Superpowers”把菜单翻一遍以眼前看到的为准。2.2 每个技能背后都是结构化 Prompt什么叫“结构化 Prompt”我拿 “Generate Tests” 举例。如果你自己对着 Copilot 说“帮我写测试”它可能生成一堆可用但不完整的东西——测试覆盖不全、没考虑边界、甚至用了错误的断言风格。而 superpowers 内部预设的 prompt 会包含当前文件的编程语言和测试框架识别选中代码的上下文提取要求覆盖正常情况、边界情况、异常情况断言风格跟随项目已有代码生成的测试代码需要可读、可维护每一步都有明确的指令约束AI 的输出自然更稳定。这就是为什么很多人装了 superpowers 之后觉得“AI 好像突然变聪明了”——其实模型没变但指挥模型的方式变了。2.3 自定义技能也保留了口子superpowers 的设计没把话说死它允许你把自定义技能加进skills/目录。网上也有人维护了第三方技能库把后端代码审查、前端组件生成这些高频动作做成独立技能文件。我自己的做法是把公司内部常用的代码规范写进自定义技能比如“生成接口代码时必须包含参数校验和错误码定义”然后在团队里推广。这个扩展性我觉得才是它的真正护城河——不是几个人写死一套能力而是形成了生态。你哪天发现某个操作反复做、AI 每次都要从头引导就可以考虑写成自定义技能一劳永逸。3. 实操全过程从安装到真正用起来3.1 安装前先确认环境动手之前先把环境要求说清楚。虽然项目本身叫“superpowers”但它是以 VS Code 扩展的形式存在依赖 VS Code 内置的 GitHub Copilot Chat。所以你要同时满足下面这几个条件已安装最新版 VS Code建议 1.90 以上老版本可能缺少部分 API已安装 GitHub Copilot Chat 扩展并且账号登录正常VS Code 里能正常使用 Copilot 对话功能新用户有试用额度第一项和第二项是最容易出问题的地方。我见过有人卡在“扩展装好了但命令面板搜不到”多半是 Copilot 没登录或者登录态过期。所以装 superpowers 之前建议先在侧边栏打开 Copilot Chat 随便问一句“你好”确认它能正常回复再继续。3.2 装扩展的两种方式第一种方式是 VS Code 市场直接装。打开扩展面板CmdShiftX搜索“superpowers”找到作者是dz4的那个扩展认准全名 “Superpowers”别下成别的同名扩展点 Install装完重启 VS Code。第一次装完如果命令面板搜不到不要慌CmdShiftP输入 “Reload Window” 重载一下窗口一般就能解决。第二种方式是源码安装适合想看看内部实现或者二次开发的人。先git clone项目到本地然后在 VS Code 里打开项目目录按F5进入扩展开发调试模式。这种方式的好处是你能直接修改 skills 目录下的 prompt 文件写完代码不用重启整个 VS Code调试窗口里重新加载即可。但坏处是每次要开两个窗口日常开发还是用正式安装版更省心。3.3 三种调用方式我建议你挨个试一遍调用的核心入口是命令面板但它不是唯一方式。我用了一段时间总结出三种方式的使用心得方式一命令面板调用。最正统、最稳。选中代码——可以是几行表达式也可以整个文件——然后CmdShiftP输入技能名回车。适合两种情况一是你不太记得技能名想翻菜单找一找二是不需要把技能绑到某个固定快捷键上偶尔用一次。方式二右键上下文菜单调用。在编辑器里选中代码后右键会看到 “Superpowers” 子菜单里面列了所有适用当前代码的技能。这个方式极大减少操作路径日常使用频率最高。它可以理解为“选中即上下文关联”AI 知道你选了什么生成的针对性会强很多。方式三Chat 里面用斜杠命令调用。打开 Copilot Chat 面板输入/skill-name比如/generate-tests或/find-bugs它会以当前打开的编辑器文件作为上下文来执行。我通常是在处理大型项目时用这个不用切来切去对话和生成结果都在同一个面板里。3.4 第一次实战用三分钟给一个函数补全测试说这么多理论不如直接演示。我拿一段很常见的 JavaScript 函数举例function calculateDiscount(price, quantity) { if (price 0 || quantity 0) { return 0; } const total price * quantity; if (total 1000) { return total * 0.1; } else if (total 500) { return total * 0.05; } return 0; }这是一个典型的“满减打折”函数总价满 1000 减 10%满 500 减 5%无效输入直接返回 0。我选中这个函数后在命令面板执行Superpowers: Generate Tests。选择测试框架为 Jest它会根据项目自动识别如果没有 package.json 会自动问一次确认后等待几秒一个完整的测试文件就生成了。生成结果大致长这样describe(calculateDiscount, () { test(applies 10% discount for totals 1000, () { expect(calculateDiscount(100, 10)).toBe(90); }); test(applies 5% discount for totals 500, () { expect(calculateDiscount(60, 10)).toBe(30); }); test(returns 0 for invalid inputs, () { expect(calculateDiscount(-1, 10)).toBe(0); expect(calculateDiscount(100, 0)).toBe(0); }); });注意几个细节第一个用例我用100 * 10 1000验证了满千打折期望返回1000 * 0.9 900但上面示例里我故意写了一个互补的100*10验证方式实际生成的用例可能略有不同但覆盖点几乎一致——正常边界、满千打折、非法输入。这个覆盖度说实话我自己手写可能也就这样。3.5 提交代码和写文档这两件事顺手到上瘾除了测试还有两个技能我觉得是“用了就回不去”的那种。一个是Generate Commit Message。以前提交代码最烦的就是英文描述写什么现在选中改动的文件执行命令它会根据 diff 内容生成一条简明扼要的提交信息。我测过几次基本不需要大改像feat: add discount calculation logic这种格式直接就能用。它对规范 Git 提交历史帮助很大尤其团队有 commit 规范要求时省去了很多抠字眼的时间。另一个是Generate Documentation。项目写多了总有一些小工具不愿意加注释但 README 又没人写。选中整个文件或者一个模块运行这个技能它会生成包含功能说明、用法示例、参数表格的文档大纲。你只需要在此基础上微调一下语气和细节比从零写快得多。4. 常见问题与排查技巧实录4.1 命令面板里搜不到任何 Superpowers 命令这是遇到最多的一个问题基本就三个原因按顺序排查扩展没真正装上。打开扩展面板确认状态是“已启用”如果显示“已禁用”或“未安装”点一下启用或用官方市场重装。Copilot Chat 没登录。右下角或者侧边栏打开 Chat 面板看一眼是不是要求登录。很多人会遇到登录态过期重新登录一次通常就恢复了。窗口没重载。装完扩展不用重启电脑但要重载 VS Code 窗口CmdShiftP执行Reload Window就行。这条路径可以解决九成以上的“装好后没反应”问题。4.2 生成的代码风格跟项目不一致superpowers 生成的代码是“通用风格”不会自动学习你们团队的代码规范。比如你们的代码用单引号它默认可能生成双引号你们的测试框架是 Vitest它可能先入为主用 Jest。我的处理办法是把团队的规范直接写进自定义技能。把下面的内容放进skills/目录下的对应技能文件里优先使用单引号 测试框架使用项目已有的框架优先检测 vitest.config.ts 生成代码前先读取项目根目录的 .editorconfig 或 .prettierrc改完之后生成结果的贴合度立刻上了一个档次。这个操作成本很低见效很明显强烈建议你花十分钟改一改。4.3 长代码生成总是中途断掉或质量变差技能输出质量差多数情况是上下文碎片化导致的。比如你选中的不是完整函数只选了中间几行AI 缺少前后依赖关系自然生成不准。我的使用习惯是选中整个函数或整个文件再执行技能。如果你只想处理某一段逻辑至少要把那段逻辑赖以存在的上下文比如参数定义、数据流一起选进去。还有一个辅助办法——把其他无关代码先折叠起来减少干扰。4.4 生成结果太“话痨”注释比代码还多superpowers 默认生成的代码往往带不少注释这是 prompt 策略刻意为之——它认为新代码需要引导阅读。但实际项目里注释过多本身就是一种视觉噪声。我个人的处理方式比较粗暴直接对生成结果丢一个format code或者“移除冗余注释”的指令再用一次技能把代码“瘦身”。或者你在自定义技能文件里加上一句“注释只在需要解释业务逻辑时书写不需要给每行都加注释”AI 会更收敛。4.5 技能用多了会“越权”修改你的文件这也是一个需要时刻记住的坑superpowers 的部分技能比如 Refactor Code、Fix Bugs可能会直接改写当前文件。如果改错了你的撤销历史不一定能完整恢复尤其改了多个文件后撤销路径会变得混乱。所以我的习惯是执行任何带“修改”属性的技能之前先手动把当前文件复制一份到临时目录或者用 Git 暂存当前改动。等你确认生成结果没问题再决定是否保留。这话听起来像废话但真的能救你一命——我至少有过两次“它把正确代码改成错的了幸好我有备份”的经历。5. 进阶玩法让 superpowers 真正融入你的工作流5.1 把高频技能绑成快捷键命令面板方式平时用没问题但高频操作还是快捷键给力。VS Code 里打开keybindings.json添加上面这几行{ key: cmdshiftg, command: superpowers.generateCommitMessage }, { key: cmdshiftt, command: superpowers.generateTests }, { key: cmdshifte, command: superpowers.explainCode }这样写代码时选中函数直接CmdShiftT就生成测试提交前CmdShiftG自动起好提交信息。高频操作变成肌肉记忆后体验会再上升一个层次。5.2 把“复盘”也交给 AI除了写代码我发现用Explain Code来复盘自己的旧代码也特别有意思。选中三个月前写的模块让它解释一遍经常能听到“这段代码其实可以压缩成更简洁的逻辑”之类的建议。这种“事后审查”视角对提高代码水平帮助不小等于免费请了个随时在线的 Code Reviewer。我自己设定了一个每周流程周五下午把本周写的核心模块挨个跑一遍Explain Code把 AI 指出的可疑逻辑记下来周一上班再集中处理。这个习惯坚持了三周代码质量和自我复盘效率都有明显改善。5.3 结合自定义技能沉淀团队经验最后讲讲自定义技能的潜力。团队里最有价值的东西往往是人脑里的经验比如“数据库查询必须加索引”“接口入参必须校验长度”“错误信息必须包含请求 ID”。这些规则写进文档大概率吃灰但写进 superpowers 的自定义技能AI 每次生成代码时都会自动带上。我目前的实操是在skills/下新增了一个team-rules.md里面列了六条团队铁律然后把自定义技能配置成“生成任何接口代码前都要检查并提醒这六条”。这样既不会强制拦截导致工作流中断又能让 AI 在关键时刻帮你把规范“提起来”。是的它更像一个“规范提醒器”而不是“规范执行器”但已经比纯粹靠人记要强太多了。写在最后superpowers 不是什么神秘外挂它只是把“用 AI 写代码”这件事从野路子变成了系统化操作。真正让它有价值的一是一系列针对性极强的技能命令二是它提供了自定义技能的扩展机制让每个团队都能把自身经验沉淀到工具里。如果你目前只是把 Copilot 当自动补全用强烈建议花一个下午装上 superpowers 把里面的命令挨个过一遍大概率会觉得“之前浪费了不少时间”。按我个人体验从装好到完全融入工作流大概需要两三天。这段时间踩过坑、遇到过报错、也改过自定义技能但整体回报是实打实的——写测试不再拖沓提交信息不再临时憋词接手旧代码也多了个耐心解释的帮手。