企业官网建设流程全解析

最近 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、Windows（WSL 环境下体验最好）都能跑。第三，检查你的 ~/.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/ # 自动创建分支 ├──>