最近 GitHub 上有个叫 superpowers 的项目热度很高我第一时间就把它装回来试了。先说结论如果你在用 Claude Code 做自动化开发这玩意儿值得花半小时折腾一下。它不是某个单一功能而是一整套可插拔的 skills技能包集合能覆盖任务规划、代码生成、记忆管理、测试编写、子代理调用这些高频场景。装上之后你的 AI 编程助手就不再是“你问一句它答一句”的应答机而是有了一套自己的做事流程会拆任务、会记住上下文、会在动手写代码之前先给你一份可以审阅的计划相当于把一个新手程序员直接培训成有规范的老手。这篇内容我打算把 superpowers 的定位、安装、核心 skills 拆解、真实场景用法和踩坑经验一次讲透。之前搜索的时候发现很多人卡在“怎么引入这些技能”这一步还有人装完之后不知道每个技能到底怎么触发所以我尽量写得细一点你跟着操作就行。1. superpowers 到底是什么它解决了什么问题1.1 为什么叫“超能力”superpowers 的作者是 Jesse Vincent在 GitHub 上开源了一套用于 Claude Code 的 command 和 skills 集合。所谓“超能力”其实就是一组预置的行事准则和操作方法让 AI 在接到任务之后不是直接瞎猜乱写而是按照一套成熟的工程流程去思考。这套东西解决的痛点非常具体。用过 Claude Code 的人都知道默认模式下你让它“帮我加个登录功能”它可能直接就开始改文件了。小需求倒还好一旦碰上多文件改动、牵扯老逻辑的任务它很容易半路写崩或者改完 A 忘了 B。superpowers 的做法是把“先想清楚再动手”变成强制流程每个核心技能都在引导模型拆解需求、评估影响面、分步执行而不是拿整个仓库冒险。另外它还解决了一个更隐蔽的问题上下文丢失。很多 AI 编程工具用久了你会发现它记不住你项目的背景每次会话都像失忆。superpowers 里有一套记忆管理机制可以让 AI 把项目知识、决策记录、API 约定这些信息持久化下来下次会话自动加载这个后面我详细说。1.2 它和插件、扩展的区别在哪里目前 Claude Code 生态里有三类增强方式插件plugins、命令commands、技能skills。superpowers 恰好把后两者都占了。插件更像“多个功能的打包分发”可以一次性引入做统一管理。而 superpowers 的目录结构本身就是一个大仓库里面按 skills 和 commands 分门别类你可以理解为它把一堆“技能说明书”放到了模型能看见的地方。关键区别在于 skills 的工作方式。它不是一个能被直接调用的函数而是一份带指引的“小手册”。每个 skill 对应一个目录里面通常有 SKILL.md 文件内容包括这个技能什么时候用、用之前必须先做什么、执行时该遵守什么规则、输出格式长什么样。模型通过读取这些 Markdown 文本相当于“临时学会了”一种新的工作方法然后套用到你的任务上。这种设计思路相比写死逻辑的插件要灵活得多因为 Markdown 描述天然可修改、可增删你完全可以把某个技能改造成适合自己团队的一套流程不需要写一行正经代码。1.3 适合什么人用我自己用下来感觉superpowers 最适合的是这四类人第一类重度使用 Claude Code 写业务代码的开发者尤其是频繁做多文件改造、重构、跨模块开发的人它能把这类高风险活变得有序。第二类对 AI 编程输出质量不满意、总觉得“还要返工”的人。它强制 AI 先出计划再执行至少能把你的返工率压下一截。第三类想给团队统一 AI 使用流程的工程负责人你可以在 superpowers 基础上定制一套团队规范所有人共享同样的工作流。第四类单纯对 AI agent 玩法好奇的技术爱好者里面的技能本身就是很好的学习素材。如果你只用 AI 聊天、不写代码那暂时用不上它它是给 Claude Code 这类编码代理准备的。2. 安装与初始化从零到能用的一整套配置2.1 前置准备先确认你的环境安装之前先检查三件事缺一个后面都可能白折腾。第一Claude Code 的版本。superpowers 官方推荐的是最新版并且要求 Claude Code 版本不低于 1.0.33不同时期要求可能略有变化以官方 README 为准。旧版本对 subagent 的调度能力不够跑下钻流程时会卡住。检查命令很简单直接在终端里执行claude --version如果版本偏低先升级再继续。第二确认你本机已经装了 git 和 Node.js这两个是基本依赖macOS、Linux、WindowsWSL 环境下体验最好都能跑。第三检查你的 ~/.claude 目录是否存在。如果从来没改过配置这个目录可能还没有需要手动创建mkdir -p ~/.claude注意如果你之前已经用了一段时间的 Claude Code并且自己改过 ~/.claude/settings.json安装 superpowers 之前建议先备份一份原配置避免后续排查问题时不知道哪里改坏了。2.2 克隆与部署两种方式任选安装方式其实不复杂就是把仓库里的 skills 和 commands 目录复制到 Claude Code 的配置目录里。先克隆仓库git clone https://github.com/obra/superpowers.git克隆完成之后进入目录看下结构你会发现里面有 skills 和 commands 两个核心文件夹另外还有 plugins 目录和 README。接下来你需要把这几个目录的内容放到 ~/.claude 下面从而实现全局加载cd superpowers mkdir -p ~/.claude/skills mkdir -p ~/.claude/commands cp -R skills/* ~/.claude/skills/ cp -R commands/* ~/.claude/commands/如果官方仓库后续提供了 plugins 的话可以按需复制到 ~/.claude/plugins 目录目前主流的用法还是以 skills 和 commands 为主。这里补充一种更简单的做法。原作者提供了安装脚本你可以在 ~/.claude 目录下执行claude install superpowers或者按 README 推荐的方式运行一键安装脚本。如果上述命令找不到也可以用最原始的方式先把仓库克隆下来然后把里面的 skills 和 commands 复制到对应目录效果完全一样。我个人的建议是手动操作一次至少你能搞清楚文件到底放在哪里后面出问题时排查起来心里有数。2.3 配置权限与验证是否成功superpowers 的很多技能会触发 Claude Code 执行 shell 命令、读写文件甚至调用 MCP 工具。如果权限拦得太死技能会“静默失败”——表面上好像没什么反应实际核心步骤根本没执行。所以装完之后建议检查一下 ~/.claude/settings.json 的 permissions 配置。举个例子如果你的配置里只允许 read 权限、禁止了 write那么所有涉及生成文件、修改代码的技能都会失效。一个宽松但不至于危险的配置长这样{ permissions: { allow: [ Read, Write, Edit, Glob, Grep, Bash, WebFetch ], deny: [] } }注意Bash 权限要谨慎放开建议配合 allow 规则只允许特定命令而不是大开所有 shell 操作。你可以在 allow 里精确列出命令比如 Bash(npm run test:*)这样既能跑测试又不至于让 AI 随意执行任意 shell 指令。配置完之后验证是否加载成功。在 Claude Code 交互界面里输入斜杠看看命令列表里有没有 superpowers 相关的 command。或者直接在会话里问它“你现在加载了哪些 skills”看它的回答是否包含 brainstorming、bounded-code-generation、create-branch 这些名字。如果完全没有多半是文件目录放错了位置或者配置文件没生效。另外有个细节值得提一下有些用户习惯把 skills 直接复制到项目的 .claude/skills 目录里这样做只对当前项目生效作用是隔离不同项目的技能集。全局安装和项目级安装不冲突甚至可以同时存在项目级会覆盖全局的同名技能。我自己偏向把通用技能全局装把团队定制版技能放项目级。2.4 安装后的目录结构长什么样装完之后你的 ~/.claude/skills 目录会变得很热闹大概有十多个子目录。每个子目录代表一个独立技能。这里我挑几个典型的列出来方便你对照检查是否安装完整~/.claude/skills/ ├── adaptive-memory/ # 长期记忆管理 ├── bounded-code-generation/ # 受控代码生成 ├── brainstorming/ # 头脑风暴与方案生成 ├── create-branch/ # 自动创建分支 ├──>