★ FEATURED ARTICLE 1. 项目概述1.1 Superpowers到底是什么如果你已经在用 Claude Code、Cline 这类 AI 编程助手写代码大概率会遇到同一个尴尬AI 虽然很强但是每次对话都像第一次认识你一样毛手毛脚没有章法。改个需求它能给你把整个项目目录拆了重造写个测试它能写出三百个断言然后告诉你“我觉得我覆盖得很全面”做代码审查它倒是积极但净找些拼写错误和“建议加个注释”之类的废话当成果。Superpowers 就是为了治这个毛病出现的。简单来说它是 GitHub 上一个开源的技能包集合专门给 Claude Code 这类编程助手增加一套结构化、可复用的“技能树”。安装之后你可以在对话里明确地告诉 Claude“使用 code-reviewer 技能审查这段代码”“用 master-planner 技能先做任务规划”然后 Claude 就会调用对应的技能按预设的流程、步骤、输出格式来工作。你拿到的就不再是“AI 的随性发挥”而是一套相对稳定、可预期、有检查点的协作流程。这个项目火起来不是没有原因的。它的核心是把大量真实开发场景中“老师傅才会做的事”固化成了一套可执行的技能文件——比如重构、代码审查、决策判断、TDD测试驱动开发、架构探索、任务拆解——然后让 Claude 照着做。等于说你给 AI 请了一群“特聘顾问”按需点名干活。适合谁三类人最该看被 AI 生成代码搞到血压高的个人开发者想在团队里统一 AI 协作规范的技术负责人以及刚接触 Claude Code 但想直接上手高级用法的新手。1.2 它的核心使用场景我把这几个月用下来的实际感受先放这儿这个技能包最值钱的三个场景是——复杂任务拆解、代码审查、基于测试驱动的功能开发。先说任务拆解。以前让 Claude 处理“帮我给这个模块加个离线缓存”这种需求它通常会闷头开始写代码写完才发现接口设计不合理返工是家常便饭。用 master-planner 技能之后它会先做上下文分析、列出影响面、拆出步骤、标注风险点、给出回滚计划——这些做完才会动手。第一次看到它输出这么完整的规划我确实愣了一下这不就是一个合格工程师该有的职业病吗。代码审查就更实用了。code-reviewer 技能会按一套固定的审查清单去扫代码——设计缺陷、并发问题、边界条件、可测试性而不是盯着代码风格挑毛病。有一回我故意丢了一段带明显并发 bug 的代码给它它不只找出了竞态条件还直接把触发时序画成了文本图那个专业程度比我见过的不少同事都靠谱。至于 TDD测试驱动开发tdd-guide 技能会严格按“先写失败测试→实现最小代码→验证通过→重构”的循环来推进。对习惯了“先实现再补测试”的人来说这个技能会让你整个开发节奏脱胎换骨。后面我会把安装方法、技能体系、实战拆解、踩坑总结全部展开来讲保证你看完能直接上手。2. 核心价值拆解为什么这个技能包值得装2.1 从“会说话的代码生成器”到“有章法的协作者”要理解 Superpowers 的价值得先理解 Claude Code 这类工具在默认状态下有多“没谱”。默认的 Claude 就像个天资极高但没受过正规训练的新人——你给它一个模糊任务它能给你写出一大堆代码看起来什么都干了但仔细一查命名混乱、边界没处理、扩展性为零。你要是有耐心一步步追问和纠正它也能改好但这个过程极其消耗精力比你自己写还累。Superpowers 做的事情本质上是把“好工程师的工作方式”标准化。它的每个技能文件里都写了非常具体的指令——比如“在开始重构之前必须先列出所有受影响的调用点”“在写任何测试之前必须先确认失败的断言是什么”“在给出方案之前必须先列出至少两个备选并说明取舍”。这些指令约束了 AI 的行为模式把它从“有话就说”变成“先想后说、按章办事”。打个比方默认 Claude 就像一个没做过餐饮的亲戚来帮你做年夜饭热情很高但切菜手法全凭感觉。装完 Superpowers 之后相当于你给了他一本“米其林后厨手册”——什么时候备菜、什么时候热锅、什么火候起菜、出菜前怎么摆盘全有固定流程。端上桌的菜不一定能拿三星但至少不会翻车。我自己实测下来装了技能包之后AI 在几个关键维度上的表现提升是肉眼可见的上下文意识它会主动声明“我基于当前项目的哪些信息做出了这个判断”而不是凭空发挥风险前置动手前先讲风险、先列影响面、先提回滚方案输出稳定性同一类任务十次输出的一致性明显提高不再是每次都要重新调教可监督性它的推理过程被拆成了明确的步骤你能在它做每一步的时候及时纠偏2.2 技术原理技能包到底做了什么很多第一次接触的朋友会好奇这不就是一堆 Markdown 文件吗凭什么能“改造” AI 行为原理确实不复杂但很聪明。Superpowers 的核心机制依托于 Claude Code 的Agent Skills能力。简单来说Claude 在对话中可以通过读取技能文件来获得“临时专业知识”。技能包利用这个机制在项目里放了一套skills/目录每个技能是一个或多个 Markdown 文件里面包含技能的职责边界、工作流程、操作步骤、输出格式、检查清单甚至还有不允许做的事项。当你在对话里明确说出某个技能名称时Claude 会把对应的技能文件内容加载进上下文然后严格按照指令执行。比如skills/code-reviewer.md里写明了“审查时必须从正确性、并发安全、错误处理、可扩展性四个维度进行每发现一个问题必须标注严重级别并给出修复建议”Claude 加载之后审查质量会直接刷新一个档次。这里有一个“为什么值得关注”的点这个东西没有改变模型本身的推理能力它改变的是输出的组织方式和思考路径。模型的能力上限就在那儿但技能包能让它把能力用在正确的地方、按合适的顺序输出。这叫“外挂工程纪律”。2.3 安装它需要什么基础条件动手装之前先确认几件事免得装到一半发现环境不兼容自己在那折腾半天。第一安装前提是有 Claude Code 或其他兼容 Agent Skills 机制的终端工具。Superpowers 部分功能需要较新的 Claude 模型版本太老的模型不支持技能加载机制装上也白装。第二对终端基本操作要熟练。整个安装过程没有可视化界面全程命令行操作。你不会cd、不理解相对路径和绝对路径的区别装起来会比较痛苦。这个门槛不高但确实存在。第三最好对 Git 的基本用法有概念——你至少得知道git clone是在干什么。后续技能包要更新也得靠 git pull 拉新版本。如果你满足上面三个条件那接下来按照我的操作步骤走整个过程大概十分钟左右。我第一次装的时候慢一点花了十五分钟主要是在思考目录结构该怎么规划这个我下面会专门讲。3. 安装与引入一步一步实操3.1 获取技能包克隆仓库安装 Superpowers 的第一步是把项目从 GitHub 克隆到本地。打开终端进入你计划存放技能包的工作目录我个人的习惯是放在~/skills/这个统一目录下因为多个项目可以共用同一份技能文件不用每个项目都复制一份cd ~/skills git clone https://github.com/obra/superpowers.git克隆完成后检查一下目录结构cd superpowers ls -la正常情况下你应该能看到skills/目录里面是各种技能文件可能还有superpowers/子目录用于存放主配置。确认没问题后这个步骤就算完成。注意如果你所在网络环境访问 GitHub 不稳定可以考虑使用可靠的镜像站点或适当调整网络方案后再操作但这里不展开讨论网络层面的内容。3.2 将技能包关联到项目技能包下载到本地还不够你需要让 Claude Code 知道去哪里找这些技能。Claude Code 加载技能的方式是在项目目录下通过配置文件来引用的。主流做法是编辑项目根目录下的CLAUDE.md文件如果项目还没有这个文件就手动新建一个。在CLAUDE.md里写入下面这段引用配置# 项目指南 ## Skills 引用 本项目使用 Superpowers 技能包。技能包位于 ~/skills/superpowers/skills/。 当用户请求执行以下任务时必须加载并使用对应技能 - 任务规划/拆解 → master-planner - 代码审查 → code-reviewer - 测试开发 → tdd-guide - 决策辅助 → decider - 其他技能请从技能目录中按需加载这段配置的作用是每次 Claude Code 在这个项目目录下启动时它会读取CLAUDE.md从而知道自己可以从哪个路径加载技能文件。配置务必写对路径不然 Claude 找不到技能就会出现“技能不存在”的报错。如果你的技能包放在其他位置替换上面的路径即可。还有一点要提醒技能包路径尽量不要带空格和中文有些工具对路径的解析不够健壮会让加载失败。3.3 配置自动加载与验证CLAUDE.md只是告诉 Claude“有这个技能、放哪了”但具体要不要自动加载取决于你的配置。如果你想省事可以让 Claude 在每次会话启动时自动扫描技能目录并做索引这样你就不需要手动“点名”了。在CLAUDE.md里增加一段## 技能加载 会话启动时请扫描 ~/skills/superpowers/skills/ 目录加载所有技能文件并建立技能索引。后续对话中当任务涉及相关领域时自动选用对应技能执行。配置完成后重启 Claude Code 会话输入一条简单的指令验证是否生效列出当前可用的技能名称并简述每个技能的主要用途如果配置成功Claude 会给你列出一个技能清单比如 code-reviewer、master-planner、tdd-guide、decider、visual-debugger、architecture-explorer 等等。看到这个清单恭喜你安装已经成功接下来就是正经使用了。4. 技能体系全盘点有哪些干货能用4.1 核心技能逐个拆解装好之后我建议你先别急着用花十分钟把这个技能包里到底有哪些东西摸清楚。技能包内置了十几个技能每个都有自己的适用场景。我挑几个重点的详细介绍其他的简单过一遍。master-planner主规划师——最常用的技能之一。当你面对一个复杂的开发任务时直接说“用 master-planner 技能规划这个任务”它会要求你先补充任务背景、目标、约束条件然后输出任务理解、影响面分析、实施步骤、风险清单、验收标准、回滚方案。实测下来这一步能极大地减少“AI 闷头写崩了再返工”的概率。code-reviewer代码审查员——专门做代码审查。它会按一套严肃的审查纪律来扫代码先整体理解模块职责再逐个检查正确性边界、并发问题、错误处理路径、资源释放、可扩展性设计。每发现一个问题标注严重级别Critical / Major / Minor并给出具体修复建议。我试过投喂一段自己写的有 bug 的代码它找到的 80% 的问题确实是真问题。tdd-guide测试驱动开发向导——严格按 TDD 的红-绿-重构循环工作。它会要求你先写测试确认测试确实失败红再写最小实现代码让测试通过绿然后做重构。这技能适合正在学习 TDD、或者想训练 AI 按 TDD 节奏写代码的人。需要提醒的是使用这个技能之前你最好对 TDD 的基本概念有所了解否则 Claude 会从头“教育”你那个过程有点煎熬。decider决策者——当你面临方案取舍时使用。比如你纠结“这个功能是放前端算还是后端算”“用 PostgreSQL 还是 MongoDB”“该不该引入消息队列”decider 会引导你把问题结构化拆解——列出关键决策因素、给每个因素权重、对比各选项的得分、最后给出带理由的结论。它不是替你拍板是逼你把决策过程想清楚实测对个人项目和技术选型很有帮助。bias-detector偏见检测器——专门检查方案里的思维误区。比如是否过度工程化、是否被首因效应带偏、是否忽略了沉默成本。这技能适合在重大技术决策前先跑一遍给方案“照个 CT”。system-guide系统思维引导——当问题比较复杂、影响面超出单点时使用。它会要求你用系统思维的方式看问题存量-流量、反馈循环、滞后效应、涌现行为。我一般在分析系统性能瓶颈或架构演进路径时会调用它。kiss-protocol保持简单协议——督促你用最小可用方案解决问题。它的核心指令是“在提出任何方案前必须先定义这个问题的最小解决路径”。对容易陷入“设计癖”的人来说这个技能就是一剂清醒药。visual-debugger视觉调试器——主要用于前端样式、布局和视觉问题的定位。你贴段 HTML/CSS它会用文本形式描述渲染信息和层级关系帮你定位样式问题。architecture-explorer架构探索者——用于理解当前项目或代码库的架构。你告诉它项目概况它会主动探索目录结构、模块依赖、数据流然后输出架构地图、关键模块说明、扩展性风险。4.2 技能之间的组合用法技能不缺更重要的是会组合。我实际用下来最顺手的几个组合套路分享给你规划 决策 审查的三步走。接到复杂需求先用 master-planner 做整体规划发现关键节点上有多个技术方案时调用 decider 做取舍方案定下来之后在实施过程中用 code-reviewer 做阶段性质检。这一套组合能覆盖大部分需求的完整生命周期。TDD 审查的闭环开发。写新功能模块时用 tdd-guide 从测试开始推着走实现完成后立刻用 code-reviewer 对测试质量和实现质量做一轮审查。你会发现 AI 自己审查自己写出来的代码时还挺能挑错的——因为它换了一个技能模式思考路径完全不同。系统思维 审查的性能专项。遇到性能优化的课题先用 system-guide 构建对整体运行机制的理解再用 code-reviewer 聚焦热点代码做精细化审查最后用 decider 来决定优化方案。这套组合在处理棘手的性能问题时出奇地稳。技能包的价值不在于某一个技能多强而在于它让你跟 AI 的协作有了一整套“工作流”什么时候该用哪个技能、什么环节该检查什么都变成了明确的约定而不是每次新手见面的猜谜游戏。5. 一个完整实战从需求到验收的全流程5.1 任务背景与我设定的目标为了让你对使用流程有体感我拿一个自己最近做的真实模块举例——给一个内容管理系统的文章模块新增“定时发布”功能。需求不复杂用户可以指定一个未来时间系统到点自动把草稿状态的文章变为已发布。这个任务按正常开发估计要一天左右我刻意用 Superpowers 的流程来走一遍看看 AI 协作模式下能压缩到什么程度。我给自己设的目标是代码能跑、测试能过、代码质量过得去、整个流程有记录。5.2 用 master-planner 完成任务规划会话开始我输入用 master-planner 技能来规划这个任务文章模块新增定时发布功能用户可以指定未来时间自动发布草稿。请先做完整的规划。Claude 加载 master-planner 技能后没有直接丢实现方案而是先向我确认了几个问题定时发布是“到点自动触发”还是“允许用户取消”定时任务在服务端用什么调度机制失败重试策略是什么我把需求细化之后告诉它它给出了一份规划影响面分析涉及文章表结构新增 scheduled_publish_at 字段、文章状态机草稿→定时中→已发布、后台任务调度器、文章列表页展示实施步骤分四步——第一步改数据库表结构第二步改文章状态逻辑第三步写定时任务处理器第四步改管理后台上传/编辑逻辑风险清单时区问题用户输入的时间是本地时间还是 UTC、定时任务的精度、任务失败后的状态恢复验收标准草稿文章可设置定时发布、到点自动转为已发布、列表页有状态标识、失败任务有日志看到这份规划我是比较满意的。它把时区问题和失败恢复都列出来了这些恰恰是定时发布功能里最容易翻车的两个点。这个环节充分体现了技能包把 AI 从“写码工”变成“工程师”的核心价值。5.3 用 tdd-guide 驱动功能实现规划确认后我让 Claude 进入实现环节这次点名用 tdd-guide 技能用 tdd-guide 技能来实现定时发布的后端逻辑。先写测试再写实现。tdd-guide 技能会严格指挥节奏先写失败测试→运行确认失败→写最小实现→运行确认通过→重构。实际执行下来AI 写了三组测试文章可设置定时发布时间未到时间状态保持“草稿”且查询接口不返回时间到达后状态自动转为“已发布”。每组测试都先跑一遍红了再加实现节奏把握得很好。中途我注意到它的实现里对时区处理用了timezone.utc主动问了一句“为什么不用本地时间”它引用技能里的检查清单回答说定时任务服务器通常部署在 UTC 环境所有持久化时间统一用 UTC前端展示再转换。这个回答在点上说明技能里固化的最佳实践真的被模型执行了。5.4 用 code-reviewer 做阶段质检实现完成后我没有立刻收工而是让 Claude 用 code-reviewer 技能对刚才的代码做一轮彻底审查用 code-reviewer 技能审查刚才写好的定时发布功能代码。重点检查并发安全、时区处理、失败恢复。审查结果让我挺意外——它抓到了三个我自己没注意到的问题。第一定时任务扫描文章中在 SQL 查询里对scheduled_publish_at做时间判断时没有索引文章量大了之后会全表扫描第二如果服务器在任务执行中途宕机已置为“发布中”状态但未真正发布的文章会卡死第三请求取消定时发布时数据库更新和任务队列移除操作不在一个事务里可能造成状态不一致。这些问题的级别被 code-reviewer 标为 Major 和 Critical它给的修复建议也都对路。在这个环节我强烈感受到技能包的价值——如果不开这个技能AI 自己是不会主动回头审视这些边角问题的。5.5 用 decider 敲定失败恢复方案关于失败恢复我在 review 阶段发现了一个方案分歧失败任务的恢复是用“状态机回滚”还是“任务调度器补偿”。我让 Claude 用 decider 技能帮我做决策。decider 带我走了一遍完整决策流程列出决策因素——实现复杂度、数据一致性、运维可观测性、故障恢复时间给权重——数据一致性最高、复杂度其次对比方案——状态机回滚实现简单但一致性弱调度器补偿实现复杂但能在秒级恢复且一致性强最终结论是调度器补偿方案更优但建议分阶段实施——第一版先做状态机回滚加失败日志后续迭代再做真正的补偿调度。这个结论理性且务实决策过程也完全透明。整个任务从规划到实现到审查到决策全程大概花了一个半小时放到正常开发节奏里这个速度是比较可观的。6. 常见问题与排查技巧实录6.1 安装与加载阶段的坑装技能包的过程中最容易踩的坑是路径问题。我统计了一下自己和其他使用者的反馈90% 的首次安装失败都出在技能路径没写对上。典型场景是技能包放在~/skills/superpowers/skills/但CLAUDE.md里写成了~/superpowers/skills/或者相对路径写错了。症状是调用技能时 Claude 提示“未找到该技能”或“技能文件不存在”。排查方法很简单先手动确认路径有没有问题ls ~/skills/superpowers/skills/如果能看到master-planner.md、code-reviewer.md这些文件说明路径没错如果ls都报错那配置文件里大概率也是错的。还有一种情况是技能包放在项目目录内部了比如/项目名/superpowers/skills/这时候CLAUDE.md里应该写相对路径但我实测下来绝对路径的加载成功率更高因为相对路径在不同启动方式下会有偏差。另一个高频问题自定义技能文件放不进技能列表。原因是 Claude Code 对技能文件的命名和目录层级有要求——每个技能必须单独成目录目录内必须有SKILL.md文件文件名不能有空格和特殊字符。如果你把一堆技能文件平铺在目录下Claude 是识别不了的。6.2 使用过程中的翻车现场第一个翻车现场是技能冲突。有次我同时让 Claude 处理一个重构任务又要求它严格遵守 TDD 流程结果 Claude 在“先写测试”和“重构现有代码”之间产生了逻辑打结——它不确定該先做哪个。后来我在指令里明确了优先级重构任务用 code-reviewer 做前置分析TDD 只约束新代码部分冲突立刻消失。经验是多个技能同时使用时一定要写清楚它们的边界和调用顺序。第二个翻车现场是上下文超载。技能文件本身写得很详细同时加载十几个技能后上下文窗口会被大量技能文本占满留给实际代码的空间变小模型容易“忘掉”你最早给的需求。实测下来10 个技能同时常驻会让 200K 上下文的可用空间减少约四分之一。解决办法只在CLAUDE.md里写最常用的三到五个技能其他技能临时用临时点名。第三个坑是技能被过度执行。有些时候你只是随口问一句“这段代码你觉得怎么样”Claude 如果默认加载了 code-reviewer就会输出一大篇正式审查报告。解决方法是给技能设定激活条件——在CLAUDE.md里写清楚“只有在用户明确要求审查时才使用 code-reviewer”。6.3 常见问题速查表症状可能原因解决办法调用技能时提示未找到路径配置错误用ls验证路径修正CLAUDE.md技能列表为空技能文件不符合命名规范确认目录内有SKILL.md同时加载后对话质量下降上下文被技能文本挤占精简常驻技能数量技能行为与其他需求冲突技能边界未说清明确优先级和调用顺序技能执行得“过度”技能被无条件激活配置文件增加激活条件技能更新无效果本地仓库未同步git pull更新技能包这张表是我自己踩过的坑浓缩出来的贴在这儿给后来人当个速查手册。实际遇到问题的时候先对着表排查一遍绝大多数都能解决。7. 几个独家心得与调优建议7.1 根据自己的工作流裁剪技能包Superpowers 自带的技能很全但全不等于适合你。我建议拿到包之后先把你自己的日常工作流列一遍然后从技能包中挑选真正匹配的做个“最小技能集”。以我自己为例我做独立开发日常工作是写后端接口、做数据库设计、偶尔改前端样式。我最终保留的常驻技能只有五个master-planner规划、code-reviewer审查、tdd-guide开发、decider决策、visual-debugger样式排查。剩下的技能我全部从常驻列表移除了要用的时候手动点名。这个操作让我和 Claude 的协作效率明显上升——上下文被技能占用的比例降低Claude 在对话中的“记忆”更准确了。7.2 把技能包和你的项目沉淀结合技能包是通用工具但你的项目有特定的规范、偏好和约定。一个提升巨大的做法是把这些项目特有的规范追加到技能包里形成“专属增强版”。比如我的项目里有一条约定错误信息必须用统一格式、必须关联错误码。我把这条写进了code-reviewer.md的检查清单里每次审查时 Claude 就会格外留意错误处理代码是否符合这个规范。再用一段时间你甚至可以为项目写一个专属技能比如“本项目的接口设计规范审查”每次出接口设计时自动跑一遍效果非常稳定。7.3 后续可以怎么扩展Superpowers 的潜力远不止 Claude Code 这一个场景。我最近在实验的是把这套技能文件用在自己的笔记系统和文档体系里——因为技能的本质就是“标准作业流程”你完全可以把写作任务、审核任务、数据分析任务都用同样的格式固化下来。比如我给自己的技术博客写了一个“writer-skill”内容是文章选题、结构、引入、代码示例、配图建议的检查清单写文章时让 Claude 按这个流程来输出质量稳定很多。也就是说学完这个技能包的安装和使用之后你带走的不只是一套工具更是一个可以复用到任何领域的“流程思维”把好的做事方法标准化、文件化、可执行化。这个东西比工具本身值钱得多。根据我个人试用的体会Superpowers 目前已经是 AI 辅助开发这个方向上最值得推荐的技能体系之一。如果你还在“AI 生成代码但返工严重”的阶段挣扎装好它、用好它把 AI 当新员工来带而不是当搜索引擎来用你的产出速度和代码质量都会有一个非常实在的提升。
阅读完成 · 觉得有帮助？
