1 概念辨析

Claude Code 的扩展体系由三层组成：Marketplaces（市场）→ Plugins（插件）→ Skills / Agents / Hooks / Commands（具体扩展）。

1.1 Marketplace（插件市场）

插件市场是插件的注册表 / 索引，告诉 Claude Code 有哪些插件可用以及从哪里下载。类比：npm registry、VS Code Marketplace。

官方市场：claude-plugins-official（预配置，无需手动添加）
社区市场：GitHub 仓库，需手动添加
一个市场就是一个 GitHub 仓库，根目录包含 .claude-plugin/marketplace.json 文件

1.2 Plugin（插件）

插件是可分享的扩展包，是市场中的最小分发单元。一个插件可以打包以下四种扩展类型：

|----------------------|-------------------------|------------------------------------|
| 扩展类型 | 说明 | 示例 |
| Skills（技能） | 专业化的 AI 子代理，具备特定领域知识和工具 | feature-dev：7 阶段特性开发流程 |
| Hooks（钩子） | 在工具调用前后自动触发的规则 | security-guidance：实时检测 SQL 注入等安全问题 |
| Slash Commands（斜杠命令） | 用户手动调用的快捷命令 | /commit、/review-pr |
| MCP Servers | 连接外部工具的协议服务器 | Jira、Confluence、数据库等 |

一个插件可以只包含其中一种，也可以组合多种。

1.3 Skills（技能）------ 两种含义

"Skill" 一词在 Claude Code 生态中有两种不同的含义，这是最容易混淆的地方：

含义 A：独立技能文件（SKILL.md）

存放在 .claude/skills/ 或 ~/.claude/skills/ 目录下的 markdown 工作流定义。

每个技能自动成为一个斜杠命令（如 /deploy）
可以被 Claude 根据上下文自动调用
本质上是"给 Claude 的提示词模板 + 辅助资源"
纯文件级别，不需要插件系统

.claude/skills/
deploy/
SKILL.md # 入口文件（必需）
checklist.md # 辅助文档
scripts/validate.sh

含义 B：插件内的子代理技能

插件中打包的专业化 AI 代理，具备独立的工具权限、领域知识和行为指令。

由插件系统管理（安装 / 卸载 / 更新）
可以有自己的 system prompt、allowed tools、model 配置
通常比 SKILL.md 更强大，可以有独立的执行上下文

简单区分：SKILL.md 是 "手写的提示词文件"，插件技能是 "打包的专业代理"。

2 三者的关系与架构

核心关系：

Marketplace 是商店，Plugin 是商品，Skills / Agents / Hooks / Commands 是商品里的功能
独立 Skills (SKILL.md) 是手写笔记，可以直接用，不需要商店和商品
插件里的 Skills 和独立的 SKILL.md 功能类似但管理方式不同：前者通过 /plugin 命令管理，后者通过文件系统管理

架构层级：

Marketplace (插件市场)
└── Plugin (插件包)
├── Skills (技能/子代理)
├── Agents (子代理)
├── Hooks (钩子)
├── Slash Commands (斜杠命令)
└── MCP Servers (MCP 服务器)

≠ (不同于)

独立 Skills (SKILL.md)
纯文件形式，不依赖插件系统
.claude/skills/ ~/.claude/skills/
deploy/SKILL.md pr-review/
test/SKILL.md format/

3 官方插件市场详情

3.1 基本信息

仓库地址：github.com/anthropics/claude-plugins-official
预配置：Claude Code v1.0.33+ 自动包含，无需手动添加
管理命令：在 Claude Code 中输入 /plugin

3.2 官方维护插件（13 个以上）

主要描述13个插件

开发类（6 个）

|---------------------------|----------------------------------|
| 插件名 | 功能描述 |
| agent-sdk-dev | Claude Agent SDK 开发工具包 |
| claude-opus-4-5-migration | 自动化从 Claude 4.0/4.1 迁移到 Opus 4.5 |
| feature-dev | 7 阶段特性开发流程（探索→架构→实现→审查） |
| frontend-design | 生产级前端生成，注重设计美学 |
| plugin-dev | 插件开发工具包，含 7 个专业技能 |
| ralph-wiggum | 自引用 AI 循环，用于迭代任务执行 |

