企业官网建设流程全解析

手把手：3 步把插件提交进 Claude 官方目录，让全球开发者搜到你

【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-plugins-official

Claude Code 插件系统发布以来，Anthropic 官方维护的插件目录claude-plugins-official就成了全球开发者发现插件的第一入口——它直接内置于 Claude Code 的/plugin面板，用户一条命令即可安装，无需配置任何市场地址。过去，第三方插件作者只能自建市场、自己拉流量；如今 Anthropic 开放了官方目录的提交门户，并在插件上线后提供页面浏览、搜索来源、分入口安装等数据。这意味着"写好插件"与"被搜到"从此是两件可以分别解决的事。本文以官方仓库源码与社区情报为据，拆解从账号准备、填表审核到数据优化的完整 3 步流程。

为什么"进官方目录"是插件的分水岭

先看这个仓库本身。根目录 README.md 把全部插件分成两块：

• /plugins：Anthropic 内部团队开发维护的官方插件；
• /external_plugins：来自合作伙伴与社区的第三方插件。

第三方作者的目标就是进入external_plugins/。进入前后的体验差异是决定性的：目录外的插件，用户得先claude plugin marketplace add注册你的市场再安装；而目录内的插件，用户直接在 Claude Code 里运行/plugin install {plugin-name}@claude-plugins-official，或在/plugin > Discover标签页里浏览即可。官方目录的"Discover"入口是随客户端自带的分发渠道，等于把你的插件摆在了每一位 Claude Code 用户的货架上。

值得注意的是，README 开头就有一句醒目的安全提示：Anthropic 不控制插件内含的 MCP 服务器、文件或其他软件，也无法验证它们是否会按预期工作、是否会被变更。这句提示恰恰说明了官方目录的定位——它不是内容担保，而是质量与安全标准的把关闸门，通过审批进入目录，本身就是对插件可信度的一次背书。

第一步：提交前的准备——账号与质量门槛

社区情报显示，官方提交入口面向付费 Claude 计划的开发者。所以在动手之前，先确认两件事：账号属于付费计划；插件本体已经打磨到位。后者才是审核真正的分水岭，可以从三个维度自查。

结构合规：manifest 是硬门槛

一个插件是否被 Claude Code 识别，取决于一个文件：位于插件根目录.claude-plugin/plugin.json的清单。官方参考实现 plugins/example-plugin/README.md 给出的标准结构是：

example-plugin/ ├── .claude-plugin/ │ └── plugin.json # 插件元数据（必需） ├── .mcp.json # MCP 服务器配置（可选） ├── skills/ # Skill 定义（可选） └── commands/ # 斜杠命令（可选，旧格式）

plugin.json里只有name是必填的，但想通过审核、让用户一眼看懂，就得把元数据写全。仓库的清单字段参考 plugins/plugin-dev/skills/plugin-structure/references/manifest-reference.md 给出了完整规范，其中三条最容易被提交者忽略：

• name是 kebab-case 不可变 slug：只允许小写字母、数字和连字符，且必须以字母开头、以字母或数字结尾。更关键的是，一旦上架，name就永远不能改——用户是按这个 slug 安装的，改名会让已安装用户报plugin-not-found。想改显示名，用displayName；确需迁移，才走.claude-plugin/marketplace.json的renames映射；
• description控制在 50–200 字符：这是用户在目录列表里看到的第一行字，要写"插件做什么"而不是"插件怎么做"，避免空泛表述；
• keywords填 5–10 个：功能类别、技术栈、工作流关键词都算，这是目录搜索命中率的直接来源。

参考官方插件 plugins/example-plugin/.claude-plugin/plugin.json，一个合格的清单长这样：

{ "name": "example-plugin", "description": "A comprehensive example plugin demonstrating all Claude Code extension options including commands, agents, skills, hooks, and MCP servers", "author": { "name": "Anthropic", "email": "support@anthropic.com" } }

用官方校验器自检

与其等审核打回，不如提交前先跑一遍自检。仓库里现成的工具就是 plugins/plugin-dev/agents/plugin-validator.md——一个专门的校验 agent，会按十步流程检查插件：定位.claude-plugin/plugin.json并校验name格式与语义化版本、用 Glob 核对commands/agents/skills/hooks/目录与自动发现、逐文件验证 frontmatter、检查 MCP 配置的stdio/sse/http/ws字段、最后做安全扫描（硬编码凭据、非 HTTPS 的 MCP 地址都是红线）。输出会按 critical/major/minor 分级并给出修复建议。提交前跑一次，能把大部分打回理由消灭在源头。

