<!-- WEHUB_ZH_README -->
> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。  
> [English](./README.en.md) · [原始项目](https://github.com/anthropics/claude-plugins-official) · [上游 README](https://github.com/anthropics/claude-plugins-official/blob/HEAD/README.md)  
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

# Claude Code 插件目录

精心整理的 Claude Code 高质量插件目录。

> **⚠️ 重要提示：** 在安装、更新或使用插件之前，请务必确认你信任该插件。Anthropic 不控制插件中包含哪些 MCP 服务器、文件或其他软件，也无法验证它们能否按预期工作，或不会发生变化。请参阅各插件的主页了解更多信息。

## 结构

- **`/plugins`** - 由 Anthropic 开发和维护的内部插件
- **`/external_plugins`** - 来自合作伙伴与社区的第三方插件

## 安装

可通过 Claude Code 的插件系统直接从此市场安装插件。

要安装，请运行 `/plugin install {plugin-name}@claude-plugins-official`

或在 `/plugin > Discover` 中浏览查找插件

## 贡献

### 内部插件

内部插件由 Anthropic 团队成员开发。参考实现请参阅 `/plugins/example-plugin`。

### 外部插件

第三方合作伙伴可提交插件以供纳入市场。外部插件须满足质量和安全标准方可获批。要提交新插件，请使用[插件目录提交表单](https://clau.de/plugin-directory-submission).

## 插件结构

每个插件均遵循标准结构：

```
plugin-name/
├── .claude-plugin/
│   └── plugin.json      # Plugin metadata (required)
├── .mcp.json            # MCP server configuration (optional)
├── commands/            # Slash commands (optional)
├── agents/              # Agent definitions (optional)
├── skills/              # Skill definitions (optional)
└── README.md            # Documentation
```

## 插件名称不可变

市场条目中的 `name` 字段是一个**不可变的 slug**。插件一旦发布，其 `name` 不得更改——用户是按该 slug 安装的，重命名会导致安装失败并出现 `plugin-not-found` 错误。

- 若要更改插件在 UI 中的显示名称，请改为设置或更新 `displayName`。
- 若确实无法避免重命名，请在 `.claude-plugin/marketplace.json` 的顶层 `renames` 映射中添加一项，以便现有安装自动迁移：

```json
"renames": {
  "old-name": "new-name"
}
```

Claude Code 插件加载器会读取此映射，并在用户下次同步时透明地将旧 slug 重写为新 slug。

## Skill-bundle 插件

当插件的源仓库随附 skills（`SKILL.md` 文件）但没有 `.claude-plugin/plugin.json` 清单时，市场条目可使用 `strict: false` 和显式的 `skills` 数组直接声明这些 skills。

```json
{
  "name": "example-bundle",
  "description": "Brief description of the bundled skills.",
  "author": { "name": "Author Name" },
  "category": "development",
  "source": {
    "source": "git-subdir",
    "url": "https://github.com/example-org/sdk.git",
    "path": "packages/agent-skills",
    "ref": "main",
    "sha": "<commit sha>"
  },
  "strict": false,
  "skills": [
    "./skill-a",
    "./skill-b",
    "./skill-c"
  ],
  "homepage": "https://github.com/example-org/sdk"
}
```

`skills` 中的每个路径均相对于 `source.path`，并指向包含 `SKILL.md` 的目录。路径可深入多个层级——例如，`["./libA/skill-1", "./libB/skill-2"]` 会在多个库子目录中暴露精心筛选的子集。每个 skill 在 Claude Code 中注册为 `<plugin-name>:<skill-name>`。

有关底层 schema，请参阅市场文档中的 [Strict mode](https://code.claude.com/docs/en/plugin-marketplaces) in the marketplace documentation.

## 许可证

请参阅各链接插件中的相应 LICENSE 文件。

## 文档

有关开发 Claude Code 插件的更多信息，请参阅[官方文档](https://code.claude.com/docs/en/plugins).