AI 插件开发工具插件系统【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址https://gitcode.com/GitHub_Trending/cl/claude-plugins-official点击查看免费下载本文是围绕claude-plugins-official仓库根目录 README.md 展开的技术实战指南面向希望安装、使用乃至发布 Claude Code 插件的开发者。你将学会如何从官方市场一键安装插件、插件目录与标准结构长什么样、为什么插件name是不可变 slug 以及renames迁移机制如何工作、纯技能包skill-bundle插件如何通过strict: false直接声明技能以及内部插件与外部插件的提交流程与安全注意事项。一、仓库概览官方管理的 Claude Code 插件目录claude-plugins-official是一个由 Anthropic 官方维护的 Claude Code 插件精选目录curated directory核心定位是高质量插件的官方集合。它本身并不是某个单一插件而是一个插件市场marketplaceClaude Code 可以通过它发现、安装并更新插件。仓库根目录的 marketplace.json 是这份目录的注册表声明了市场元数据名称、描述、归属方以及全部可安装插件条目仓库根目录的 README.md 则定义了目录的组织方式、安装方式、贡献流程与插件结构规范。1.1 顶层结构/plugins 与 /external_plugins仓库按插件的来源分为两个顶层目录目录含义维护方/plugins内部插件Internal PluginsAnthropic 团队开发与维护/external_plugins外部插件External Plugins合作伙伴与社区第三方从仓库实际内容看内部插件覆盖了开发、安全、效率等多个方向例如 agent-sdk-devClaude Agent SDK 开发套件、claude-security代码漏洞扫描、code-review代码审查命令、hookify基于对话模式自动生成 hook 规则、plugin-dev插件开发全家桶agent / command / hook / skill 创建指南等外部插件则包括 Asana、GitHub、GitLab、Linear、Playwright、Terraform、Discord、Telegram、iMessage 等第三方集成例如 external_plugins/discord 就提供了一条带访问控制的 Discord 消息桥接通道。需要特别强调的是Anthropic 不控制第三方插件内包含的 MCP 服务器、文件或其他软件无法保证它们能按预期工作或不会发生变化。README 中的警告强调在安装、更新或使用任何插件之前务必确认你信任该插件并查看每个插件各自的 homepage 以获取更多信息。这一点对从外部插件目录安装的第三方集成尤其重要。二、安装从官方市场安装插件的两种方式Claude Code 拥有内建的插件系统可以直接从这个市场安装插件无需手动克隆仓库或复制文件。2.1 命令行安装推荐在 Claude Code 会话中运行/plugin命令并指定市场后缀claude-plugins-official/plugin install {plugin-name}claude-plugins-official其中{plugin-name}是市场条目中的插件 slug例如/plugin install claude-securityclaude-plugins-official /plugin install code-reviewclaude-plugins-official /plugin install playwrightclaude-plugins-officialclaude-plugins-official这一后缀对应仓库根目录 marketplace.json 中name字段声明的市场标识用于告诉 Claude Code 从哪个市场解析插件。2.2 图形化浏览安装也可以使用交互式界面发现插件/plugin Discover进入 Discover 面板后浏览市场中的插件列表找到目标插件后直接安装。2.3 安装后的首次配置部分插件安装后需要额外的一次性配置步骤才能启用完整功能。以外部插件 Asana 为例其市场条目描述明确写道Requires a one-time Asana OAuth app setup — run/asana-setupafter installing见 marketplace.json 中asana条目external_plugins/asana/commands/asana-setup.md 就是随插件分发的配置命令。安装这类插件后记得在会话中运行其自带的 setup 斜杠命令完成授权。三、插件标准结构一个插件由哪些部分组成README 给出了每个插件应遵循的标准目录结构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 # Documentation3.1 .claude-plugin/plugin.json唯一必需的元数据plugin.json是插件清单声明插件身份。仓库中 39 个插件都带有这一文件。以官方参考实现 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: supportanthropic.com } }其中name是插件在 Claude Code 中的注册标识description说明插件能力author记录作者信息。需要说明的是仓库中部分插件并未在目录中展开.mcp.json、commands/、agents/等目录例如hooks配置可能直接挂在插件根目录的hooks/hooks.json中见 plugins/security-guidance/hooks/hooks.json 中SessionStart、UserPromptSubmit、PostToolUse、Stop、SubagentStop等生命周期钩子这意味着标准结构描述的是通用推荐布局具体插件的组件目录可以按需增减。3.2 各类扩展组件的实际形态Slash commandscommands/与skills/name/SKILL.md斜杠命令由用户主动调用。官方参考实现同时保留了两种布局plugins/example-plugin/commands/example-command.md 是旧的commands/*.md布局plugins/example-plugin/skills/example-command/SKILL.md 是新布局两者加载行为完全一致仅文件布局不同。命令通过 YAML frontmatter 声明元数据支持description显示在/help中的说明、argument-hint参数提示、allowed-tools预授权的工具白名单可减少权限确认弹窗、model覆盖使用的模型等字段。Skillsskills/技能是模型根据任务上下文自主调用的能力与命令的用户主动调用形成对比。以 plugins/example-plugin/skills/example-skill/SKILL.md 为例其 frontmatter 支持name必填、description必填描述触发条件、version可选语义版本、license可选复杂技能还可以用references/、examples/、scripts/子目录承载参考资料、示例与辅助脚本。MCP Servers.mcp.json通过 Model Context Protocol 接入外部工具。README 中给出的最小配置为{ server-name: { type: http, url: https://mcp.example.com/api } }HooksREADME 的标准结构示例中未列出 hooks 目录但仓库中大量插件实际使用它来扩展 Claude Code 生命周期例如 plugins/security-guidance/hooks/hooks.json 定义了多类钩子SessionStart时通过bash ${CLAUDE_PLUGIN_ROOT}/hooks/sg-python.sh ...拉起 Python 脚本PostToolUse匹配Edit|Write|MultiEdit|NotebookEdit做编辑安全检查匹配Bash时用if条件如Bash(git commit:*)、Bash(git push:*)触发带asyncRewake的异步后台审查。这印证了 hooks 是插件系统中生命周期自动化的关键组件。3.3 参考实现example-plugin官方在 plugins/example-plugin/README.md 中提供了演示全部扩展选项的参考插件其实际目录为example-plugin/ ├── .claude-plugin/ │ └── plugin.json # Plugin metadata ├── .mcp.json # MCP server configuration ├── skills/ │ ├── example-skill/ │ │ └── SKILL.md # Model-invoked skill (contextual guidance) │ └── example-command/ │ └── SKILL.md # User-invoked skill (slash command) └── commands/ └── example-command.md # Legacy slash command format它同时展示了新式skills/name/SKILL.md与旧式commands/*.md命令布局并强调新插件应优先使用skills/目录格式。这也是内部插件开发见下文 Contributing的起点参考。四、插件名不可变name 是 immutable slug 及其迁移机制这是 README 中一个容易踩坑的硬性规则name字段是不可变 slugimmutable slug。插件一旦发布其name就不得更改——用户已经在该 slug 下安装了插件改名会导致他们的安装失效并报plugin-not-found错误。4.1 改名时的两条路径仅改显示名如果只是想调整插件在 UI 中的标签应设置或更新displayName字段而不是name。例如 marketplace.json 中airwallex-agentos条目就同时声明了name: airwallex-agentos与displayName: Airwallex展示名与 slug 分离。确实需要重命名如果改名实在无法避免必须在顶层renames映射中增加旧名到新名的条目让已安装用户自动迁移renames: { old-name: new-name }4.2 仓库中的实际迁移案例根目录 marketplace.json 第 9~19 行就是一份真实的renames映射renames: { adlc: agentforce-adlc, airwallex: airwallex-agentos, convex-backend: convex, vals: valtown, wordpress.com: build-with-wordpress, qodo-skills: qodo, atlassian-forge-skills: forge-skills, azure-skills: azure, sonarqube-agent-plugins: sonarqube }例如azure-skills已更名为azuremarketplace 中对应的azure条目 source 正是https://github.com/microsoft/azure-skills.gitqodo-skills更名为qodo。这组数据清晰展示了 slug 变更场景在真实市场中的普遍性。4.3 底层工作原理README 明确说明Claude Code 的插件加载器会读取这份renames映射并在用户下一次同步时透明地将旧 slug 重写为新 slug。也就是说已安装旧名的用户无需手动卸载重装加载器会自动完成迁移从而避免plugin-not-found错误。五、Skill-bundle 插件无 plugin.json 时的技能直接声明技能包skill-bundle是一种特殊形态的插件当插件的源仓库直接发布SKILL.md技能、却没有.claude-plugin/plugin.json清单时市场条目可以跳过清单用strict: false加显式skills数组直接声明技能。5.1 标准声明示例README 给出的完整配置如下{ 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 }字段含义name/description/author/category插件身份信息source声明技能来自哪个仓库子目录git-subdir表示从指定 Git 仓库的某个path拉取ref指向分支或 tagsha锁定提交strict: false关闭严格的插件清单校验允许不依赖plugin.jsonskills直接罗列要暴露的技能路径homepage插件的文档主页。5.2 路径规则与注册命名README 强调了两点关键规则skills中每个路径都相对于source.path指向一个包含SKILL.md的目录路径可以深入多层——例如[./libA/skill-1, ./libB/skill-2]可以从多个库子目录中挑选一个精选子集暴露出去。每个技能在 Claude Code 中注册为plugin-name:skill-name的形式。底层 schema 详见市场文档中的 Strict mode 说明README 引用自官方插件市场文档。5.3 仓库中的真实案例这一机制在根目录 marketplace.json 中被实际使用。例如amd-skills条目source为git-subdir指向https://github.com/amd/skills.git的skills路径并声明strict: false与skills: [./local-ai-use, ./local-ai-app-integration, ./serving-llms-on-instinct, ./tracelens-analysis-orchestrator, ./hyperloom-workload-optimizer]。同样box条目直接声明skills: [./skills/box, ./skills/box-legal-workflows, ...]。这些案例证明来源仓库只发布技能、不含插件清单时marketplace 可以完全通过skills数组完成能力暴露。六、贡献内部插件与外部插件的提交路径仓库对两类插件定义了不同的贡献流程。6.1 内部插件Internal Plugins内部插件由 Anthropic 团队成员开发以 plugins/example-plugin 为参考实现。新插件应遵循其结构与最佳实践plugin.json元数据、skills/优先的命令布局、以及按需的 MCP / hooks / agents 组件。6.2 外部插件External Plugins第三方合作伙伴可以通过插件目录提交表单申请将插件收录进市场。外部插件必须达到相应的质量与安全标准才能获得批准。提交前请对照 README 中的标准插件结构自检并特别注意第 3 节的安装后配置要求——如果插件需要 OAuth 或账号配置应随插件附上 setup 命令如 Asana 的/asana-setup。6.3 通用安全提醒无论内部还是外部插件README 开头的警告都适用于所有用户安装、更新或使用前请确认信任该插件。插件可能包含 MCP 服务器、文件或其他软件Anthropic 无法验证其行为也不会在其变化时承担责任每个插件的 LICENSE 以各自仓库内的 LICENSE 文件为准见 README.md 的 License 一节。七、实践清单与 FAQ安装插件命令行/plugin install {plugin-name}claude-plugins-official图形化/plugin Discover安装后检查插件 README 是否要求运行 setup 命令如/asana-setup判断插件目录类型内建插件/plugins目录第三方插件/external_plugins目录排查改名导致的安装失效若报plugin-not-found先确认是否涉及 slug 变更检查 marketplace.json 的顶层renames映射加载器会在下次同步时自动重写旧 slugQ为什么不能直接改插件name因为name是不可变 slug用户已按该 slug 安装改名会破坏既有安装并触发plugin-not-found。需要改显示名请用displayName必须改 slug 则用renames映射。Q没有plugin.json的仓库能进市场吗可以。采用 skill-bundle 形态在条目中设置strict: false并提供显式skills数组每个路径指向包含SKILL.md的目录相对source.path技能将以plugin-name:skill-name注册。Qskills路径能跨多个子目录吗可以。[./libA/skill-1, ./libB/skill-2]这类写法允许从多个库子目录中挑选技能子集。八、延伸阅读插件市场清单与真实renames案例.claude-plugin/marketplace.json官方参考插件含全部扩展组件演示plugins/example-plugin/README.md命令 frontmatter 字段详解plugins/example-plugin/commands/example-command.md技能结构与描述写法plugins/example-plugin/skills/example-skill/SKILL.mdHooks 生命周期配置实例plugins/security-guidance/hooks/hooks.json插件开发综合指南plugins/plugin-dev/README.md内部插件示例plugins/agent-sdk-dev/README.md、plugins/claude-security/README.md、plugins/hookify/README.md外部插件示例external_plugins/discord/README.md、external_plugins/asana/README.md如需深入了解 Claude Code 插件的开发细节可查阅官方插件开发文档README 末尾引用的链接。赞分享AI 插件开发工具插件系统【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址https://gitcode.com/GitHub_Trending/cl/claude-plugins-official点击查看免费下载相关推荐Claude Code 插件体系全解析官方插件、目录结构与实战部署指南Claude Code 插件体系全解析官方插件、目录结构与实战部署指南 本篇指南以 Claude Code 仓库中的 plugins/README.md htAI 应用AI 技能/插件开发工具Every-Marketplace终极Claude Code插件市场完全指南Every Marketplace终极Claude Code插件市场完全指南 Every Marketplace是官方Every Env插件市场专为C人工智能AI 技能AI 插件Taskmaster AI 的 Claude Code 插件市场安装、团队配置与源码结构详解Taskmaster AI 的 Claude Code 插件市场安装、团队配置与源码结构详解 本指南围绕 CLAUDE_CODE_PLUGIN.md httpAI Agent开发工具CLIMCP创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考