一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | plugin-dev | 合集仓库子目录名(见下方说明) |
| 所属合集仓库 | anthropics/claude-plugins-official(Anthropic 官方维护的 Claude Code 插件市场) | GitHub API |
| 作者/维护者 | Anthropic 官方(plugin.json 具名 support@anthropic.com) | plugin.json |
| 来源链接 | https://github.com/anthropics/claude-plugins-official/tree/main/plugins/plugin-dev | — |
| 许可证 | Apache License 2.0 | 插件目录内 LICENSE 文件(原文核对) |
| 所属合集仓库整体 Stars/Forks | 32,235 / 3,593(注:该数字属整个插件市场,不代表本插件自身热度,仅供了解所属市场规模) | GitHub API |
| 该插件自身活跃度 | plugins/plugin-dev 目录最近一次提交 2026-04-28,约 80 天前 | GitHub Commits API(路径限定查询) |
| 官方市场安装量 | 65,020 次安装,claude.com 插件页标记 Anthropic Verified | claude.com 官方插件详情页(实测抓取) |
| 最新版本 | plugin.json 未标注版本号字段 | plugin.json |
| 安装方式 | 见第十章 | 仓库根 README |
二、功能介绍与亮点
plugin-dev 是 Anthropic 官方出品的 Claude Code 插件开发工具包,把“如何做一个插件”这件事拆成七个可独立触发的专精技能:
- hook-development:PreToolUse / PostToolUse / Stop / SessionStart 等事件驱动自动化的写法与校验
- mcp-integration:MCP Server 接入配置(stdio / SSE / HTTP / WebSocket 及鉴权模式)
- plugin-structure:插件目录结构、组件自动发现、plugin.json 清单规范
- plugin-settings:基于
.claude/plugin-name.local.md的按项目状态配置 - command-development:斜杠命令的 YAML frontmatter 与参数定义
- agent-development:AI 辅助生成自主 agent、系统提示词设计
- skill-development:遵循渐进式披露原则的 skill 写法
亮点在于提供 /plugin-dev:create-plugin 一条命令的八阶段引导式工作流(需求梳理→组件规划→结构搭建→实现→校验测试→文档),并自带 6 个可运行的本地校验脚本(validate-hook-schema.sh、test-hook.sh、hook-linter.sh 等)与 12+ 个可直接参考的工作示例,核心文档总量约 2.1 万字。
三、适用场景
固定分类:元技能与 Agent 增强
适用于已经在用 Claude Code、想把团队内部的自动化习惯(自定义斜杠命令、hooks、专用 agent、MCP 数据源接入)打包成一个可分发插件的开发者与团队;也适合刚接触 Claude Code 插件体系、需要一份权威参考来理解 commands/hooks/agents/skills/MCP 这几类组件该如何组织的初中级用户。若只是想创建单个独立 skill 而不涉及插件封装,需求更窄,可参考第七章的同类对比。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方 claude-plugins-official 市场一条命令安装,插件结构(.claude-plugin/commands/agents/skills)是 Claude Code 插件系统专属实现 |
| Codex | 不支持 | 该工具包指导的对象是 Claude Code 特有的插件/Hooks/MCP 集成机制,未见 Codex 兼容说明 |
| OpenClaw | 未验证 | 已抓取材料未提及,未为此单独搜索 |
| Hermes Agent | 未验证 | 已抓取材料未提及,未为此单独搜索 |
五、推荐理由
Anthropic 官方出品、claude.com 实测 6.5 万次安装并获 Anthropic Verified 认证,用一条命令加七个专精技能覆盖“从零做一个 Claude Code 插件”的完整流程(hooks、命令、agent、MCP 集成、skill 写法一次讲清),对刚接触插件开发的用户尤其友好。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 官方 Anthropic Verified 插件,claude.com 实测 65,020 次安装;但面向“插件开发者”这一相对较窄的受众群体,量级低于面向全体用户的同市场插件 |
| 可用性 | 9 | 插件市场一条命令安装;约 2.1 万字文档 + 8 阶段引导工作流 + 6 个校验脚本 + 12+ 可运行示例,自成体系无需外部付费依赖;该子目录最近提交约 80 天前 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.7 | 三项均值 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行及权限范围 | 仅含本地校验/检查脚本(如 hook-linter.sh),用于校验用户自己编写的插件配置是否合规,范围明确 |
| ② 运行时联网外发数据 | 纯本地文档指导与本地脚本校验,未见任何外联行为 |
| ③ API Key/凭据要求及存储方式 | 不需要任何 API Key 或凭据;mcp-integration 技能中涉及的鉴权配置是教用户如何为自己的 MCP Server 设置,非本插件自身索取凭据 |
| ④ 可疑指令/Prompt Injection 迹象 | 已抓取 README 与目录结构逐项核对,内容聚焦插件开发指导本职,未发现试图操纵执行额外操作或外发数据的文字 |
| ⑤ 作者/组织信誉 | Anthropic 官方仓库,plugin.json 具名 support@anthropic.com,claude.com 标记 Verified |
| ⑥ License 是否明确 | Apache License 2.0,明确(已核对插件目录内 LICENSE 原文) |
| ⑦ 最近维护时间 | 该子目录最近提交约 80 天前;所属仓库整体近日仍有提交,未见废弃迹象 |
七、跟同类 Skills 相比的优势
| 技能 | 核心定位 | 覆盖范围 | 维护方 |
|---|---|---|---|
| plugin-dev(本推荐) | 从零搭建一个完整 Claude Code 插件 | Hooks、斜杠命令、Agent、MCP 集成、Skill 写法五类组件一次覆盖,含引导式工作流 | Anthropic 官方 |
| skill-creator(同仓库上游 anthropics/skills) | 只聚焦创建单个 skill 本身 | 仅 skill 写法与打包,不涉及 hooks/commands/agent/MCP | Anthropic 官方 |
| mcp-builder(同仓库上游 anthropics/skills) | 只聚焦构建 MCP Server 本身 | 深入 MCP 协议实现细节,不涉及把它封装进可分发插件的流程 | Anthropic 官方 |
差异化核心:skill-creator 和 mcp-builder 各自专精“单一组件”的实现细节,而 plugin-dev 站在更高一层,指导如何把多种组件(可能包含用到 skill-creator、mcp-builder 产出的成果)组织、配置、校验并最终打包成一个可在市场分发的完整插件——三者互补而非重叠,团队若只需做单一 skill 或单一 MCP Server,前两者更轻量;若目标是发布一个成体系的插件,plugin-dev 提供了从规划到校验的完整脚手架。
八、用户评价
- Tom Ashworth(独立技术博主,tgvashworth.substack.com,2025-12-01 发文):将 plugin-dev 称为“大部头”(7 个专精技能、AI 辅助生成、8 阶段工作流),认为其多阶段工作流“每个阶段都有明确产出和决策点”、能防止用户在关键步骤上仓促带过;文章还评价了其技能描述采用第三人称写法(“这个技能应该在…使用”而非直接祈使句)有助于技能选择系统更准确地判断何时推荐该技能,以及用具体数字(如系统提示词 500–3000 字)替代模糊指导的做法,整体将该工具包视为“理解 Anthropic 工程师如何搭建 agentic 工作流”的有价值参考。
除此之外未见其他已验证的具名用户评价。
九、安装使用方式
Claude Code 插件市场(唯一官方渠道)
/plugin marketplace add anthropics/claude-plugins-official
/plugin install plugin-dev@claude-plugins-official
或在 Claude Code 内运行 /plugin,进入 Discover 浏览搜索 “plugin-dev” 后选择安装。
安装后注意事项:
- 安装即生效,无需重启 Claude Code
- 七个子技能会根据对话中的触发短语自动加载(如问“如何配置一个带认证的 stdio MCP Server”会自动带出 mcp-integration 技能)
- 若需要从零搭建一个新插件,可直接运行
/plugin-dev:create-plugin走完整八阶段引导流程
十、注意事项
- 目标用户是“要开发/发布 Claude Code 插件”的人;如果只是想做一个独立 skill 而不打包 hooks/commands/agent/MCP,第七章列出的 skill-creator 需求匹配度更高、更轻量
- 该子目录本身约 80 天未见新提交,处于稳定期而非高频迭代,但不影响当前功能可用性
- 对 Codex 不支持,对 OpenClaw、Hermes Agent 未验证,多 Agent 团队若需统一工具链需自行确认
- 有效使用需要开发者对 Claude Code 插件体系(commands/hooks/agents/skills/MCP)有基本概念,完全新手可能有一定学习曲线,建议先跟着引导工作流走一遍最小示例