生产力类（4 个）

|-------------------|---------------------------|
| 插件名 | 功能描述 |
| code-review | 自动化 PR 审查，含置信度评分 |
| commit-commands | Git 提交/推送/PR 创建命令 |
| hookify | 通过 markdown 规则创建自定义 hooks |
| pr-review-toolkit | 专项审查代理（测试、质量、简化） |

学习类（2 个）

|--------------------------|--------------|
| 插件名 | 功能描述 |
| explanatory-output-style | 教育性输出，解释实现选择 |
| learning-output-style | 交互式学习模式 |

安全类（1 个）

|-------------------|---------------------------------|
| 插件名 | 功能描述 |
| security-guidance | 实时 PreToolUse 钩子，检测注入/XSS/不安全模式 |

3.3 外部 / 合作伙伴插件（60+ 个）

涵盖 AWS（7 个插件）、Azure、GCP、Auth0、Atlassian（Jira/Confluence）、Asana、Adobe、Apollo、Sentry、Vercel、Supabase、Figma、Playwright、Notion、GitHub、GitLab、Pinecone、42Crunch 等。

完整列表见：https://github.com/anthropics/claude-plugins-official

3.4 官方 Anthropic 市场操作

3.4.1查看官方 Anthropic 市场

在终端执行：

/plugin marketplace list

如果看到：

claude-plugins-official

说明官方市场已经注册成功。

3.4.2 安装官方 Anthropic 市场

如果官方市场不存在

手动添加：

/plugin marketplace add anthropics/claude-plugins-official

然后更新：

/plugin marketplace update claude-plugins-official

3.4.3浏览官方插件

/plugin

进入 Discover 页面浏览

3.4.4 安装插件

/plugin install 插件名@claude-plugins-official

3.4.5查看已安装插件

/plugin list

3.4.6 卸载插件

/plugin uninstall 插件名

3.5 anthropic-agent-skills

通过在 Claude Code 中运行以下命令，将此存储库注册为 Claude Code 插件市场：

/plugin marketplace add anthropics/skills

然后，要培养一套特定的技能：

选择Browse and install plugins

选择anthropic-agent-skills

选择document-skills或example-skills

选择Install now

或者，您也可以直接通过以下方式安装插件：

/plugin install document-skills@anthropic-agent-skills

/plugin install example-skills@anthropic-agent-skills

Skills vs Plugins 的层级关系：一个 Plugin（插件）是容器，可以包含多个 Skills（技能）以及其他组件（commands、agents、hooks、MCP servers）。anthropic-agent-skills 的 marketplace.json 本身定义了 3 个 plugin，每个 plugin 内部打包了多个 skill 文件夹。

安装路径反映本质差异：anthropic-agent-skills 里的每个 skill 文件夹本质上还在你的本地文件系统中作为 marketplace 缓存存在；而 claude-plugins-official 里的很多插件会带 MCP 服务器（如 42Crunch、Airtable），安装后会启动外部进程，这涉及安全考量。

连接点：两个 marketplace 有少量重叠 --- 例如 frontend-design 和 skill-creator 在两个 marketplace 中都有出现。在 claude-plugins-official 里它们是完整插件（可能有配套的 commands/agents），在 anthropic-agent-skills 里它们是纯技能指令。

4 社区插件市场

4.1 主要社区市场

