plugin-authoring 是 claude-plugins 仓库内的插件与技能编写流程技能,用于指导维护者完成技能或插件的新增、修改与删除,并避免残留悬空的元数据。它从 CLAUDE.md 中拆分而来,因为这些都是带有明确触发条件的操作流程,不需要在调试 hook 时常驻。
用途与范围:提供本仓库的编写程序,包括如何创建技能、如何创建插件、任一方变更时需要更新哪些文件,以及如何删除而不留下悬空元数据。详细模式仍保存在该技能引用的规则文件中,本技能负责的是执行顺序。
主要能力:
- 创建新技能:建立 <plugin>/skills/<skill-name> 目录,编写带 YAML frontmatter 的 skill.md(name、description、allowed-tools、created、modified、reviewed 等字段),遵循 Core Expertise → Commands → Patterns → Quick Reference 的内容结构,并包含 agentic 优化表。
- 技能粒度决策:操作相关且共享上下文时使用单一技能;工作流不同、用户意图不同时使用多个技能。
- 创建可调用技能:通过 /plugin:skill-name 语法调用,SKILL.md 可增加 args、argument-hint 字段,内容按 Context → Execution → Post-actions 组织。
- 插件生命周期:创建、修改或删除插件时,需要同步更新 plugin.json、README.md、marketplace.json、release-please-config.json、.release-please-manifest.json、docs/PLUGIN-MAP.md 和 .claude/settings.json 中的 enabledPlugins。docs/CATALOG.md 由 marketplace.json 和插件目录生成,不在手工更新清单中。
- 创建插件:建立目录结构,编写 .claude-plugin/plugin.json(包含 $schema、name、version、description、author.name、license、keywords),其中 license 与 author.name 为必填;编写 README;在 marketplace.json 的 plugins 数组中添加条目;配置 release-please 相关文件;在 settings.json 中启用该插件。
- 删除插件:移除插件目录、marketplace.json 条目、release-please 配置与版本清单条目,以及 settings.json 中的启用键。
使用方式:按技能描述的步骤顺序执行;开发流程包括调研文档、规划技能结构、编写技能、更新所有元数据文件、尽早提交、测试、创建 PR。插件新增或删除后,运行 bash scripts/check-docs-index.sh 与 bash scripts/plugin-compliance-check.sh 校验元数据一致性;文档计数漂移可用 /docs-refresh 修复。
适用场景:本仓库的插件与技能维护者进行新增、修改、删除操作时;以及需要理解插件元数据联动关系的开发场景。
限制与注意事项:该技能针对 laurigates/claude-plugins 仓库的特定结构与工具链;其中大量约定依赖仓库内的规则文件与脚本。Claude Code 2.1.157 中 .claude/skills 下的插件可自动加载,但本仓库发布的插件仍使用完整的 marketplace 与 release-please 生命周期。其余平台兼容性或收费信息暂未提供。