如果你最近在折腾 Claude Code大概率刷到过 superpowers 这个项目。它不是某个单文件脚本而是一整套可安装、可扩展的 skills 技能库目标就是给 AI 装上超能力——拿到任务先规划、写代码先测试、出 bug 先定位。这项目在 GitHub 上热度一直很高作者是 Jesse Vincent一个混迹开源圈多年的老手。今天这篇文章我就把自己从安装、引入到实际使用的全过程整理出来顺便把里面到底有哪些 skills、每个技能怎么触发、踩过哪些坑一次说清楚。不管你是刚接触 Claude Code 的新手还是已经在用它写业务代码的老手只要你想让 AI 干活更稳、更有章法这篇内容应该都对你有用。1. superpowers 到底是个什么东西定位与设计思路1.1 它是技能包不是工具链很多人一看 superpowers 这个名字第一反应是又一个 AI 编程工具。实际用下来你会发现它更像是一个装满了 Markdown 文件的技能包只不过这些 Markdown 不是给人看的文档而是给 Claude尤其是 Claude Code看的操作手册。这个项目的核心是基于 Anthropic 提出的 Agent Skills 规范。简单理解每个技能skill就是一个带格式说明的 Markdown 文件里面写清楚了你在什么场景下应该做什么、按什么顺序做、输出什么格式。Claude 在跑任务的时候会根据当前上下文自动判断要不要加载某个 skill加载之后就会照着里面的流程走。举个例子没有 superpowers 的时候你让 Claude帮我实现一个登录接口它可能直接就甩代码了。有了 planner 这个 skill它会先停下来问你要接口文档吗、字段校验规则是什么、需不需要数据库表然后列出步骤让你确认再动手。这就是技能包和工具链的本质区别工具链是帮你做事的技能包是教 AI 怎么做事。前者是术后者是法——superpowers 管的是后者。1.2 它解决的是AI 做事不稳这个真问题用过 Claude Code 的人应该都有感觉AI 写代码快是真快但稳定性看运气。同一个需求今天它能写好明天换个说法它可能就自由发挥写出完全不同的实现。原因很简单——大模型的输出有随机性prompt 稍微变一下行为就飘了。superpowers 的思路不是去消除随机性这不可能而是把该怎么做这件事固化下来。每个 skill 相当于给 AI 定义了一套 SOP不管用户怎么提问只要触发了对应场景AI 就会按这套 SOP 走。这样即使提问方式千差万别最终的工作流是大致统一的输出质量也就稳了。我自己的体会是装上 superpowers 之后Claude Code 从一个很聪明的实习生变成了一个懂规矩的高级工程师。聪明还是有但更重要的是它知道先做什么、后做什么、每一步怎么做才不容易翻车。1.3 为什么说它能自我进化这个项目最吸引我的一点不是它自带的那些 skills而是它的设计允许 AI 自己创造新技能。因为每个 skill 本质上就是一份 Markdown而 Claude 最擅长的恰恰是读写文本——它完全可以把自己在某次任务里总结出的好方法写成一个新的 skill 文件存下来下次遇到类似任务直接调用。我在实际使用中试过几次让 Claude 处理完一个比较复杂的重构任务后把重构老代码的处理流程整理成一个新 skill。它写出来的文件质量相当高结构、边界条件都考虑到了之后我再遇到类似重构任务它就会自动用上这套流程。这就形成了一个正循环用得越多技能库越丰富技能库越丰富后面做事越顺手。这也是它敢叫superpowers的原因之一——能力是可以积累的。2. 技能库盘点里面到底有哪些 skills2.1 核心三件套planner、brainstorm、tdd先说说最核心的三个 skill也是我日常使用频率最高的。planner规划者这是整个技能库的基石。触发这个 skill 后Claude 会先对任务做拆解输出一份带步骤的计划跟你确认后再执行。不是简单的列表而是会标注每步的输入输出、涉及的文件、预期的验证方式。我一般遇到需求模糊、涉及面广的任务都会先让它进入规划模式把范围聊清楚再开工。brainstorm头脑风暴当任务存在多种实现方案时这个 skill 会发挥作用。它不让 AI 直接选一个方案开干而是先列出至少三到五种方案每个方案标注优缺点、成本、风险最后给出推荐。有一次我要做一个鉴权模块它列了 session、JWT、OAuth2、混合方案四种选择每个都讲清楚了适用场景比我直接问你用什么方案得到的答案靠谱得多。tdd测试驱动开发这个 skill 让 Claude 严格按先写测试、再写实现的顺序干活。具体流程是先根据需求写一组测试用例跑一遍确认测试失败因为代码还没写然后写最小实现让测试通过最后顺手整理代码质量。这套流程对业务逻辑复杂的模块特别有用测试用例一写需求边界就清楚了后面实现阶段基本不会跑偏。这三个技能配合起来效果很好brainstorm 负责选方向planner 负责拆步骤tdd 负责保证每一步的代码质量。我的不少项目流程就是从这三个 skill 的使用中自然沉淀下来的。2.2 其他值得点名的技能debugging、code-review、implement除了三件套技能库里还有一些场景特化的技能我按自己用过的频率排个序。debugging遇到 bug 时Claude 不会一上来就猜原因而是先让你提供复现步骤、贴错误日志然后按复现-二分定位-修复-回归验证的流程走。有一次前端报了个奇怪的样式错乱问题它在没找到明显原因时没有乱改代码而是让我打开浏览器控制台把报错截图给它然后一步步缩小范围最后定位到是一个 CSS 伪类的兼容性问题。code-review让 Claude 以审查者的视角看代码输出问题清单、优先级和修改建议。它不只是找语法问题还会关注边界条件、异常处理、性能隐患。我提交代码前经常先让它过一遍比自己反复读几遍效率高。implement这是一个按需求直接实现的 skill适合需求已经很清晰、不需要太多来回确认的场景。它和 planner 的定位不一样planner 适合复杂任务implement 适合简单直接的功能。装完 superpowers 之后我发现自己对该用哪个技能的判断也会影响效果后面实战部分我会详细说。2.3 全量技能清单我当前版本里的完整列表为了让你有个整体概念我把当前版本里能看到的技能目录整理成了表格。需要注意版本更新后可能会有增删以你 clone 下来的实际目录为准。技能名称主要用途我的使用频率planner任务拆解与执行规划极高brainstorm多方案比选与推荐高tdd测试驱动开发流程高debugging系统化排错高code-review代码审查中高implement明确需求的直接实现中高use-cases需求用例梳理与场景分析中git-workflow规范的 Git 分支与提交流程中githubGitHub Issue/PR 操作中setup-workspace项目环境初始化低todos将大任务拆解为可跟踪的待办列表中低这里面有一些技能其实很值得玩比如 setup-workspace它会在你新建项目时先检查依赖、初始化目录结构、建好 README让项目起步整洁不少。还有 todos适合那种任务很大但还没到写代码阶段的场景先把待办列清楚再逐项处理。2.4 技能之间怎么选我的判断标准拿到这么多技能很多人第一反应是是不是每个任务都得指定技能。其实不是。这套技能库的设计原则是按需自动触发——Claude 会根据你的描述判断当前场景自动加载合适的 skill。比如说你开口就问帮我看看这段代码哪里有问题它大概率会走 code-review 流程而不是 planner 流程。但为了效率我建议你在关键节点上有意识地引导它。比如开始做复杂功能时多问一句先做个计划需求有多种做法时说一句帮我 brainstorm 一下。我试过完全不干预让它全自动判断结果大部分时候靠谱但偶尔会在简单任务上杀鸡用牛刀走了过多流程。所以我的策略是简单事让它直接干复杂事先给个引导词。3. 安装与引入从零开始把 superpowers 装上3.1 先说环境你需要准备什么安装 superpowers 的前提是先有 Claude Code并且版本不能太老因为技能加载依赖 Agent Skills 能力这是后来版本才支持的。我建议先把 Claude Code 升到最新版再做后续操作。除此之外没有什么硬性依赖。不要求额外的 Node 插件不要求 Python 环境因为 skills 本质上就是文件。这一点非常友好比较新的 Claude Code 用户基本不会有安装门槛。3.2 快速安装路线clone 自动引导我装的时候走的是最标准的路线先把仓库 clone 到本地然后在 Claude Code 里打开这个目录让 Claude 自己完成剩下的安装引导。这是在项目 README 里推荐的路径用起来也很顺。git clone https://github.com/obra/superpowers.git cd superpowers进入目录后在 Claude Code 中启动对话AI 会自动识别项目类型和安装脚本。我当时就是跟它说了一句帮我完成安装它就开始检查目录结构、准备复制 skills 文件、确认配置位置全程没有什么手动操作。这条路径的原理是自我引导项目本身就给 Claude 准备好了安装指令AI 读一下 README 和安装脚本就知道该做什么。这也是 superpowers 项目的一个特色——它不只是教你用技能还让 AI 自己负责把技能装好。3.3 手动引入一步一步自己掌控如果你想搞清楚每一步做了什么或者你用的是不能自动引导的环境手动复制也完全可行。Claude Code 读取技能的目录有两个全局目录和项目目录。全局目录~/.claude/skills/所有项目都能用。项目目录项目根目录/.claude/skills/只对当前项目生效。手动安装就是把仓库里的 skills 目录内容复制过去mkdir -p ~/.claude/skills cp -r superpowers/skills/* ~/.claude/skills/复制完就完成了。我建议优先复制到项目目录特别是你在公司项目里用的时候不要污染全局环境。如果多个项目都要用再考虑全局安装。注意目录名必须叫skills不能写成skill或Skills否则 Claude 会静默忽略这个目录。我第一次装就在这里弄错过后面排查了半天才发现是目录名拼错了。3.4 配置与权限给 AI 足够的行动空间skills 要真正发挥作用还需要 Claude Code 有相应的执行权限包括读写文件、执行命令、调用 Git 等。这些权限一般在 Claude Code 的设置里配置建议按项目维度做精细化授权而不是全局放开。举个例子我的项目里允许 Claude 执行 npm 命令和 git 命令但不允许它随意删文件。这样它在执行 TDD 流程时能正常跑测试同时不会做出不可控的破坏性操作。权限配置这块建议花点心思装技能只是开始安全边界要提前画好。3.5 验证安装确认技能已被识别装完别急着用先验证一下。最简单的办法是在 Claude Code 里问它你现在有哪些 skills 可用如果安装成功它会列出一串技能名称并且每个都附带简短说明。如果你发现列出来的技能不全优先检查复制路径是否正确、目录名是否为skills、文件是否完整。这一步验证花不了一分钟但能省下后面大量排查时间。4. 实战在真实项目里把技能用起来4.1 触发技能的正确姿势自然语言就可以很多人的疑问是怎么引入这些技能是不是要在配置里启用。实际使用中完全不需要手动启用你只需要在对话里让 Claude 知道你要干嘛它就会自己判断用哪个 skill。比如你说帮我实现一个用户注册接口先别急着写代码把方案列出来让我选一下它就明白要走 brainstorm你说接下这个需求先拆个计划再动手它就进入 planner 流程你补一句记得先写测试再写实现TDD 流程也就跟上了。我的经验是技能不是靠命令调用的靠的是意图传达。你描述得越清楚技能的选择就越准确。4.2 完整实测案例从模糊需求到测试通过举个我自己项目里的真实例子。某次我需要给一个后台系统加批量导入用户的功能需求描述只有一句话支持 Excel 导入用户要能校验数据。我没有让它直接写代码而是先引导它进入 planner 流程。它问了我几个问题Excel 模板格式、字段映射规则、重复用户怎么处理、校验失败时整体回滚还是部分导入。这些问题我一开始根本没想清楚一问才发现需求其实有不少模糊点。确认完需求后它输出了一份计划先设计 Excel 模板和字段映射表再写数据校验逻辑接着写导入服务然后补测试用例最后接一个管理后台的上传入口。每一步都标了涉及的文件和预计改动范围。我确认后它才开始动手。进入编码阶段后它自动按 TDD 流程走先写了字段校验和数据解析的测试跑了一遍确认失败然后写实现代码让测试通过。中途遇到一个日期格式解析问题它用了 debugging 流程先让我提供一个具体报错数据复现后定位到是 Excel 中的日期单元格会被解析成数字最后修复并补上了回归测试。整个过程下来这个功能从需求到测试通过用了不到半小时而且每一步都有记录、有测试支撑后面走查代码非常省力。这就是技能配合工作流的价值。4.3 技能不是越多越好避免流程冗余前面提过技能全自动判断偶尔会过度流程化。我在使用中发现有些小需求根本不值得走完 brainstorm planner tdd 全套比如改一个按钮的颜色、调一个文案直接让 AI 改完就完了。如果它也给你来一遍计划确认那是真浪费时间。所以我的建议是把要不要走完流程的开关握在自己手里。当你描述需求时如果希望走完整流程就明确说严格按流程来如果是小改动就说直接改就行不用列计划。这样既能享受技能带来的稳定性又不牺牲做小事的效率。我的习惯大任务开头说按流程来小改动直接说直接改不用列计划。这个区分帮我省了不少时间。4.4 让 AI 自己写新技能把经验沉淀下来这个功能我用得最上瘾。每次做完一个稍复杂的任务我会让 Claude 复盘一下过程把下次遇到类似任务应该怎么做整理成一个新 skill 文件。因为 skill 本身就是 Markdown让 AI 写这个简直是让它干老本行。具体做法很简单等任务完成后在对话里说把这次处理这类问题的流程整理成一个新的 skill存到技能目录里。它会自动分析这次任务里用到的步骤、判断边界、输出格式然后生成一个带名称和描述的 Markdown 文件放进去。我现在已经积累了几个自己定制的 skill比如老项目依赖升级、接口兼容性改造这些都是我自己项目里反复遇到、又没有现成技能覆盖的场景。每次使用前我再让它把 skill 内容读一遍、微调一下效果比从零提示要好得多。5. 常见问题与排查记录5.1 技能识别不了优先查路径与目录名这是我在最开始就提到的坑。Claude 加载 skills 靠的是固定目录约定路径一旦不对技能就静默失效。排查时先确认两点一是目录名必须是skills二是文件必须放在项目根目录下的.claude/skills/或者全局的~/.claude/skills/下。如果你把 skills 文件放到别的地方Claude 不会报错只是完全感知不到。这种无声失败最让人头痛所以安装完一定要做验证那一步。5.2 装了技能但行为没变化触发条件不对有朋友跟我说我装了 superpowers但感觉 Claude 跟以前没区别。这种情况多半是触发时机不对。技能的加载依赖对话中的场景匹配如果你只是问帮我写个快排它大概率不会启动 planner 或 tdd因为任务太简单、场景不够明确。解决办法是在最开始的需求描述里明确带上流程要求。比如先帮我制定实现计划再按计划编码并且用测试驱动的方式。这样把场景坐实技能才会像预期那样启动。当然你也可以直接问 Claude这个场景适合用哪个 skill让它自己来判断和引导。5.3 跑 TDD 时测试环境起不来权限和依赖问题使用 TDD 技能时最常见的问题是跑测试失败——不是代码逻辑问题而是测试环境本身的问题。比如项目依赖没装全、测试命令需要特殊参数、或者 Claude 没有权限执行命令。我的经验是在使用 TDD 技能前先确认项目能正常跑测试并且把测试命令告诉 Claude。如果依赖没装全先让 Claude 把依赖装好再进入 TDD 流程。不然它会因为测试无法运行而反复猜测浪费不少时间。5.4 技能目录越来越乱定期整理skills 可以自己新增时间一长目录里就会有很多文件包括你自己定制的、项目里临时的、版本更新带来的。我建议每隔一段时间清理一次把过时的删掉把相似功能的合并把可复用的提升到全局目录。清理的时候可以在 Claude Code 里让 AI 帮着分拣。它会根据你的使用频率和描述把技能分为长期保留、项目专用、建议删除三类然后让你确认。这个方法我试过几次整理效果不错也比手动翻文件快得多。5.5 版本升级别怕直接更新superpowers 的更新方式很简单重新拉取仓库代码把新版本 skills 同步到你的技能目录。升级前留意一下变更日志看看有没有删除或改名的情况。我遇到过某次升级把 skill 的描述改得更精准了触发场景随之变化有些任务的行为跟之前不一样适应了两天就习惯了。整个用下来我最深的体会是superpowers 不是那种装完就能一劳永逸的插件它更像一个习惯养成工具。你真正投入时间去理解每个 skill 的定位、在合适的场景引导它、把项目里反复出现的经验沉淀成新技能这套东西才会越用越顺手。如果你刚接触 Claude Code建议拿一个小项目先试两周重点体验 planner 和 tdd 这两个技能带来的变化。等你自己定制出第一个 skill 的时候大概就能理解为什么这个项目叫superpowers了。
如果你最近在折腾 Claude Code大概率刷到过 superpowers 这个项目。它不是某个单文件脚本而是一整套可安装、可扩展的 skills 技能库目标就是给 AI 装上超能力——拿到任务先规划、写代码先测试、出 bug 先定位。这项目在 GitHub 上热度一直很高作者是 Jesse Vincent一个混迹开源圈多年的老手。今天这篇文章我就把自己从安装、引入到实际使用的全过程整理出来顺便把里面到底有哪些 skills、每个技能怎么触发、踩过哪些坑一次说清楚。不管你是刚接触 Claude Code 的新手还是已经在用它写业务代码的老手只要你想让 AI 干活更稳、更有章法这篇内容应该都对你有用。1. superpowers 到底是个什么东西定位与设计思路1.1 它是技能包不是工具链很多人一看 superpowers 这个名字第一反应是又一个 AI 编程工具。实际用下来你会发现它更像是一个装满了 Markdown 文件的技能包只不过这些 Markdown 不是给人看的文档而是给 Claude尤其是 Claude Code看的操作手册。这个项目的核心是基于 Anthropic 提出的 Agent Skills 规范。简单理解每个技能skill就是一个带格式说明的 Markdown 文件里面写清楚了你在什么场景下应该做什么、按什么顺序做、输出什么格式。Claude 在跑任务的时候会根据当前上下文自动判断要不要加载某个 skill加载之后就会照着里面的流程走。举个例子没有 superpowers 的时候你让 Claude帮我实现一个登录接口它可能直接就甩代码了。有了 planner 这个 skill它会先停下来问你要接口文档吗、字段校验规则是什么、需不需要数据库表然后列出步骤让你确认再动手。这就是技能包和工具链的本质区别工具链是帮你做事的技能包是教 AI 怎么做事。前者是术后者是法——superpowers 管的是后者。1.2 它解决的是AI 做事不稳这个真问题用过 Claude Code 的人应该都有感觉AI 写代码快是真快但稳定性看运气。同一个需求今天它能写好明天换个说法它可能就自由发挥写出完全不同的实现。原因很简单——大模型的输出有随机性prompt 稍微变一下行为就飘了。superpowers 的思路不是去消除随机性这不可能而是把该怎么做这件事固化下来。每个 skill 相当于给 AI 定义了一套 SOP不管用户怎么提问只要触发了对应场景AI 就会按这套 SOP 走。这样即使提问方式千差万别最终的工作流是大致统一的输出质量也就稳了。我自己的体会是装上 superpowers 之后Claude Code 从一个很聪明的实习生变成了一个懂规矩的高级工程师。聪明还是有但更重要的是它知道先做什么、后做什么、每一步怎么做才不容易翻车。1.3 为什么说它能自我进化这个项目最吸引我的一点不是它自带的那些 skills而是它的设计允许 AI 自己创造新技能。因为每个 skill 本质上就是一份 Markdown而 Claude 最擅长的恰恰是读写文本——它完全可以把自己在某次任务里总结出的好方法写成一个新的 skill 文件存下来下次遇到类似任务直接调用。我在实际使用中试过几次让 Claude 处理完一个比较复杂的重构任务后把重构老代码的处理流程整理成一个新 skill。它写出来的文件质量相当高结构、边界条件都考虑到了之后我再遇到类似重构任务它就会自动用上这套流程。这就形成了一个正循环用得越多技能库越丰富技能库越丰富后面做事越顺手。这也是它敢叫superpowers的原因之一——能力是可以积累的。2. 技能库盘点里面到底有哪些 skills2.1 核心三件套planner、brainstorm、tdd先说说最核心的三个 skill也是我日常使用频率最高的。planner规划者这是整个技能库的基石。触发这个 skill 后Claude 会先对任务做拆解输出一份带步骤的计划跟你确认后再执行。不是简单的列表而是会标注每步的输入输出、涉及的文件、预期的验证方式。我一般遇到需求模糊、涉及面广的任务都会先让它进入规划模式把范围聊清楚再开工。brainstorm头脑风暴当任务存在多种实现方案时这个 skill 会发挥作用。它不让 AI 直接选一个方案开干而是先列出至少三到五种方案每个方案标注优缺点、成本、风险最后给出推荐。有一次我要做一个鉴权模块它列了 session、JWT、OAuth2、混合方案四种选择每个都讲清楚了适用场景比我直接问你用什么方案得到的答案靠谱得多。tdd测试驱动开发这个 skill 让 Claude 严格按先写测试、再写实现的顺序干活。具体流程是先根据需求写一组测试用例跑一遍确认测试失败因为代码还没写然后写最小实现让测试通过最后顺手整理代码质量。这套流程对业务逻辑复杂的模块特别有用测试用例一写需求边界就清楚了后面实现阶段基本不会跑偏。这三个技能配合起来效果很好brainstorm 负责选方向planner 负责拆步骤tdd 负责保证每一步的代码质量。我的不少项目流程就是从这三个 skill 的使用中自然沉淀下来的。2.2 其他值得点名的技能debugging、code-review、implement除了三件套技能库里还有一些场景特化的技能我按自己用过的频率排个序。debugging遇到 bug 时Claude 不会一上来就猜原因而是先让你提供复现步骤、贴错误日志然后按复现-二分定位-修复-回归验证的流程走。有一次前端报了个奇怪的样式错乱问题它在没找到明显原因时没有乱改代码而是让我打开浏览器控制台把报错截图给它然后一步步缩小范围最后定位到是一个 CSS 伪类的兼容性问题。code-review让 Claude 以审查者的视角看代码输出问题清单、优先级和修改建议。它不只是找语法问题还会关注边界条件、异常处理、性能隐患。我提交代码前经常先让它过一遍比自己反复读几遍效率高。implement这是一个按需求直接实现的 skill适合需求已经很清晰、不需要太多来回确认的场景。它和 planner 的定位不一样planner 适合复杂任务implement 适合简单直接的功能。装完 superpowers 之后我发现自己对该用哪个技能的判断也会影响效果后面实战部分我会详细说。2.3 全量技能清单我当前版本里的完整列表为了让你有个整体概念我把当前版本里能看到的技能目录整理成了表格。需要注意版本更新后可能会有增删以你 clone 下来的实际目录为准。技能名称主要用途我的使用频率planner任务拆解与执行规划极高brainstorm多方案比选与推荐高tdd测试驱动开发流程高debugging系统化排错高code-review代码审查中高implement明确需求的直接实现中高use-cases需求用例梳理与场景分析中git-workflow规范的 Git 分支与提交流程中githubGitHub Issue/PR 操作中setup-workspace项目环境初始化低todos将大任务拆解为可跟踪的待办列表中低这里面有一些技能其实很值得玩比如 setup-workspace它会在你新建项目时先检查依赖、初始化目录结构、建好 README让项目起步整洁不少。还有 todos适合那种任务很大但还没到写代码阶段的场景先把待办列清楚再逐项处理。2.4 技能之间怎么选我的判断标准拿到这么多技能很多人第一反应是是不是每个任务都得指定技能。其实不是。这套技能库的设计原则是按需自动触发——Claude 会根据你的描述判断当前场景自动加载合适的 skill。比如说你开口就问帮我看看这段代码哪里有问题它大概率会走 code-review 流程而不是 planner 流程。但为了效率我建议你在关键节点上有意识地引导它。比如开始做复杂功能时多问一句先做个计划需求有多种做法时说一句帮我 brainstorm 一下。我试过完全不干预让它全自动判断结果大部分时候靠谱但偶尔会在简单任务上杀鸡用牛刀走了过多流程。所以我的策略是简单事让它直接干复杂事先给个引导词。3. 安装与引入从零开始把 superpowers 装上3.1 先说环境你需要准备什么安装 superpowers 的前提是先有 Claude Code并且版本不能太老因为技能加载依赖 Agent Skills 能力这是后来版本才支持的。我建议先把 Claude Code 升到最新版再做后续操作。除此之外没有什么硬性依赖。不要求额外的 Node 插件不要求 Python 环境因为 skills 本质上就是文件。这一点非常友好比较新的 Claude Code 用户基本不会有安装门槛。3.2 快速安装路线clone 自动引导我装的时候走的是最标准的路线先把仓库 clone 到本地然后在 Claude Code 里打开这个目录让 Claude 自己完成剩下的安装引导。这是在项目 README 里推荐的路径用起来也很顺。git clone https://github.com/obra/superpowers.git cd superpowers进入目录后在 Claude Code 中启动对话AI 会自动识别项目类型和安装脚本。我当时就是跟它说了一句帮我完成安装它就开始检查目录结构、准备复制 skills 文件、确认配置位置全程没有什么手动操作。这条路径的原理是自我引导项目本身就给 Claude 准备好了安装指令AI 读一下 README 和安装脚本就知道该做什么。这也是 superpowers 项目的一个特色——它不只是教你用技能还让 AI 自己负责把技能装好。3.3 手动引入一步一步自己掌控如果你想搞清楚每一步做了什么或者你用的是不能自动引导的环境手动复制也完全可行。Claude Code 读取技能的目录有两个全局目录和项目目录。全局目录~/.claude/skills/所有项目都能用。项目目录项目根目录/.claude/skills/只对当前项目生效。手动安装就是把仓库里的 skills 目录内容复制过去mkdir -p ~/.claude/skills cp -r superpowers/skills/* ~/.claude/skills/复制完就完成了。我建议优先复制到项目目录特别是你在公司项目里用的时候不要污染全局环境。如果多个项目都要用再考虑全局安装。注意目录名必须叫skills不能写成skill或Skills否则 Claude 会静默忽略这个目录。我第一次装就在这里弄错过后面排查了半天才发现是目录名拼错了。3.4 配置与权限给 AI 足够的行动空间skills 要真正发挥作用还需要 Claude Code 有相应的执行权限包括读写文件、执行命令、调用 Git 等。这些权限一般在 Claude Code 的设置里配置建议按项目维度做精细化授权而不是全局放开。举个例子我的项目里允许 Claude 执行 npm 命令和 git 命令但不允许它随意删文件。这样它在执行 TDD 流程时能正常跑测试同时不会做出不可控的破坏性操作。权限配置这块建议花点心思装技能只是开始安全边界要提前画好。3.5 验证安装确认技能已被识别装完别急着用先验证一下。最简单的办法是在 Claude Code 里问它你现在有哪些 skills 可用如果安装成功它会列出一串技能名称并且每个都附带简短说明。如果你发现列出来的技能不全优先检查复制路径是否正确、目录名是否为skills、文件是否完整。这一步验证花不了一分钟但能省下后面大量排查时间。4. 实战在真实项目里把技能用起来4.1 触发技能的正确姿势自然语言就可以很多人的疑问是怎么引入这些技能是不是要在配置里启用。实际使用中完全不需要手动启用你只需要在对话里让 Claude 知道你要干嘛它就会自己判断用哪个 skill。比如你说帮我实现一个用户注册接口先别急着写代码把方案列出来让我选一下它就明白要走 brainstorm你说接下这个需求先拆个计划再动手它就进入 planner 流程你补一句记得先写测试再写实现TDD 流程也就跟上了。我的经验是技能不是靠命令调用的靠的是意图传达。你描述得越清楚技能的选择就越准确。4.2 完整实测案例从模糊需求到测试通过举个我自己项目里的真实例子。某次我需要给一个后台系统加批量导入用户的功能需求描述只有一句话支持 Excel 导入用户要能校验数据。我没有让它直接写代码而是先引导它进入 planner 流程。它问了我几个问题Excel 模板格式、字段映射规则、重复用户怎么处理、校验失败时整体回滚还是部分导入。这些问题我一开始根本没想清楚一问才发现需求其实有不少模糊点。确认完需求后它输出了一份计划先设计 Excel 模板和字段映射表再写数据校验逻辑接着写导入服务然后补测试用例最后接一个管理后台的上传入口。每一步都标了涉及的文件和预计改动范围。我确认后它才开始动手。进入编码阶段后它自动按 TDD 流程走先写了字段校验和数据解析的测试跑了一遍确认失败然后写实现代码让测试通过。中途遇到一个日期格式解析问题它用了 debugging 流程先让我提供一个具体报错数据复现后定位到是 Excel 中的日期单元格会被解析成数字最后修复并补上了回归测试。整个过程下来这个功能从需求到测试通过用了不到半小时而且每一步都有记录、有测试支撑后面走查代码非常省力。这就是技能配合工作流的价值。4.3 技能不是越多越好避免流程冗余前面提过技能全自动判断偶尔会过度流程化。我在使用中发现有些小需求根本不值得走完 brainstorm planner tdd 全套比如改一个按钮的颜色、调一个文案直接让 AI 改完就完了。如果它也给你来一遍计划确认那是真浪费时间。所以我的建议是把要不要走完流程的开关握在自己手里。当你描述需求时如果希望走完整流程就明确说严格按流程来如果是小改动就说直接改就行不用列计划。这样既能享受技能带来的稳定性又不牺牲做小事的效率。我的习惯大任务开头说按流程来小改动直接说直接改不用列计划。这个区分帮我省了不少时间。4.4 让 AI 自己写新技能把经验沉淀下来这个功能我用得最上瘾。每次做完一个稍复杂的任务我会让 Claude 复盘一下过程把下次遇到类似任务应该怎么做整理成一个新 skill 文件。因为 skill 本身就是 Markdown让 AI 写这个简直是让它干老本行。具体做法很简单等任务完成后在对话里说把这次处理这类问题的流程整理成一个新的 skill存到技能目录里。它会自动分析这次任务里用到的步骤、判断边界、输出格式然后生成一个带名称和描述的 Markdown 文件放进去。我现在已经积累了几个自己定制的 skill比如老项目依赖升级、接口兼容性改造这些都是我自己项目里反复遇到、又没有现成技能覆盖的场景。每次使用前我再让它把 skill 内容读一遍、微调一下效果比从零提示要好得多。5. 常见问题与排查记录5.1 技能识别不了优先查路径与目录名这是我在最开始就提到的坑。Claude 加载 skills 靠的是固定目录约定路径一旦不对技能就静默失效。排查时先确认两点一是目录名必须是skills二是文件必须放在项目根目录下的.claude/skills/或者全局的~/.claude/skills/下。如果你把 skills 文件放到别的地方Claude 不会报错只是完全感知不到。这种无声失败最让人头痛所以安装完一定要做验证那一步。5.2 装了技能但行为没变化触发条件不对有朋友跟我说我装了 superpowers但感觉 Claude 跟以前没区别。这种情况多半是触发时机不对。技能的加载依赖对话中的场景匹配如果你只是问帮我写个快排它大概率不会启动 planner 或 tdd因为任务太简单、场景不够明确。解决办法是在最开始的需求描述里明确带上流程要求。比如先帮我制定实现计划再按计划编码并且用测试驱动的方式。这样把场景坐实技能才会像预期那样启动。当然你也可以直接问 Claude这个场景适合用哪个 skill让它自己来判断和引导。5.3 跑 TDD 时测试环境起不来权限和依赖问题使用 TDD 技能时最常见的问题是跑测试失败——不是代码逻辑问题而是测试环境本身的问题。比如项目依赖没装全、测试命令需要特殊参数、或者 Claude 没有权限执行命令。我的经验是在使用 TDD 技能前先确认项目能正常跑测试并且把测试命令告诉 Claude。如果依赖没装全先让 Claude 把依赖装好再进入 TDD 流程。不然它会因为测试无法运行而反复猜测浪费不少时间。5.4 技能目录越来越乱定期整理skills 可以自己新增时间一长目录里就会有很多文件包括你自己定制的、项目里临时的、版本更新带来的。我建议每隔一段时间清理一次把过时的删掉把相似功能的合并把可复用的提升到全局目录。清理的时候可以在 Claude Code 里让 AI 帮着分拣。它会根据你的使用频率和描述把技能分为长期保留、项目专用、建议删除三类然后让你确认。这个方法我试过几次整理效果不错也比手动翻文件快得多。5.5 版本升级别怕直接更新superpowers 的更新方式很简单重新拉取仓库代码把新版本 skills 同步到你的技能目录。升级前留意一下变更日志看看有没有删除或改名的情况。我遇到过某次升级把 skill 的描述改得更精准了触发场景随之变化有些任务的行为跟之前不一样适应了两天就习惯了。整个用下来我最深的体会是superpowers 不是那种装完就能一劳永逸的插件它更像一个习惯养成工具。你真正投入时间去理解每个 skill 的定位、在合适的场景引导它、把项目里反复出现的经验沉淀成新技能这套东西才会越用越顺手。如果你刚接触 Claude Code建议拿一个小项目先试两周重点体验 planner 和 tdd 这两个技能带来的变化。等你自己定制出第一个 skill 的时候大概就能理解为什么这个项目叫superpowers了。
![如何快速上手RAD Debugger：10个实用技巧让你成为调试高手 [特殊字符]](http://pic.xiahunao.cn/yaotu/如何快速上手RAD Debugger：10个实用技巧让你成为调试高手 [特殊字符])
