Superpowers 是 Claude Code 生态中的一类社区增强插件 / Skills 集合。它不是“必装”的,但思路值得学习:把成熟工作流封装成可复用能力,让 AI 不只是会写代码,还会按固定方法做事。
4.6.1 什么是 Superpowers?
Superpowers 本质是一套工作方法论集合,通常会封装成多个可复用 Skill。安装后,AI 可以在合适的任务中调用这些方法论。
安装前后对比:
| 没装 Superpowers | 装了 Superpowers |
|---|---|
| 你:“加个批量导出功能” | 你:“加个批量导出功能” |
| AI:“好的,我来实现…”(直接写代码) | AI:“在开始前我需要确认:1.导出格式?2.数据量多大?3.需要异步吗?”→给出 2-3 个方案,确认后再动手 |
4.6.2 核心 Skills 一览
| Skill | 功能 | 触发时机 |
|---|---|---|
| 头脑风暴 (brainstorming) | 需求分析→设计规格,先想清楚再动手 | 新需求/新功能开始时 |
| 编写计划 (writing-plans) | 把规格拆成可执行的实施步骤 | 确认设计后 |
| 执行计划 (executing-plans) | 按计划逐步实施,每步验证 | 开发过程中 |
| 测试驱动开发 (TDD) | 严格 TDD:先写测试,再写代码 | 开发核心逻辑时 |
| 系统化调试 (debugging) | 四阶段调试法:定位→分析→假设→修复 | 遇到 Bug 时 |
| 代码审查 (code-review) | 派遣审查 agent 检查代码质量 | 功能完成后 |
| 完成前验证 (verification) | 声称完成前必须跑验证 | 任务结束前 |
4.6.3 安装方法
方式一:npx 一键安装(推荐)
# 进入你的项目目录(重要!不要在主目录 ~ 下运行)
$ cd /your/project
# 英文版(原版)
$ npx superpowers
# 中文增强版(推荐国内用户,包含 6 个中国特色 Skill)
$ npx superpowers-zh
安装后会在项目下生成 .claude/skills/ 目录,包含所有 Skill 文件。
方式二:手动安装(备选)
# 克隆仓库
git clone https://github.com/jnMetaCode/superpowers-zh.git
# 复制 skills 到项目
cp -r superpowers-zh/skills /your/project/.claude/skills
注意:手动安装只复制了 Skills 文件,不会配置自动触发钩子。推荐使用 npx 方式一键安装。
4.6.4 是否必须安装?
不是必须的。 Superpowers 是一个“锦上添花”的增强插件:
- 初学者:建议先不装,熟悉 Claude Code 基本操作后再考虑
- 日常开发:强烈推荐安装,能显著提升代码质量和开发流程规范性
- 团队项目:强烈推荐安装,统一团队的 AI 工作方法论
~/.claude/
└── commands/ ← 你的全局 Skills
├── review.md ← 代码审查 Skill
├── refactor.md ← 重构优化 Skill
└── test.md ← 测试生成 Skill
项目根目录/
└── .claude/
├── commands/ ← 项目级 Skills
│ ├── deploy.md ← 部署流程 Skill
│ └── migrate.md ← 数据库迁移 Skill
├── settings.json ← 项目配置
└── CLAUDE.md ← 项目规则文件
图:Superpowers Skills 目录结构 —— 全局Skills对所有项目生效,项目级Skills仅对当前项目生效
4.7 MCP(Model Context Protocol)简介
MCP 是 Anthropic 推出的一个标准化协议,让 AI 工具可以连接外部服务和数据源。你可以把 MCP 理解为给 AI 装”插件”或”扩展能力”。
MCP 的概念:
AI 工具(Claude Code)
│
├── 内置能力:读写文件、运行命令
│
└── MCP 扩展能力:
├── GitHub MCP Server → 操作 GitHub(创建PR、管理Issue)
├── Database MCP Server → 直接查询数据库
├── Browser MCP Server → 浏览器自动化测试
└── 更多第三方 MCP Server...
MCP 与 Skill 的关系:
- Skill 定义了”做什么、怎么做”(流程和规范)
- MCP 提供了”能力扩展”(让AI能做更多事情)
两者互补:你可以在 Skill 中调用 MCP 提供的能力。例如,一个”部署检查 Skill”可以调用 GitHub MCP 来创建 PR。
提示:MCP 是一个进阶主题。初学者可以先专注于 Skill 的编写和使用,等熟练后再探索 MCP 扩展。
4.8 本部分小结与实践练习
实践练习:
- 使用
npx skills add anthropics/skills@skill-creator -g安装官方 skill-creator,体验用 AI 创建 Skill - 浏览 SkillsMP(skillsmp.com/zh)或 skills.sh,找到3个感兴趣的社区 Skill 并阅读其 SKILL.md
- 创建一个项目初始化 Skill(包含 SKILL.md + resources/template/ 技术栈配置模板)
- 创建一个代码审查 Skill(包含 SKILL.md + references/ 审查标准文档)
- 将自定义 Skill 集成到 Claude Code 中并实际使用一次
- 用 Git 提交你的 Skill 目录
4.8.1 动手实践:创建一个「Git 提交规范化」Skill
前面看了 4 个案例,现在轮到你自己动手了。下面会带你从零创建一个 Git 提交规范化 Skill,整个流程大约 10 分钟。
第 1 步:创建 Skill 目录
mkdir -p .claude/skills/git-commit
第 2 步:编写 SKILL.md
创建 .claude/skills/git-commit/SKILL.md,写入以下内容:
---
name: git-commit-standard
version: 1.0
description: 在提交代码时,自动生成符合 Conventional Commits 规范的 commit message
trigger: ["提交代码", "git commit", "生成commit"]
---
# Git 提交规范化
## 执行步骤
1. 运行 `git diff --staged` 查看暂存区的修改
2. 分析修改内容,判断变更类型:
- feat: 新功能
- fix: 修复Bug
- refactor: 重构(不改变功能)
- style: 样式修改
- docs: 文档更新
- test: 测试相关
- chore: 构建/工具变更
3. 生成 commit message,格式:`<type>(<scope>): <description>`
4. 显示给用户确认后执行 `git commit`
## 示例
修改了 `src/components/Header.tsx` 中的导航样式
生成的 message:
```
style(Header): 优化导航栏的响应式布局
```
第 3 步:在 CLAUDE.md 中注册 Skill
在项目根目录的 CLAUDE.md 文件中添加以下内容,让 Claude Code 知道这个 Skill 的存在:
## 项目 Skills
- `.claude/skills/git-commit/` — Git 提交规范化
执行相关任务时请先阅读对应 SKILL.md。
第 4 步:实际使用
- 随便修改项目中的某个文件(加几行注释或改个变量名即可)
- 运行
git add .暂存修改 - 在 Claude Code 中输入:
请用 git-commit Skill 帮我生成 commit message 并提交
- Claude Code 会自动读取你的 SKILL.md,分析
git diff --staged的内容,生成类似style(Header): 优化导航栏的响应式布局这样的规范化提交信息
验证:如果 Claude Code 自动读取了你的 Skill、分析了 git diff、并生成了符合 Conventional Commits 格式的 commit message,说明你的 Skill 创建成功!
第 5 步:用 Git 提交你的 Skill
git add .claude/skills/git-commit/
git commit -m "feat(skills): 新增 Git 提交规范化 Skill"
4.8.2 进阶挑战(选做)
完成基础练习后,试试这些挑战来巩固你的 Skill 创建能力:
- 修改 Git 提交 Skill,加入对中文 commit message 的支持
- 参考 5.3.2 节,为你当前的技术栈创建一个组件生成 Skill(React/Vue/任意框架)
- 参考 5.3.5 节,创建一个包含
references/的代码审查 Skill,加入你团队的编码规范
验证:如果你能独立创建一个 Skill 并在 Claude Code 中成功触发使用,恭喜完成第四部分!













请登录后查看评论内容