|-----------------------|-------------------------------------------------------------|------------------------------|------------------------------------------|
| 市场名称 | 安装命令 | 规模 | 特色 |
| Claude Night Market | /plugin marketplace add athola/claude-night-market | 23 插件, 186 技能, 128 命令, 54 代理 | Git 工作流、代码审查、TDD 强制、ONNX ML、Computer Use |
| cc-thingz | /plugin marketplace add alexei-led/cc-thingz | 32 技能, 34 代理, 9 钩子 | 6+ 月实战检验，跨平台导出 |
| cc-skills | /plugin marketplace add terrylica/cc-skills | 19 插件 | ADR 驱动开发、DevOps、量化研究、MQL5 交易 |
| Netresearch | /plugin marketplace add netresearch/claude-code-marketplace | 30+ 技能 | 企业级，TYPO3、PHP 现代化、安全审计 |
| Claude Code Skills | /plugin marketplace add levnikolaevich/claude-code-skills | 7 插件 | 敏捷全生命周期、代码库审计、项目脚手架 |
| Agents Skills Plugins | /plugin marketplace add EricGrill/agents-skills-plugins | 聚合多作者 | AI/LLM、DevOps、区块链、SEO |
| Dev-GOM | /plugin marketplace add Dev-GOM/claude-code-marketplace | 15 插件 | Git 备份、TODO 收集、Unity/Blender 工具 |
| sgaunet | /plugin marketplace add sgaunet/claude-plugins | DevOps + Go | DevOps、软件工程、Go 专家 |

4.2 社区插件市场的常规操作

4.2.1 查看已添加市场

/plugin marketplace list

4.2.2 添加插件市场

在线安装格式：

/plugin marketplace add owner/repo

例如：

添加官方市场：

/plugin marketplace add anthropics/claude-plugins-official

添加 Night Market：

/plugin marketplace add athola/claude-night-market

4.2.3 删除市场

/plugin marketplace remove 市场名

例如：

/plugin marketplace remove claude-night-market

4.2.4 安装插件

格式：

/plugin install 插件名@市场名

例如：

/plugin install github@claude-plugins-official

4.2 npm 分发的插件

部分插件通过 npm 分发，使用方式不同：

npx @biggora/claude-plugins search

npx @hopla/claude-setup

5 独立 Skills（SKILL.md 方式）

5.1 目录结构

Skills 是存放在 .claude/skills/ 目录下的 markdown 文件，是不依赖插件系统的轻量级扩展方式。

.claude/skills/ --- 项目级（通过 Git 共享）
~/.claude/skills/ --- 用户级（所有项目可用）

5.2 SKILL.md 格式

每个技能目录内必须有一个 SKILL.md 作为入口文件，格式如下：

name: deploy
description: 部署应用到生产环境。当用户提到部署、上线、发布时使用。
disable-model-invocation: false
allowed-tools: Bash(git *), Read, Write

部署流程

步骤 1：检查分支

...

步骤 2：运行测试

...

Frontmatter 说明：

name：技能名称，自动成为斜杠命令（/deploy）
description：描述信息，Claude 据此判断是否自动调用该技能
disable-model-invocation：设为 true 则禁止自动调用，只能手动触发
allowed-tools：限制该技能可以使用的工具，格式为 Bash(git *), Read, Write

5.3 Skills vs Commands 对比

|--------|--------------------------|-------------------|
| 维度 | Skills | Commands |
| 存放位置 | .claude/skills/ | .claude/commands/ |
| 结构 | 文件夹 + SKILL.md + 辅助文件 | 单个 .md 文件 |
| 调用方式 | 自动（上下文感知）或手动 /skill-name | 仅手动 /command-name |
| 推荐度 | ✅ 推荐（新方式） | ⚠️ 遗留格式 |
| 适用场景 | 复杂多步骤工作流 | 简单单一任务 |

5.4 内置命令

Claude Code 自带以下内置斜杠命令：

|----------|--------------|
| 命令 | 功能 |
| /clear | 清空对话历史 |
| /compact | 压缩对话 |
| /config | 打开设置 |
| /cost | 显示 token 用量 |
| /model | 选择 AI 模型 |
| /memory | 编辑 CLAUDE.md |
| /agents | 管理子代理 |
| /mcp | 管理 MCP 服务器 |

6 安装与使用指南

6.1 插件市场操作

在 Claude Code 对话中执行以下命令：

/plugin # 打开交互式插件管理器（推荐）

/plugin list # 查看可用插件列表

/plugin marketplace add <github-user>/<repo-name> # 添加社区市场