第二步：填表、审核、上架

结构合规之后，提交动作本身很简单：按根目录 README.md 的 Contributing 一节，外部插件通过官方插件目录提交表单（clau.de/plugin-directory-submission）发起申请，提交后进入 Anthropic 的审核流程，通过质量与安全标准的插件才会被合入external_plugins/。

审核环节有两点值得提前规划：

第一，审核看的是"能不能放心给所有人用"。官方目录的插件会被全球开发者安装到各种环境里，所以面向分发的插件要比个人工具苛刻得多。仓库的 plugins/plugin-dev/skills/command-development/references/marketplace-considerations.md 直接点出了分发设计的核心：

• 跨平台：命令里不要写死 macOS 专属的pbcopy之类命令，要按uname检测平台并优雅降级；
• 最小依赖：脚本开头先检查 git、jq、node 等必需工具，缺失就给出安装指引而不是直接报错；
• 幂等与原子性：重复执行不产生副作用，失败时能回滚，保证用户在不确定状态下的安全。

第二，名称不可变带来的连带要求。既然name上架后不能改，提交前就要把插件目录名、plugin.json的name、以及你打算对外宣传的名字三者统一，避免上架后才发现命名不理想而陷入迁移流程。renames机制虽然能自动迁移存量安装，但每多一次迁移，就多一分用户侧的出错概率。

参照已上架的第三方插件 external_plugins/asana/README.md 可以看到生态的成熟度——它已经包含完整的 OAuth 设置引导、迁移说明（V1 服务器下线时间都写清楚了）和专属安装命令。这种"开箱即用、文档完整"的插件，正是审核方期望看到的形态。

第三步：上线后如何看数据、持续优化

提交门户开放带来的一个重要变化，是把"用户没看到"和"看到了不想用"这两件事分开呈现给开发者。社区情报披露了官方目录的数据维度：插件上线后，开发者可以看到页面浏览、用户通过哪些搜索词找到它，以及不同产品入口和版本的安装情况。这相当于给了每个插件作者一份"曝光—转化"漏斗报表。

用好这份数据，需要做三件事：

一是盯搜索词，反向校准元数据。目录搜索命中的依据就是description和keywords。如果数据显示"用户通过 XX 关键词找到你但转化低"，说明描述与搜索意图有偏差；如果某类搜索词流量很大而你从未命中，就该在keywords里补上这些词。注意 keywords 不要重复插件名，也不要堆砌与功能无关的热词——目录审核对描述与能力的一致性是有要求的。

二是按入口拆解安装量。不同产品入口（CLI 安装 vs Discover 浏览）和不同版本的数据，能告诉你用户是从哪条路径认识你的插件的。如果 Discover 浏览多而安装少，问题大概率出在列表页的 description 不够有吸引力；如果某版本安装率骤降，就要排查该版本是否引入了破坏性变更。

三是持续迭代而非一劳永逸。仓库 plugins/plugin-dev/skills/plugin-structure/references/manifest-reference.md 的维护规范写得很明确：每次功能变更按语义化版本递增、同步更新keywords与description、维护 changelog、保持仓库链接有效。上架不是终点——目录里躺着大量插件，让用户不断回来更新你的插件，靠的是版本节奏和文档维护。

最后的检查清单

把全文压缩成一张提交前自查表：

1. 账号与资格：确认付费 Claude 计划账号；
2. 结构合规：.claude-plugin/plugin.json存在，name为 kebab-case 且确定不改，description精炼有力，keywords覆盖目标搜索词；
3. 自检通过：跑一遍 plugins/plugin-dev/agents/plugin-validator.md 的校验流程，无 critical 问题；
4. 分发就绪：跨平台、依赖可检测、错误可恢复，README 与 LICENSE 齐备；
5. 提交并等待审核：通过官方表单提交，等待质量与安全审批；
6. 上线后持续优化：跟踪页面浏览、搜索来源、分入口安装数据，迭代元数据与版本。

Claude 插件生态的分发格局刚刚被官方目录重塑：过去是"自建市场、自求多福"，现在是"一个入口、全球可见、数据可查"。把上述 3 步走完，你的插件就真正站上了面向全球开发者的货架。

【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-plugins-official