plugin-dev (插件开发)
Anthropic 官方元技能:用 7 个子技能系统教学 Claude Code 插件的完整开发流程——目录结构、slash 命令、subagent、hooks、MCP 集成与配置存储,每模块都配可执行验证脚本和渐进式披露的参考资料。
仓库:anthropics/claude-plugins-official
热度证据:官方插件目录 33,473 star,Anthropic 官方维护的高质量插件之一
五维评分
热度5/5
质量5/5
创新4/5
易用4/5
文档5/5
优秀点拆解
- 元技能自举:用 skill 教人开发 skill 生态,skill-development 直接引用自身子技能(1,651 词 SKILL.md、触发词原文)作最佳实践模板,内容与载体互为验证
- 规范代码化:validate-agent.sh / validate-hook-schema.sh 等脚本把文档里的每条规则(命名格式、字段枚举、timeout 范围、硬编码路径)变成机器可执行检查,✅/⚠️/❌ + 退出码输出可直接接 CI
- 触发描述工程化:定义 'Use this agent when... Typical triggers include... See When to invoke' 固定句式模板 + 双通道(frontmatter 平铺 + 正文场景区),并给出可喂给 Claude 的 AI 生成 prompt(输出三字段 JSON),解决 agent 从不被触发的通病
- 渐进式披露 + 字数预算:三级加载模型(metadata ~100 词 / SKILL.md 1,500-2,000 词 / references 按需),用数字约束管理上下文窗口,深水区内容不进常驻上下文
- 可移植性与安全默认值:${CLAUDE_PLUGIN_ROOT} 贯穿所有配置、禁止硬编码路径(validator 会检出);least privilege 工具白名单、路径穿越校验、token 只走环境变量、hook JSON 输出协议规范化
可复用的设计模式
- 元技能/自举模式:教人开发某平台生态的技能,让内容与载体互为验证
- 规范文档 + 验证脚本双写:每条规则同步固化为零依赖 shell 校验器(jq/sed/grep),交付前跑脚本替代人工 review
- 渐进式披露 + 字数预算:SKILL.md 限 1,500-2,000 词,细节拆 references/,可执行代码放 scripts/(不占上下文),示例放 examples/
- 触发词三要素模板:条件 + 2-4 个场景名词短语 + 指向正文场景区的指针,proactive/reactive 双覆盖,可复制到任何需自动触发的 agent/命令
- 测试输入生成器:test-hook.sh --create-sample 按事件类型生成标准 JSON 样例喂给被测脚本,把造测试数据变成一条命令
适用场景
从零创建并发布 Claude Code 插件(含 marketplace 分发)为团队沉淀内部 slash 命令、subagent、代码校验 hooks 与 MCP 集成作为规范 checklist:交付前用 scripts/ 验证器检查插件文件结构与配置AI-assisted 批量生成 agent:用 agent-creation-system-prompt.md 的完整 prompt 产出标准 agent 配置学习如何写出触发可靠、不烧上下文的 skill 方法论(不限于插件场景)
边界与注意:纯教学/规范型技能,不含现成插件业务代码;强绑定 Claude Code 平台(hooks 协议、CLAUDE_PLUGIN_ROOT 等换平台失效);hooks 与 settings 变更需重启才生效;体量大(7 模块约 4-5 万字)且部分内容有版本滞后痕迹(legacy 标注、in progress 章节)。
完整拆解分析文档
本页为摘要版,完整精读分析(核心机制、逐条优秀点拆解、写作过程)见本地 Markdown 文档:
analysis/cpo-plugin-dev.md