plugin-checker

plugin-checker 是为 Claude Code 开发扩展功能的开发者所设计的必要质量保证工具。它提供了一套结构化的审核方法，用于审查插件目录，验证其是否符合清单、目录结构和文件命名惯例等严格要求，以利于正确整合。通过自动检测常见错误（例如 plugin.json 中的无效 JSON 语法、组件文件位置错误，或是代理与技能中不符合规定的 frontmatter），该工具能显著减少故障排除时间，确保插件已达到发布标准。

• 验证 .claude-plugin/plugin.json 的 JSON 语法、名称字段合规性 (kebab-case) 以及所需的作者元数据。

• 审核目录配置，确保代理、技能、指令和钩子 (hooks) 皆依照市场规范放置。

• 对 .md 文件中的 YAML frontmatter 进行深度检查，确保 name、description 以及 model/color/tool 配置等必要字段存在且有效。

• 验证 hooks.json 结构，确保如 PreToolUse 和 SessionStart 等事件名称正确对应至可执行脚本。

• 强制执行路径可移植性，检查是否使用 ${CLAUDE_PLUGIN_ROOT} 并确保脚本具有正确的 shebang 标头。

• 检测常见的配置反模式，例如写死的绝对路径、遗失的说明文件需求以及不当的文件嵌套结构。

• 非常适合开发 Claude Code 生态系统的开发者与仓库维护者。

• 建议在提交插件或更新现有项目结构之前执行审核指令。

• 可轻松整合至 CI 流程中，自动验证插件清单的结构并进行 Lint 检查。

• 有助于排查常见错误，例如插件加载失败、触发条件丢失或钩子功能无预期运行。

• 提供清晰的报告格式，将发现的问题分类为严重问题与警告，利于快速修复结构缺陷。