第2课：插件——扩展 Claude Code 的功能

为什么需要这个#

插件是打包在一个文件夹中的 Claude Code 扩展集合。就像智能手机上的应用程序扩展其功能一样，插件为 Claude Code 添加新命令、技能和自动检查。

插件允许：

📦 安装社区现成的解决方案
🔄 在不同项目中复用相同的工具
👥 与团队分享有用的配置
🎯 使用专业技能（代码审查、Git 操作、设计）

插件结构#

每个插件是一个具有以下结构的文件夹：

my-plugin/
├── .claude-plugin/
│   └── plugin.json        ← 清单（插件的"护照"）
├── commands/              ← 命令（slash 命令）
│   └── my-command.md
├── agents/                ← 代理（专业助手）
│   └── my-agent.md
├── skills/                ← 技能（知识库）
│   └── my-skill/
│       └── SKILL.md
├── hooks/                 ← 钩子（自动检查）
│   └── hooks.json
└── README.md              ← 文档

清单 — plugin.json#

这是插件的"护照"。最小版本：

{
  "name": "my-plugin"
}

推荐的完整信息版本：

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "这个插件做什么",
  "author": {
    "name": "您的名字",
    "email": "email@example.com"
  }
}

名称（name）规则：

仅小写字母、数字和连字符：code-review ✅
无空格和大写字母：Code Review ❌
以字母开头：1-plugin ❌

安装插件#

方式1：从市场#

# 在 Claude Code 中使用命令
/plugins install code-review

方式2：从本地文件夹（开发用）#

claude --plugin-dir ./path/to/my-plugin

方式3：从 Git 仓库#

克隆仓库并指定插件文件夹的路径。

官方插件概览#

🔍 code-review — 自动代码审查#

使用专业代理和置信度评分系统进行 pull request 审查。

{
  "name": "code-review",
  "description": "Automated code review for pull requests",
  "version": "1.0.0"
}

功能： 分析代码的错误、风格和安全性。

🪝 hookify — 通过 Markdown 创建钩子#

允许通过简单的 .local.md 文件创建钩子（自动检查），而不是编写脚本。

{
  "name": "hookify",
  "version": "0.1.0",
  "description": "Easily create hooks to prevent unwanted behaviors"
}

功能： 分析对话中的模式并配置钩子。包含命令 /hookify:hookify、/hookify:list、/hookify:configure。

📝 pr-review-toolkit — 综合 PR 分析#

5个以上专业代理的套件，用于深度 PR 分析：

code-reviewer — 通用代码审查
pr-test-analyzer — 测试分析
comment-analyzer — 注释分析
silent-failure-hunter — 静默错误搜索
code-simplifier — 代码简化
type-design-analyzer — 类型分析

📦 commit-commands — 简化 Git 操作#

三个便捷命令：

/commit-commands:commit — 创建提交
/commit-commands:commit-push-pr — 提交 + 推送 + 创建 PR
/commit-commands:clean_gone — 清理过时的分支

🎨 frontend-design — 界面设计#

用于创建高质量 UI/UX 实现的技能：

{
  "name": "frontend-design",
  "description": "Frontend design skill for UI/UX implementation"
}

🔒 security-guidance — 安全检查#

在编辑文件时自动提醒安全性的钩子。检查 Edit、Write、MultiEdit 操作。

🛠️ plugin-dev — 插件开发#

用于创建自定义插件的技能：结构、命令、钩子、技能。

📚 其他插件#

explanatory-output-style — 解释性回答风格
learning-output-style — 教学性回答风格
ralph-wiggum — 有趣的回答风格 😄
feature-dev — 功能开发
claude-opus-4-5-migration — 迁移到新模型

插件命令与普通命令的区别#

使用插件时，命令获得命名空间（namespace）：

无插件	有插件
`/review`	`/code-review:review`
`/commit`	`/commit-commands:commit`
`/hello`	`/my-plugin:hello`

这防止了两个插件有相同名称命令时的冲突。

分步指南：使用插件#

步骤1：下载插件#

# 克隆插件仓库
git clone https://github.com/anthropics/claude-code-plugins

步骤2：带插件启动 Claude Code#

claude --plugin-dir ./claude-code-plugins/plugins/code-review

步骤3：使用插件命令#

> /code-review:code-review

Claude Code 会对您的代码进行自动审查。

课程总结#

插件是包含清单 plugin.json 和一组组件的文件夹
插件组件：命令、代理、技能（skills）、钩子
插件名称必须使用 kebab-case 格式（小写字母和连字符）
插件命令具有命名空间：/plugin-name:command
有现成的插件用于代码审查、Git 操作、设计、安全
插件可从市场、本地文件夹或 Git 仓库安装