/plugin marketplace add athola/claude-night-market # 示例：添加 Claude Night Market

6.2 插件安装

/plugin install code-review@claude-plugins-official # 从官方市场安装

/plugin install code-review # 简写（官方市场）

/plugin install sanctum@claude-night-market # 从社区市场安装

/plugin uninstall <plugin-name>@<marketplace-name> # 卸载

6.3 本地插件开发与测试

git clone https://github.com/author/my-plugin .claude/plugins/my-plugin

claude --plugin-dir .claude/plugins/my-plugin # 启动时加载

claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two # 加载多个

6.4 团队自动安装配置

在项目 .claude/settings.json 中添加：

{
"extraKnownMarketplaces": {
"team-tools": {
"source": {
"source": "github",
"repo": "your-org/claude-plugins"
}
}
}
}

团队成员打开项目后，Claude Code 会自动识别该市场。

6.5 创建独立 Skill

mkdir -p .claude/skills/my-workflow

touch .claude/skills/my-workflow/SKILL.md

编辑 SKILL.md，添加 frontmatter 和指令。保存后即可在 Claude Code 中使用 /my-workflow 调用。

6.6 使用已安装的插件

斜杠命令使用命名空间格式：/plugin-name:command
技能（Skills）根据上下文自动激活
MCP 服务器和 Hooks 在后台自动运行
输入 /help 查看所有可用命令

完整工作流示例：

1. 输入 /plugin marketplace add athola/claude-night-market（添加社区市场）
1. 输入 /plugin install sanctum@claude-night-market（安装 sanctum 插件）
1. 输入 /sanctum:commit（使用插件命令生成 commit）
1. 插件中的 git-workflow 技能在 Git 操作时自动激活（上下文自动调用）

7 对比总结表

|--------|-------------------------|---------------------------------|-------------------------|
| 维度 | Marketplace | Plugin | Skill (独立 SKILL.md) |
| 是什么 | 插件注册表/索引 | 可安装的扩展包 | 提示词工作流文件 |
| 安装方式 | /plugin marketplace add | /plugin install | 手动创建文件 |
| 管理方式 | 远程 GitHub 仓库 | Claude Code 插件系统 | 文件系统 + Git |
| 包含内容 | 多个插件的索引 | Skills + Hooks + Commands + MCP | 纯 Markdown 指令 |
| 分发方式 | GitHub 仓库 | 通过市场分发 | Git 仓库 / 复制粘贴 |
| 是否必需 | 安装插件的前提 | 批量获取扩展的方式 | 可直接使用 |
| 跨平台 | Claude Code 专属 | Claude Code 专属 | 可导出到 Codex/Gemini CLI |

一句话总结：

Marketplace 是「应用商店」→ Plugin 是「App」→ 插件内的 Skills/Agents/Hooks/Commands 是「App 的功能模块」
独立 SKILL.md 是「记事本便签」→ 不经过商店，直接手写即用，与插件体系是并列关系而非从属关系

8 推荐入门路径

Step 1：熟悉内置功能

输入 /plugin、/agents、/mcp 探索内置命令，了解 Claude Code 能做什么

Step 2：创建独立 Skill

在 .claude/skills/ 下写一两个 SKILL.md，体验提示词工作流定制

Step 3：安装官方插件

/plugin install code-review 和 /plugin install commit-commands，体验插件能力

Step 4：探索社区市场

添加 Claude Night Market 等社区市场，按需安装感兴趣的功能插件

Step 5：自定义插件

将自己的 Skills/Commands/Hooks 打包成插件，通过 Git 分享给团队

附录：参考资源

官方插件市场：https://github.com/anthropics/claude-plugins-official
Claude Code 官方文档：https://docs.anthropic.com/en/docs/claude-code
Claude Night Market：https://github.com/athola/claude-night-market
cc-thingz：https://github.com/alexei-led/cc-thingz
Claude Code Extensions Guide：https://www.morphllm.com/claude-code-extensions

Claude Code 扩展体系Marketplaces · Plugins · Skills 概念、关系与实战