4.6 Superpowers 插件

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 步:实际使用

  1. 随便修改项目中的某个文件(加几行注释或改个变量名即可)
  2. 运行 git add . 暂存修改
  3. 在 Claude Code 中输入:
请用 git-commit Skill 帮我生成 commit message 并提交
  1. 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 中成功触发使用,恭喜完成第四部分!

© 版权声明
THE END
喜欢就支持一下吧
点赞13 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容