最近一直在折腾给 Claude 扩展技能这件事试过各种提示词模板、MCP 服务、自定义工作流最后发现一个叫 superpowers 的项目直接把这事简化了一大截。它不是一个具体的单一功能而是一整套 Claude Skills 的集合——把写代码、做规划、查 Bug、写测试这些高频工作拆成了标准化流程让 Claude 拿到任务后能自己按节奏干活而不是每次都要我重新教一遍。如果你也在用 Claude 相关工具写代码或者想要一套能稳定复用的 AI 工作方法这篇内容值得看完。我会把安装过程、里面到底有哪些 skills、怎么引入、怎么让它们真正生效以及我踩过的坑全部整理出来。1. superpowers 是什么它不是插件而是一套“工作方法包”1.1 项目定位与设计思路superpowers 这个项目本质上是一个 Skills 集合。所谓 “Skills”你可以把它理解成 AI 助理的“岗位说明书”——每个 skill 对应一个场景里面写清楚了 AI 在该场景下应该遵循的步骤、检查标准和输出格式。当你在对话里触发某个 skill 时Claude 会先读取对应的 SKILL.md 文件按照里面的流程一步步执行而不是漫无目的地自由发挥。这个设计思路很聪明。平时我们用 Claude 时遇到的最大问题不是它能力不够而是它每次都“重新发明轮子”——今天写代码是一种风格明天又是另一种今天做规划列了三步明天可能就列了十步。superpowers 把那些经过验证的最佳实践沉淀成了固定规则让 AI 的输出稳定可预期。用一句大白话说它给 AI 装了一套“肌肉记忆”。1.2 它真正解决的是什么问题如果你平时只是拿 AI 随便聊聊天、写几句文案那 superpowers 可能有点重。它的核心价值体现在两个场景一是重复性工程任务的标准化比如写测试、调 Bug、做代码审查以前每次都要手动告诉 AI 怎么做现在一个关键词就能触发标准流程二是多步骤任务的推进比如从想法到开发计划再到落地实现superpowers 会把过程拆成一个个阶段每个阶段都有明确的输入输出。我个人感觉这个项目最适合以下几类人用 Claude Code 做实际开发的人、想给 AI 建立固定工作习惯的人、以及刚接触 AI 编程想少走弯路的新手。它不是那种装完就完事的库装好之后还需要理解它的工作逻辑才能用得顺手。2. 安装前的准备工作环境要求与关键概念2.1 确认基础运行环境在正式安装之前先检查自己的电脑环境。我是在 macOS 上操作的但整个流程在 Linux 和 Windows通过 WSL下同样适用。需要准备的东西如下Claude Code 或其他支持 Skills 机制的 Claude 客户端这是跑 superpowers 的承载环境Git用来从仓库拉取项目文件Node.js 16 及以上版本部分 skills 在运行时依赖 Node 执行脚本一个已有 Claude 账号且 API 额度或订阅处于可用状态提示如果你只是想在 Claude 网页版聊天里用 Skillssuperpowers 的设计目标是本地客户端网页版没法直接读取本地 SKILL.md 文件。这一点先有个心理预期。环境检查可以用一个命令完成node --version git --version claude --version我遇到过好几个朋友卡在环境上结果一看是 Node 版本太老有些 skill 脚本跑不起来。建议先确保输出里三个版本信息都正常。2.2 理解 Skills 的加载机制这一步比较关键理解透了之后排查问题会快很多。Claude Code 这类工具加载 Skills 的方式是扫描指定目录下的子文件夹每个子文件夹里有一个SKILL.md文件这个文件是技能的“主入口”。当你在对话中说出某个关键词或者 Claude 判断当前任务符合某个技能的场景时它就会自动去读对应的 SKILL.md。superpowers 提供的所有技能都遵循这个结构superpowers/ └── skills/ ├── brainstorm/ │ └── SKILL.md ├── test-driven-development/ │ └── SKILL.md └── ...所以“安装 superpowers”这个动作本质上就是把skills/目录里的这些技能文件夹放到 Claude 能够扫描到的 Skills 目录下。不需要运行什么神秘的安装脚本本质就是文件拷贝和路径配置。2.3 配置文件的匹配规则除了技能文件本身还有一层是CLAUDE.md配置。Claude Code 在启动时会读取项目根目录下的CLAUDE.md或者在用户全局目录下读取用户级记忆文件。superpowers 项目自带的模板里包含了对这些技能的“索引说明”告诉 Claude 有哪些技能可用、分别在什么场景下用。我用下来觉得索引说明比技能文件本身还重要。因为 Claude 是根据这份索引来决定要不要调用某个技能的——如果索引里没有提到某个技能哪怕文件放在了正确目录它也大概率不会主动使用。3. 一步步安装并引入 superpowers 技能3.1 获取项目文件首先从 GitHub 获取项目仓库。打开终端进入你准备存放项目的目录执行git clone https://github.com/obra/superpowers.git如果 GitHub 访问不稳定也可以直接下载 zip 包解压。下载完成后检查一下目录结构确保skills文件夹在里面。ls superpowers/正常会看到skills/、README.md、还有若干配置示例文件。我第一次拿到项目的时候觉得很朴素跟预想中的“神奇工具”有差距但实际跑起来才发现价值都在细节里。3.2 把 skills 复制到 Clude 可识别目录接着你需要确认你的 Claude 工具会扫描哪个 Skills 目录。以 Claude Code 为例它支持项目级和用户级两种项目级./.claude/skills/仅当前项目生效用户级~/.claude/skills/所有项目生效按需选择。我的做法是先在项目级试装mkdir -p .claude/skills cp -r superpowers/skills/* .claude/skills/装完后检查一下ls .claude/skills/应该会看到包括 brainstorm、debug、test-driven-development 在内的多个技能目录。3.3 配置 CLAUDE.md 索引文件这一步很容易被忽略但恰恰是“怎么引入这些技能”的关键。如果只复制了技能文件却没有在 CLAUDE.md 里说明Claude 面对一堆 SKILL.md 文件时经常不知道该什么时候用。在项目根目录创建或编辑CLAUDE.md加入类似下面这样的索引## Available Skills The following skills are available in .claude/skills/: - brainstorm: Use when the user needs to generate, refine, or validate ideas before committing to an approach. - debug: Use when the user is troubleshooting an error, bug, or unexpected behavior in code. - test-driven-development: Use when writing new code that should follow TDD workflow.不要照抄这一段应该根据你实际用到的技能去写描述。描述写得越具体Claude 的调用越精准。3.4 验证技能是否加载成功回到 Claude 会话发送一条消息比如我准备写一个 JavaScript 的批量文件重命名脚本应该如何开始如果配置正确你会发现 Claude 开始尝试调用 brainstorm 或 todo 这类技能表现为它会读取 SKILL.md 并按照里面的结构回复。也可以用更直接的方式提问“现在有哪些 skills 可用”它会根据 CLAUDE.md 的索引列出内容。我第一次验证的时候没有成功后来发现是把技能装在了用户级目录而 CLAUDE.md 写在项目级目录里两边没对上。这类路径问题是最常见的坑后面我也会专门列出来。4. 安装后盘点superpowers 里到底有哪些 skills4.1 常用核心技能分类安装完之后建议花点时间把skills目录里的每个 SKILL.md 都翻一遍。我整理了一份核心技能清单方便你快速了解有什么技能名称适用场景核心流程brainstorm想法发散、方案选型、需求澄清先拆问题 → 生成候选方案 → 评估对比 → 给建议todo多任务拆解与进度管理列出任务 → 标注依赖 → 检查完成条件test-driven-development按 TDD 模式写代码先写测试 → 跑通失败 → 写实现 → 重构debug程序出错、定位 Bug复现问题 → 缩小范围 → 定位根因 → 修复验证canary新功能上线前的试用验证小范围试验 → 收集反馈 → 决定是否全量change-patterns代码修改模式分析识别变更模式 → 评估影响面 → 给出建议exploratory-approach不确定的技术探索定义探索目标 → 记录发现 → 总结结论guide生成操作指引文档明确读者 → 分步骤写 → 附注意事项tribal-knowledge沉淀团队和项目经验收集碎片信息 → 整理归档 → 便于检索它不是只有这几个但这个表里的技能我基本都在实际工作中试过。还有一些偏向协作和复盘类的技能比如 retro回顾总结、signing-off结束交接如果你是个人开发者用到的频率会低一些。4.2 每个技能的核心工作逻辑逐个解释一下我对重点技能的理解。brainstorm是我使用频率最高的技能。它的底层层逻辑是先帮你把模糊的问题描述拆成具体的子问题然后针对每个子问题生成多个候选方向最后用一组筛选标准淘汰掉不合适的。比如你说“我想做一个效率工具”brainstorm 会先追问“目标用户是谁”“要解决哪个具体场景的什么问题”而不是直接甩一堆点子。这种“先收窄再发散的节奏”能大幅度减少无效产出。debug的设计思路让人觉得很“有章法”。它要求先构造最小复现再做二分排查最后才写修复。以前我自己排查 Bug 容易东一榔头西一棒子用这个技能之后效率明显提升。尤其是它会在每一轮排查后要求更新对问题根因的判断而不是只顾着试下一个方法。test-driven-development把 TDD 的三个阶段红、绿、重构拆分成了显式的对话步骤。Claude 会严格按“先写失败测试 → 再写最小实现 → 然后重构”的顺序来不会跳步。这个技能配合日常开发使用能显著减少“写完代码不敢改”的问题。4.3 阅读 SKILL.md 的正确姿势每个技能目录下除了 SKILL.md可能还有 references 之类的辅助文档。第一次使用某个技能前建议完整读一遍 SKILL.md 的开头部分里面通常会写明技能的触发条件when to use核心执行步骤workflow质量标准definition of done花 10 分钟读文档后面能省下大量反复试错的时间。我自己用过很多开源工具文档里最容易出价值的地方恰恰是那句“不要在这个阶段做 XX”这种约束条件都是作者踩过坑换来的。5. 实战使用以“从想法到代码”为例跑通全流程5.1 设定一个具体的任务纸上谈兵没什么意思我拿一个真实任务来走一遍假设我想开发一个命令行小工具功能是自动整理指定目录下散落的截图文件按照日期归档到不同子文件夹。在 Claude 会话里我输入帮我规划并实现一个 Node.js 命令行小工具目标是按日期归档图片文件。因为是第一阶段我会明确要求先不要写代码先做规划。此时 Claude 会检索 CLAUDE.md 里的技能索引发现 brainstorm 和 todo 与这个任务相关然后开始调用。5.2 技能的实际调用表现调用 brainstorm 时Claude 会输出类似这样的结构核心需求拆解工具要接收哪些参数目录是硬编码还是命令行传入归档规则是“按月”还是“按日”方案选项方案 A 用 fs 模块硬写方案 B 用 commander 做参数解析 fs 操作方案 C 引入第三方库如 glob 做文件匹配。推荐与理由推荐方案 B因为依赖简单、易扩展同时符合发布为 CLI 工具的需求。这一阶段的输出有明显的层次感这就是 SKILL.md 里结构约束的作用。相比直接问 ChatGPT“怎么做一个工具”这种输出能帮你更快做出技术决策。接下来我确认采用方案 B并让它继续使用 todo 技能。它会生成任务清单初始化 npm 项目、安装 commander实现目录参数解析实现日期提取逻辑实现文件移动逻辑添加错误处理编写 README每项任务还会带上“完成标准”比如“参数解析支持 --dir 和 --output 两个选项”。这个功能看起来很基础但以前我经常要手动追着 AI 要清单现在一次性就出来了。5.3 让技能与写码过程真正咬合任务清单生成后我会让它按 TDD 流程来实现。此时 test-driven-development 技能会接管节奏先写测试文件// test/archive.test.js const { organizeByDate } require(../src/archive); const fs require(fs); const os require(os); const path require(path); test(should move file into date-based subdirectory, () { // 创建临时目录结构 // 调用 organizeByDate // 断言文件已移动到正确位置 });跑一遍测试确认失败因为没有实现代码。然后再去实现功能函数// src/archive.js function organizeByDate(dir) { const files fs.readdirSync(dir); // 遍历文件提取修改时间创建 YYYY-MM 目录移动文件 }这中间 Claude 会自己检查测试是否从红变绿并提醒进入重构阶段。我测试下来在简单工具类项目里这个流程跑得很顺畅生成的代码基本可以直接用。5.4 中途纠偏的经验实际跑的时候也不是一路顺风。我在“日期提取”这个环节遇到过一个情况Claude 默认用文件的mtime修改时间来归档但我的需求更希望优先用文件名里的生成时间戳。我手动提示它“优先解析文件名中的日期模式解析失败再回退到 mtime。”之后它更新了测试用例逻辑也调过来了。这从侧面说明了一个道理superpowers 提供的是流程框架而不是替你定义所有业务规则。核心业务判断还得自己给出来但框架能保证 AI 把调整后的逻辑落到位不漏步骤。6. 使用过程中最容易踩的坑与排查方法6.1 技能没有被触发症状Claude 回复很正常但完全不按 SKILL.md 里的流程走回答充满了自由发挥的痕迹。排查步骤确认.claude/skills/目录结构是否正确有没有多包了一层文件夹比如.claude/skills/skills/brainstorm/SKILL.md这种。确认 CLAUDE.md 里的索引描述是否清晰如果描述太模糊Claude 不知道何时该调用。试着在对话里显式提到技能名比如“用 brainstorm 的方法帮我分析这个问题”。如果显式有用说明索引描述需要调整。6.2 多个技能互相打架症状同一个任务Claude 一会儿用 brainstorm 一会儿切到 todo输出结构混乱。原因CLAUDE.md 里的技能描述存在语义重叠。比如 brainstorm 和 exploratory-approach 在某些场景下会抢触发权。解决修改 CLAUDE.md 里的描述加上明确的区分标准。比如 brainstorm 定位为“需求明确但方案未定”exploratory-approach 定位为“需求和技术路线都不明确”。这种情况我在混合使用多个技能时遇到过不止一次本质上和人的职责分工一样边界清楚了才不会内耗。6.3 技能文件存在但运行报错症状某些技能在执行中需要调用脚本报 Node 模块找不到或者命令不存在。原因superpowers 的部分辅助脚本依赖 Node 模块但它们不会自动安装。解决提醒 AI 安装依赖或者手动检查 SKILL.md 里有没有写明依赖调用命令。我在调试一个技能时看到它在尝试运行node scripts/plan-saver.js但项目里根本没装任何 npm 包后来手动npm install才解决。6.4 不同项目的技能串味症状项目 A 里配置的技能跑到项目 B 里也能被看到导致行为异常。原因你把技能装到了用户级目录~/.claude/skills/而不同项目的 CLAUDE.md 索引如果写得宽泛都可能触发。解决个人项目用项目级目录通用技能才考虑用户级目录。我的习惯是常用通用技能brainstorm、todo放用户级项目特定的debug、change-patterns放项目级。6.5 常用问题速查表问题现象可能原因处理建议技能不生效目录结构放错或 CLAUDE.md 缺索引检查路径、补索引描述多个技能抢触发技能边界描述不清修改 CLAUDE.md 明确区分脚本运行报错依赖没装按 SKILL.md 要求安装依赖跨项目串味技能装在用户级目录改用项目级目录技能执行太慢每次调用都要读多个文档裁剪不必要技能精简 CLAUDE.md这份速查表算是我的排错备忘录。你在用的时候如果遇到其他问题建议先看技能文件本身它通常会在 Troubleshooting 一节里写到作者预想的坑。7. 把 superpowers 融入日常工作的技巧与我的心得7.1 不要一次引入所有技能这一点我觉得值得单独拎出来讲。第一次安装完成的时候看着十几个 skills很多人会想“全给 Claude 备着让它自己判断用哪个”。我试过效果并不好。技能太多会让索引文件变得很长Claude 在读取时反而抓不住重点甚至出现高频率误调用。后来我改成“按周按项目引入”新项目启动时只保留 brainstorm、todo、test-driven-development其余全部移出或注释掉。等某个技能确实用上了再把它加回来。这样每套配置都保持精简Claude 的行为稳定性明显提升。7.2 将 SKILL.md 视为可修改的基线superpowers 里的技能文档写得不错但并非金科玉律。我用了几天之后就开始按自己的口味微调 brainstorm 的流程去掉了一些不必要的提问步骤加上了我习惯的输出格式。修改 SKILL.md 就像调整团队规范跑一阵子发现效率更高就留着不合适就改回去。不过要注意如果你后续从仓库重新拉取 superpowers本地修改会被覆盖。建议把自己的定制版本单独备份一份。7.3 和 MCP 工具配合使用的顺序现在很多人会同时用 MCPModel Context Protocol服务来扩展 Claude 的能力。MCP 提供的是外部数据和工具的连接能力superpowers 提供的是任务执行的流程框架两者不冲突但需要排好顺序。我的使用顺序是先用 MCP 获取需要的数据和上下文再交给带技能流程的 Claude 去处理和落地。比如写一个需要访问数据库的脚本先用 MCP 确认表结构和数据样例再用 test-driven-development 技能写代码。如果反过来Claude 容易在没有数据上下文的情况下强行开跑产出质量打折扣。7.4 给新手的三个实操建议第一耐心读一遍最核心的brainstorm技能文档。它是理解 superpowers 设计哲学的最佳入口比读项目 README 有用得多。第二从小项目练手不要一开始就拿重构级别的代码让 Claude 跑全套技能流程容易因为输出不稳定而挫败。第三保留每次的技能调用记录通过观察 Claude 什么时候调用技能、什么时候不调用可以发现自己对 CLAUDE.md 的描述还有哪些模糊的地方。7.5 最后分享一个小技巧如果你在项目里积累了大量的错误排查记录可以用tribal-knowledge技能把这些信息整理成团队知识库文档。我现在的做法是每遇到一个新问题解决后就把排查过程和结论丢给 Claude让它生成结构化记录并存进docs/knowledge/目录。这样时间一长AI 在后续同类问题上的表现会越来越像“熟悉这个项目的老人”而不是每次都要从头摸索的临时工。superpowers 这套方法论最让我觉得有价值的地方就是它把 AI 从“随叫随到的执行者”变成了“有工作习惯的协作伙伴”。配置好之后你不再需要重复描述流程只需要描述业务目标就行。如果你也在摸索怎么让 AI 干活更稳定不妨花一个下午装起来试试按照上面的步骤跑一个小任务很快就能上手。