你们是不是也刷到过“superpowers”这个词手痒想装一套先说清楚它跟超级英雄电影没关系也不是什么特效工具。在AI编程这个圈子里superpowers 是一套给 Claude Code 用的工作流技能库community 里叫它“技能增强包”更贴切。简单说它把一套套经过实战验证的做事方法——头脑风暴、拆解任务、快速迭代、系统排查问题——打包成了 Claude Code 能直接调用的“skills”。这玩意儿解决一个特别扎心的问题Claude Code 默认很强但如果你只给它一句模糊指令它往往会“一把梭”一口气生成一大堆代码结果方向错了再从头返工。superpowers 的思路是反过来先逼着 Claude 做计划、拆分任务、小步快跑每一步都让你确认质量自然就稳了。这篇就用我的实操经历把“怎么安装、有哪些 skills、怎么引入这些技能、具体怎么用”一次性讲透。1. Superpowers 到底是什么不是超能力是给 Claude Code 的一套工作流技能库开始折腾之前先得建立正确的认知。superpowers 不是一个编程语言也不是一个独立软件它依赖 Claude Code 运行本质上是一组 Markdown 格式的技能指令包。1.1 它的核心设计理念用流程换质量默认情况下你跟 Claude Code 说“帮我写一个网页爬虫”它会立刻开始写。这事听着爽但问题很大任务目标模糊、边界不清、技术选型没确认它可能给你写出一个用不到的方案。比如你要的是轻量单文件脚本它却给你上了 Scrapy 框架加一堆配置文件。这不是模型笨而是它不知道该走什么流程。superpowers 做的事情是把“正确的做事流程”固化成技能。当你在对话里调用某个技能Claude Code 就会严格按照技能文件里的规则执行。比如brainstorm技能会强制它先给出多个方案让你选planning技能会强迫它把任务拆成可验证的小步每一步都要你确认后才继续。本质上这相当于给 Claude 装了一个“项目管理方法论”。1.2 它跟普通 Prompt 的区别在哪很多朋友会说“我自己写 Prompt 不也一样吗”区别大了。你自己写的 Prompt 每次都要复制粘贴、改来改去而且 Claude 不一定严格遵循。superpowers 的技能文件放在固定目录里Claude Code 启动时自动加载调用方式是触发词不是一大段Prompt。我再打个比方。普通 Prompt 是口头嘱咐“你好好干别偷懒”superpowers 是一份标准作业指导书SOP每一步做什么、输出什么格式、什么时候停下来问用户全写清楚了。结果就是我在实际使用中明显感觉到Claude 的产出稳定度和可追踪性提升了一大截不再是“黑盒生成代码”而是每一步都在你眼皮底下走。1.3 适合谁用能解决什么问题我强烈推荐这几类人试试经常用 Claude Code 写小工具、脚本的人superpowers 能减少返工尤其适合从零搭建一个新项目。做代码审查和调试的人它有专门的 investigate / debug 技能引导 Claude 先复现问题、再定位、再修复而不是瞎猜乱改。想批量复用工作流的人比如你有一套固定的开发流程建项目→写测试→跑测试→报错修复可以把这套流程固化成自定义技能。一句话总结它不改变 Claude 的能力上限但它能让你把 Claude 的能力稳定地发挥出来。2. 把 superpowers 装进 Claude Code两条安装路线与配置细节安装这块我踩过不少坑网上教程要么太简略要么直接让你 git clone结果克隆错目录技能根本没被识别。我把两条靠谱路线都写出来你按自己的具体情况选。2.1 前置条件先有一个能跑的 Claude Codesuperpowers 是 Claude Code 的插件所以第一步是确认 Claude Code 已安装且能正常使用。如果你还没装用 npm 全局安装npm install -g anthropic-ai/claude-code装完验证一下版本claude --version能输出版本号说明基础环境没问题。如果你平时已经在用 Claude Code直接跳过这一步。需要注意一点Claude Code 版本不能太老插件系统是后来加入的功能建议版本不低于 1.0 时代的较新版本。如果命令提示插件相关操作通常意味着版本兼容性有保障。初始化配置时Claude Code 会在用户目录生成一个.claude目录里面通常有settings.json等配置文件。记住这个路径后面要用到。在 macOS 上一般是~/.claudeLinux 上可能是~/.claude部分新版会放~/.config/claude不确定时可以录下面命令找ls -la ~/.claude ls -la ~/.config/claude2.2 方式一通过插件市场安装推荐这是目前官方推荐、也最省心的方式在 Claude Code 交互界面里直接输命令。启动 Claude Codeclaude进入交互之后依次输入以下两条命令/plugin marketplace add obra/superpowers-marketplace /plugin install superpowerssuperpowers-marketplace第一条命令是把插件市场源地址加进来第二条是从这个市场里拉取 superpowers 插件并安装。装完它会提示插件已启用通常在.claude/plugins目录下能看到对应文件。如果你的网络环境导致 marketplace 访问超时可以稍等重试或者改用下面的手动方式。安装成功后重启 Claude Code或者输入/plugin确认插件列表里有 superpowers 字样。2.3 方式二手动克隆到技能目录这种方式适合喜欢掌控文件位置的朋友也适合排查插件市场加载问题。核心思路是把技能文件放到 Claude Code 能扫描到的目录。第一步克隆仓库到本地某个固定位置。我一般放在~/.claude/plugins/marketplaces/下git clone https://github.com/obra/superpowers.git $HOME/.claude/plugins/marketplaces/obra-superpowers第二步如果你的版本支持“用户级技能目录”直接把这些技能软链或复制到~/.claude/skills/mkdir -p $HOME/.claude/skills cp -r $HOME/.claude/plugins/marketplaces/obra-superpowers/skills/* $HOME/.claude/skills/复制完成后技能目录里应该能看到一个个子文件夹每个子文件夹对应一个技能比如brainstorm、planning、debug。这些子文件夹里的SKILL.md文件就是技能定义。手动安装有个好处你可以随时打开SKILL.md看里面的具体规则遇到不生效的问题也能直接排查。坏处是后续更新插件要靠git pull不像插件市场那样可以用/plugin update。2.4 安装后的快速体检技能是否真的加载了不管用哪种方式装完都建议做一次体检。重启 Claude Code输入/superpowers或者直接问 Claude“你现在有哪些可用技能”如果它列出 brainstorm、planning、lightning、debug、generate 等一堆技能名说明加载成功。如果它说“没有找到技能”或者“技能目录为空”多半是路径不对回到 2.3 节重新确认目录结构。提示不同版本、不同时间的仓库技能清单会有所差异。我的经验是核心技能基本稳定但细节规则可能随版本更新变化以你实际装到的版本为准。3. superpowers 到底提供了哪些 skills清单与触发方式很多朋友最关心的就是“有哪些 skills”。我按用途分了几类把核心技能和触发思路列清楚。实际安装后技能文件里会有更完整的清单但下面这些是最核心、用得最频繁的。3.1 核心技能速览表技能名称解决的问题典型触发场景brainstorm生成多个方案供选择避免单一路径需求模糊、方向没定想快速开脑洞planning把复杂任务拆解成可执行步骤大功能开发、重构、多文件项目lightning快速迭代一次只做一个小改动并测试需要快速出原型边做边调investigate系统性地排查问题不靠猜出现 bug规则是先复现再定位debug引导 Claude 用调试工具定位异常报错信息明确但不知道根因在哪unscramble整理混乱、碎片化的用户需求你说不清想要什么或需求互相矛盾generate按最佳实践生成新项目骨架从零开发新工具、新脚本tidbits管理常用代码片段、小技巧库想把常用代码片段沉淀成模板relay把大型重构拆成多个安全的小步骤老代码改造、跨文件迁移这些技能不是让你记住名字才能用很多是“显式调用”。你可以直接在对话里说“用 brainstorm 技能帮我整理方案”Claude 就会严格走 brainstorm 流程先给多个角度再逐个展开最后让你选。3.2 三个最常用的技能详解brainstorm——避免一眼看穿答案的陷阱这个技能非常适合前期探索。使用方法很直接“用 brainstorm 技能分析一下我该用什么方案实现多格式导出”。它会强制自己不立刻给结论而是先抛出多个角度比如“生成文本文件的方案、用模板引擎的方案、引入第三方库的方案”每个方案附带优缺点最后整理成选项列表让你拍板。planning——先拆后做拒绝一把梭当任务大了直接让 Claude “写一个爬虫”很容易失控。我会先说“先进入 planning 技能把这个任务拆解好”。它会输出一个编号步骤清单每个步骤都写清楚做什么、完成后怎么验证并且一步步停下来让我确认。这一步对于半小时以上的开发任务几乎是必须的。lightning——小步快跑每步都跑得动如果你已经明确了目标只是希望 Claude 快速地做出一个能跑的版本用 lightning。我在实际开发中经常用它让 Claude 一次只实现一个小功能写一点、跑一下、确认无误后再继续下一步。别让 Claude 一口气生成长达300行的脚本很容易一个语法错误卡半天。3.3 如何查看和调用已有技能安装成功后调用技能有几种常见方式方式一自然语言触发。直接在对话里告诉 Claude “用 planning 技能”或“切换到 debug 模式”。它理解上下文的能力很强只要技能已加载基本都能正确响应。方式二显式命令。输入/superpowers类似命令会弹出技能列表供你选择。方式三路径对接。查看技能目录下的SKILL.md里面写明了触发规则。有些技能需要特定“触发条件”比如debug技能只建议在“用户报告了 bug 且附带了日志/报错”时触发。如果用了自然语言但 Claude 没有反应最稳妥的做法是直接把技能名说出来并附带一句“请严格遵循该技能文件中的步骤”它就会像打开手册一样按步执行。4. 实战演示用 superpowers 从零做一个 Python 小工具理论再多不如跑一遍。下面我用实际经历过的一个场景完整展示引入技能后 Claude Code 的工作方式。这个例子我选得很普通但越普通越能看出技巧的作用。4.1 我会选择哪个技能组合需求是这样的我临时要写一个“批量重命名图片文件的 Python 脚本”功能要求包括遍历目录、按规则重命名比如20250101_001.jpg这种格式、在终端打印改动日志。需求不算难但涉及文件操作有风险。我的处理方式先brainstorm方案再planning拆步骤然后lightning小步实现。因为文件操作一旦写错可能把图片搞乱所以必须谨慎。4.2 实际操作记录实际对话我大致还原一下。第一句话我说“用 brainstorm 技能帮我考虑这个脚本应该怎么设计需要考虑安全性。”Claude 没有直接写代码而是先列了几个角度方案A纯os.listdiros.rename轻量好读方案B用pathlib.Path.iterdir()路径处理更干净方案C加argparse做命令行参数方便复用同时提出一个 safety 建议先 dry-run只打印不实际改名确认没问题再加--apply参数执行这一步非常关键。如果是默认模式它大概率会直接抄起os.rename就写而不会想到 dry-run。这就是 brainstorm 的价值。第二步我说“采用方案B进入 planning 技能帮我拆解。”它立刻输出拆解清单扫描目标目录收集.jpg/.png等图片文件提取文件修改时间格式化文件名检查重命名后是否重名重名则加后缀打印预览清单dry-run只有在传入--apply时才真正执行重命名每一条都问我“是否确认”。我确认后它开始走 lightning 流程先写一个最小的扫描函数并运行打印出文件列表再写时间格式化逻辑并测试接着处理重名校验最后才接上--apply参数。每一步之间它都自动运行代码报错就地修复然后继续下一步。最终脚本大概 70 行没有一次性生成 200 行的情况而且每一步我都能看到中间输出。4.3 对比用与不用 superpowers 的差异同一需求我以前没用 superpowers 时Claude 会直接生成完整脚本然后我运行发现“重名处理不对”“没有权限打印完整日志”再基于报错来回改。用上 superpowers 后它天然就懂得这些坑提前想到 dry-run提前想到文件名冲突提前把日志格式写好。差异本质不是模型变聪明了而是技能文件里沉淀了“正确做文件操作任务要看重什么”。这些方法论靠你自己想很多时候想不到靠 Claude 自己发挥也不稳定但写进技能里就稳定了。我还做了一个小验证故意把需求说得含混一点比如只说“帮我写个重命名脚本”结果它第一次输出就少了 dry-run 和冲突处理。而调用 planning 后再做完整度高出不少。这就是“引入技能”和“写一句 Prompt”的差别。4.4 过程中的一个小技巧必要时要“打断”与“纠正”使用 superpowers 也不是无脑听它的。有一次 planning 拆解完步骤它打算把日志功能单独拆一个模块我就直接打断说“项目就一个文件不要拆成模块在同一个脚本里完成就行。”它立刻调整了计划。这个细节值得说技能的作用是提供流程但最高决策权永远在你这儿。你随时能改方向、砍步骤、换实现。5. 常见问题与排查装不上、不生效、冲突怎么处理装的活人多了问题自然也多。我把各种群里问得最多的几个问题整理成速查表基本覆盖九成情况。5.1 常见问题快速排查表问题现象可能原因解决办法plugin marketplace add报错或超时网络问题或地址变更改用 2.3 节手动方式确认仓库地址拼写无误插件装完但找不到技能目录版本差异用户目录不同检查~/.claude/skills与~/.config/claude/skills跟 Claude 说“用 brainstorm”没反应技能未被正确加载检查SKILL.md是否包含name和description字段技能被加载但执行不严格触发了名称相似的其他技能全名调用直接说“使用 planning 技能严格按步骤来”/plugin列表里看不到 superpowers插件 market 源未同步重跑 market add再执行/plugin update两个技能互相冲突自定义技能与内置重名先备份禁用或删除自定义技能保留官方版本5.2 排查思路技能不生效时从哪几步入手我经验是90% 的“技能不生效”都是路径或命名问题。第一步先确认技能文件位置对不对用ls查看~/.claude/skills/要看到类似brainstorm/SKILL.md的结构。如果只有插件包没有展开到 skills 目录Claude 就扫不到。第二步确认SKILL.md格式。打开这个文件开头必须有 YAML front matter--- name: brainstorm description: 当用户需要方案选型或头脑风暴时使用 ---name字段就是触发词description 是 Claude 判断何时调用该技能的依据。如果这个文件写得不规范Claude 可能根本不知道这个技能存在。手动安装的朋友最容易在这里翻车因为写自定义技能时 front matter 很容易漏。第三步重启会话。Claude Code 的技能加载是在会话启动时完成的中途放进去的新技能当前会话不一定识别重启一个干净会话往往就正常了。5.3 自定义技能的正确姿势既然 superpowers 本质是 Markdown 技能包你完全可以自己扩展。这个功能我越用越喜欢。创建自己的技能其实就是在技能目录下新建一个子文件夹里面放SKILL.md。比如我要做一个“代码审查助手”技能mkdir -p $HOME/.claude/skills/code-review touch $HOME/.claude/skills/code-review/SKILL.md然后编辑这个文件写上名称和描述再写正文规则。正文可以定义 Claude 的审查步骤先看架构、再看复杂度、再查错误处理、最后提优化建议。写好后重启会话输入“用 code-review 技能审查这段代码”它就会按你的规则走。这个能力意味着你不仅是在用别人定义的能技能还能把自己的工作流沉淀下来。我自己的体感是做项目时把流程写成技能项目结束就多了一个永久资产比记在笔记里强多了。以后再遇到同类任务一句话就能复用整套方法论这个价值很多朋友低估了。5.4 装完之后要怎么持续更新插件版本迭代不算慢。如果从插件市场装的更新非常方便/plugin update如果是git clone手动装的更新这样cd $HOME/.claude/plugins/marketplaces/obra-superpowers git pull更新后如果发现旧技能行为变了可以对比git diff看看改了哪些规则。我见过有人因为版本更新后 planning 步骤变多觉得不习惯直接回退 commit。这种操作虽然少见但也说明开源项目的一大好处行为可控。6. 我折腾这段时间的真实体会最后聊几句私货。我一开始接触 superpowers 是冲着一堆炫酷技能名去的结果第一次用 brainstorm 就被震住了Claude 居然会说“这个需求有几种理解方式”而不是直接写代码了。对一个习惯跟 AI “要东西”的人来说这个转变是需要适应的它不是更快地给你结果而是更稳地陪你走完流程。用久了你会发现superpowers 最有价值的不是某一两个技能而是它带来的“过程意识”。我后来自己写 Prompt 也下意识地遵循这套逻辑先列角度再拆步骤然后小步实现最后回头检查。它成了一个思考习惯而不仅是工具。说实话这种“方法论内化”的收益比多装几个技能大多了。如果你刚接触 Claude Code一开始先别贪多就装好 superpowers用 brainstorm planning lightning 这三个核心技能跑一两个小项目攒够感觉了再去看 debug、unscramble 这些偏场景的技能。技能不在多用顺了就是好技能。最后再分享一个小技巧把技能清单打印出来或者让 Claude 每次干活前先报一次“本次使用的技能”你会更清楚它每一步在干什么。透明度上来了你对结果的控制力自然也就上来了。 
长河君 · 2026/10/9 5:57:15 · 阅读 1.2k Superpowers：给 Claude Code 装上一套实战级 AI 编程工作流技能库
你们是不是也刷到过“superpowers”这个词手痒想装一套先说清楚它跟超级英雄电影没关系也不是什么特效工具。在AI编程这个圈子里superpowers 是一套给 Claude Code 用的工作流技能库community 里叫它“技能增强包”更贴切。简单说它把一套套经过实战验证的做事方法——头脑风暴、拆解任务、快速迭代、系统排查问题——打包成了 Claude Code 能直接调用的“skills”。这玩意儿解决一个特别扎心的问题Claude Code 默认很强但如果你只给它一句模糊指令它往往会“一把梭”一口气生成一大堆代码结果方向错了再从头返工。superpowers 的思路是反过来先逼着 Claude 做计划、拆分任务、小步快跑每一步都让你确认质量自然就稳了。这篇就用我的实操经历把“怎么安装、有哪些 skills、怎么引入这些技能、具体怎么用”一次性讲透。1. Superpowers 到底是什么不是超能力是给 Claude Code 的一套工作流技能库开始折腾之前先得建立正确的认知。superpowers 不是一个编程语言也不是一个独立软件它依赖 Claude Code 运行本质上是一组 Markdown 格式的技能指令包。1.1 它的核心设计理念用流程换质量默认情况下你跟 Claude Code 说“帮我写一个网页爬虫”它会立刻开始写。这事听着爽但问题很大任务目标模糊、边界不清、技术选型没确认它可能给你写出一个用不到的方案。比如你要的是轻量单文件脚本它却给你上了 Scrapy 框架加一堆配置文件。这不是模型笨而是它不知道该走什么流程。superpowers 做的事情是把“正确的做事流程”固化成技能。当你在对话里调用某个技能Claude Code 就会严格按照技能文件里的规则执行。比如brainstorm技能会强制它先给出多个方案让你选planning技能会强迫它把任务拆成可验证的小步每一步都要你确认后才继续。本质上这相当于给 Claude 装了一个“项目管理方法论”。1.2 它跟普通 Prompt 的区别在哪很多朋友会说“我自己写 Prompt 不也一样吗”区别大了。你自己写的 Prompt 每次都要复制粘贴、改来改去而且 Claude 不一定严格遵循。superpowers 的技能文件放在固定目录里Claude Code 启动时自动加载调用方式是触发词不是一大段Prompt。我再打个比方。普通 Prompt 是口头嘱咐“你好好干别偷懒”superpowers 是一份标准作业指导书SOP每一步做什么、输出什么格式、什么时候停下来问用户全写清楚了。结果就是我在实际使用中明显感觉到Claude 的产出稳定度和可追踪性提升了一大截不再是“黑盒生成代码”而是每一步都在你眼皮底下走。1.3 适合谁用能解决什么问题我强烈推荐这几类人试试经常用 Claude Code 写小工具、脚本的人superpowers 能减少返工尤其适合从零搭建一个新项目。做代码审查和调试的人它有专门的 investigate / debug 技能引导 Claude 先复现问题、再定位、再修复而不是瞎猜乱改。想批量复用工作流的人比如你有一套固定的开发流程建项目→写测试→跑测试→报错修复可以把这套流程固化成自定义技能。一句话总结它不改变 Claude 的能力上限但它能让你把 Claude 的能力稳定地发挥出来。2. 把 superpowers 装进 Claude Code两条安装路线与配置细节安装这块我踩过不少坑网上教程要么太简略要么直接让你 git clone结果克隆错目录技能根本没被识别。我把两条靠谱路线都写出来你按自己的具体情况选。2.1 前置条件先有一个能跑的 Claude Codesuperpowers 是 Claude Code 的插件所以第一步是确认 Claude Code 已安装且能正常使用。如果你还没装用 npm 全局安装npm install -g anthropic-ai/claude-code装完验证一下版本claude --version能输出版本号说明基础环境没问题。如果你平时已经在用 Claude Code直接跳过这一步。需要注意一点Claude Code 版本不能太老插件系统是后来加入的功能建议版本不低于 1.0 时代的较新版本。如果命令提示插件相关操作通常意味着版本兼容性有保障。初始化配置时Claude Code 会在用户目录生成一个.claude目录里面通常有settings.json等配置文件。记住这个路径后面要用到。在 macOS 上一般是~/.claudeLinux 上可能是~/.claude部分新版会放~/.config/claude不确定时可以录下面命令找ls -la ~/.claude ls -la ~/.config/claude2.2 方式一通过插件市场安装推荐这是目前官方推荐、也最省心的方式在 Claude Code 交互界面里直接输命令。启动 Claude Codeclaude进入交互之后依次输入以下两条命令/plugin marketplace add obra/superpowers-marketplace /plugin install superpowerssuperpowers-marketplace第一条命令是把插件市场源地址加进来第二条是从这个市场里拉取 superpowers 插件并安装。装完它会提示插件已启用通常在.claude/plugins目录下能看到对应文件。如果你的网络环境导致 marketplace 访问超时可以稍等重试或者改用下面的手动方式。安装成功后重启 Claude Code或者输入/plugin确认插件列表里有 superpowers 字样。2.3 方式二手动克隆到技能目录这种方式适合喜欢掌控文件位置的朋友也适合排查插件市场加载问题。核心思路是把技能文件放到 Claude Code 能扫描到的目录。第一步克隆仓库到本地某个固定位置。我一般放在~/.claude/plugins/marketplaces/下git clone https://github.com/obra/superpowers.git $HOME/.claude/plugins/marketplaces/obra-superpowers第二步如果你的版本支持“用户级技能目录”直接把这些技能软链或复制到~/.claude/skills/mkdir -p $HOME/.claude/skills cp -r $HOME/.claude/plugins/marketplaces/obra-superpowers/skills/* $HOME/.claude/skills/复制完成后技能目录里应该能看到一个个子文件夹每个子文件夹对应一个技能比如brainstorm、planning、debug。这些子文件夹里的SKILL.md文件就是技能定义。手动安装有个好处你可以随时打开SKILL.md看里面的具体规则遇到不生效的问题也能直接排查。坏处是后续更新插件要靠git pull不像插件市场那样可以用/plugin update。2.4 安装后的快速体检技能是否真的加载了不管用哪种方式装完都建议做一次体检。重启 Claude Code输入/superpowers或者直接问 Claude“你现在有哪些可用技能”如果它列出 brainstorm、planning、lightning、debug、generate 等一堆技能名说明加载成功。如果它说“没有找到技能”或者“技能目录为空”多半是路径不对回到 2.3 节重新确认目录结构。提示不同版本、不同时间的仓库技能清单会有所差异。我的经验是核心技能基本稳定但细节规则可能随版本更新变化以你实际装到的版本为准。3. superpowers 到底提供了哪些 skills清单与触发方式很多朋友最关心的就是“有哪些 skills”。我按用途分了几类把核心技能和触发思路列清楚。实际安装后技能文件里会有更完整的清单但下面这些是最核心、用得最频繁的。3.1 核心技能速览表技能名称解决的问题典型触发场景brainstorm生成多个方案供选择避免单一路径需求模糊、方向没定想快速开脑洞planning把复杂任务拆解成可执行步骤大功能开发、重构、多文件项目lightning快速迭代一次只做一个小改动并测试需要快速出原型边做边调investigate系统性地排查问题不靠猜出现 bug规则是先复现再定位debug引导 Claude 用调试工具定位异常报错信息明确但不知道根因在哪unscramble整理混乱、碎片化的用户需求你说不清想要什么或需求互相矛盾generate按最佳实践生成新项目骨架从零开发新工具、新脚本tidbits管理常用代码片段、小技巧库想把常用代码片段沉淀成模板relay把大型重构拆成多个安全的小步骤老代码改造、跨文件迁移这些技能不是让你记住名字才能用很多是“显式调用”。你可以直接在对话里说“用 brainstorm 技能帮我整理方案”Claude 就会严格走 brainstorm 流程先给多个角度再逐个展开最后让你选。3.2 三个最常用的技能详解brainstorm——避免一眼看穿答案的陷阱这个技能非常适合前期探索。使用方法很直接“用 brainstorm 技能分析一下我该用什么方案实现多格式导出”。它会强制自己不立刻给结论而是先抛出多个角度比如“生成文本文件的方案、用模板引擎的方案、引入第三方库的方案”每个方案附带优缺点最后整理成选项列表让你拍板。planning——先拆后做拒绝一把梭当任务大了直接让 Claude “写一个爬虫”很容易失控。我会先说“先进入 planning 技能把这个任务拆解好”。它会输出一个编号步骤清单每个步骤都写清楚做什么、完成后怎么验证并且一步步停下来让我确认。这一步对于半小时以上的开发任务几乎是必须的。lightning——小步快跑每步都跑得动如果你已经明确了目标只是希望 Claude 快速地做出一个能跑的版本用 lightning。我在实际开发中经常用它让 Claude 一次只实现一个小功能写一点、跑一下、确认无误后再继续下一步。别让 Claude 一口气生成长达300行的脚本很容易一个语法错误卡半天。3.3 如何查看和调用已有技能安装成功后调用技能有几种常见方式方式一自然语言触发。直接在对话里告诉 Claude “用 planning 技能”或“切换到 debug 模式”。它理解上下文的能力很强只要技能已加载基本都能正确响应。方式二显式命令。输入/superpowers类似命令会弹出技能列表供你选择。方式三路径对接。查看技能目录下的SKILL.md里面写明了触发规则。有些技能需要特定“触发条件”比如debug技能只建议在“用户报告了 bug 且附带了日志/报错”时触发。如果用了自然语言但 Claude 没有反应最稳妥的做法是直接把技能名说出来并附带一句“请严格遵循该技能文件中的步骤”它就会像打开手册一样按步执行。4. 实战演示用 superpowers 从零做一个 Python 小工具理论再多不如跑一遍。下面我用实际经历过的一个场景完整展示引入技能后 Claude Code 的工作方式。这个例子我选得很普通但越普通越能看出技巧的作用。4.1 我会选择哪个技能组合需求是这样的我临时要写一个“批量重命名图片文件的 Python 脚本”功能要求包括遍历目录、按规则重命名比如20250101_001.jpg这种格式、在终端打印改动日志。需求不算难但涉及文件操作有风险。我的处理方式先brainstorm方案再planning拆步骤然后lightning小步实现。因为文件操作一旦写错可能把图片搞乱所以必须谨慎。4.2 实际操作记录实际对话我大致还原一下。第一句话我说“用 brainstorm 技能帮我考虑这个脚本应该怎么设计需要考虑安全性。”Claude 没有直接写代码而是先列了几个角度方案A纯os.listdiros.rename轻量好读方案B用pathlib.Path.iterdir()路径处理更干净方案C加argparse做命令行参数方便复用同时提出一个 safety 建议先 dry-run只打印不实际改名确认没问题再加--apply参数执行这一步非常关键。如果是默认模式它大概率会直接抄起os.rename就写而不会想到 dry-run。这就是 brainstorm 的价值。第二步我说“采用方案B进入 planning 技能帮我拆解。”它立刻输出拆解清单扫描目标目录收集.jpg/.png等图片文件提取文件修改时间格式化文件名检查重命名后是否重名重名则加后缀打印预览清单dry-run只有在传入--apply时才真正执行重命名每一条都问我“是否确认”。我确认后它开始走 lightning 流程先写一个最小的扫描函数并运行打印出文件列表再写时间格式化逻辑并测试接着处理重名校验最后才接上--apply参数。每一步之间它都自动运行代码报错就地修复然后继续下一步。最终脚本大概 70 行没有一次性生成 200 行的情况而且每一步我都能看到中间输出。4.3 对比用与不用 superpowers 的差异同一需求我以前没用 superpowers 时Claude 会直接生成完整脚本然后我运行发现“重名处理不对”“没有权限打印完整日志”再基于报错来回改。用上 superpowers 后它天然就懂得这些坑提前想到 dry-run提前想到文件名冲突提前把日志格式写好。差异本质不是模型变聪明了而是技能文件里沉淀了“正确做文件操作任务要看重什么”。这些方法论靠你自己想很多时候想不到靠 Claude 自己发挥也不稳定但写进技能里就稳定了。我还做了一个小验证故意把需求说得含混一点比如只说“帮我写个重命名脚本”结果它第一次输出就少了 dry-run 和冲突处理。而调用 planning 后再做完整度高出不少。这就是“引入技能”和“写一句 Prompt”的差别。4.4 过程中的一个小技巧必要时要“打断”与“纠正”使用 superpowers 也不是无脑听它的。有一次 planning 拆解完步骤它打算把日志功能单独拆一个模块我就直接打断说“项目就一个文件不要拆成模块在同一个脚本里完成就行。”它立刻调整了计划。这个细节值得说技能的作用是提供流程但最高决策权永远在你这儿。你随时能改方向、砍步骤、换实现。5. 常见问题与排查装不上、不生效、冲突怎么处理装的活人多了问题自然也多。我把各种群里问得最多的几个问题整理成速查表基本覆盖九成情况。5.1 常见问题快速排查表问题现象可能原因解决办法plugin marketplace add报错或超时网络问题或地址变更改用 2.3 节手动方式确认仓库地址拼写无误插件装完但找不到技能目录版本差异用户目录不同检查~/.claude/skills与~/.config/claude/skills跟 Claude 说“用 brainstorm”没反应技能未被正确加载检查SKILL.md是否包含name和description字段技能被加载但执行不严格触发了名称相似的其他技能全名调用直接说“使用 planning 技能严格按步骤来”/plugin列表里看不到 superpowers插件 market 源未同步重跑 market add再执行/plugin update两个技能互相冲突自定义技能与内置重名先备份禁用或删除自定义技能保留官方版本5.2 排查思路技能不生效时从哪几步入手我经验是90% 的“技能不生效”都是路径或命名问题。第一步先确认技能文件位置对不对用ls查看~/.claude/skills/要看到类似brainstorm/SKILL.md的结构。如果只有插件包没有展开到 skills 目录Claude 就扫不到。第二步确认SKILL.md格式。打开这个文件开头必须有 YAML front matter--- name: brainstorm description: 当用户需要方案选型或头脑风暴时使用 ---name字段就是触发词description 是 Claude 判断何时调用该技能的依据。如果这个文件写得不规范Claude 可能根本不知道这个技能存在。手动安装的朋友最容易在这里翻车因为写自定义技能时 front matter 很容易漏。第三步重启会话。Claude Code 的技能加载是在会话启动时完成的中途放进去的新技能当前会话不一定识别重启一个干净会话往往就正常了。5.3 自定义技能的正确姿势既然 superpowers 本质是 Markdown 技能包你完全可以自己扩展。这个功能我越用越喜欢。创建自己的技能其实就是在技能目录下新建一个子文件夹里面放SKILL.md。比如我要做一个“代码审查助手”技能mkdir -p $HOME/.claude/skills/code-review touch $HOME/.claude/skills/code-review/SKILL.md然后编辑这个文件写上名称和描述再写正文规则。正文可以定义 Claude 的审查步骤先看架构、再看复杂度、再查错误处理、最后提优化建议。写好后重启会话输入“用 code-review 技能审查这段代码”它就会按你的规则走。这个能力意味着你不仅是在用别人定义的能技能还能把自己的工作流沉淀下来。我自己的体感是做项目时把流程写成技能项目结束就多了一个永久资产比记在笔记里强多了。以后再遇到同类任务一句话就能复用整套方法论这个价值很多朋友低估了。5.4 装完之后要怎么持续更新插件版本迭代不算慢。如果从插件市场装的更新非常方便/plugin update如果是git clone手动装的更新这样cd $HOME/.claude/plugins/marketplaces/obra-superpowers git pull更新后如果发现旧技能行为变了可以对比git diff看看改了哪些规则。我见过有人因为版本更新后 planning 步骤变多觉得不习惯直接回退 commit。这种操作虽然少见但也说明开源项目的一大好处行为可控。6. 我折腾这段时间的真实体会最后聊几句私货。我一开始接触 superpowers 是冲着一堆炫酷技能名去的结果第一次用 brainstorm 就被震住了Claude 居然会说“这个需求有几种理解方式”而不是直接写代码了。对一个习惯跟 AI “要东西”的人来说这个转变是需要适应的它不是更快地给你结果而是更稳地陪你走完流程。用久了你会发现superpowers 最有价值的不是某一两个技能而是它带来的“过程意识”。我后来自己写 Prompt 也下意识地遵循这套逻辑先列角度再拆步骤然后小步实现最后回头检查。它成了一个思考习惯而不仅是工具。说实话这种“方法论内化”的收益比多装几个技能大多了。如果你刚接触 Claude Code一开始先别贪多就装好 superpowers用 brainstorm planning lightning 这三个核心技能跑一两个小项目攒够感觉了再去看 debug、unscramble 这些偏场景的技能。技能不在多用顺了就是好技能。最后再分享一个小技巧把技能清单打印出来或者让 Claude 每次干活前先报一次“本次使用的技能”你会更清楚它每一步在干什么。透明度上来了你对结果的控制力自然也就上来了。