mcpField
V
validate-plugin

validate-plugin

github.com/ruvnet测试与质量80.0k741 次安装今天更新
代码仓库

关于 validate-plugin

用于检查 Claude Code 插件是否符合预期结构和元数据格式的验证技能，涵盖清单、技能与 Agent 的 frontmatter、文件位置及 MCP 工具引用，并提供修复建议。

主要功能

  1. 01检查插件目录结构
  2. 02验证 plugin.json 字段与数组
  3. 03检查技能和 Agent frontmatter
  4. 04验证文件位置
  5. 05检查 MCP 工具引用
  6. 06报告结果并提供修复建议

适用场景

  1. 01发布前验证插件
  2. 02查找插件修改后的结构错误
  3. 03检查技能和 Agent 元数据

MCP 相关

检查 allowed-tools 中列出的工具是否为有效的 mcp__plugin_ruflo-core_ruflo__* 标识符。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ruvnet/ruflo --skill validate-plugin

安装后在 Claude Code 中输入/validate-plugin确认已加载。

详细介绍

验证插件

验证插件是否遵循正确的 Claude Code 插件格式。

适用时机

创建或修改插件后，运行验证，以便在发布前发现结构问题。

执行的检查

  1. 目录结构 — 插件根目录下存在 .claude-plugin/plugin.json
  2. plugin.json 架构 — 存在必需字段（name、description、version）
  3. 技能自动发现 — 每个 skills/<name>/SKILL.md 都是有效技能（Claude Code 会从目录中自动发现；plugin.json 绝不能列出 skills 数组）
  4. 命令自动发现 — 每个 commands/<name>.md 都是有效命令（自动发现；plugin.json 中没有 commands 数组）
  5. Agent 自动发现 — 每个 agents/<name>.md 都是有效 Agent（自动发现；plugin.json 中没有 agents 数组）
  6. plugin.json 中没有旧版数组 — 如果 plugin.json 中存在 skills、commands 或 agents 数组，则验证失败（这些数组会导致 Claude Code 拒绝该插件）
  7. SKILL.md frontmatter — 每个技能都包含 name、description 和 allowed-tools（不能使用通配符）
  8. Agent frontmatter — 每个 Agent 都包含 name、description 和 model
  9. 文件位置无误 — skills、commands、agents 不在 .claude-plugin/ 内
  10. MCP 工具引用 — allowed-tools 中的工具均为有效的 mcp__plugin_ruflo-core_ruflo__* 标识符

步骤

  1. 读取插件的 plugin.json，并确认其中不存在 skills / commands / agents 数组
  2. 使用 Glob 匹配 skills/*/SKILL.md、commands/*.md、agents/*.md，并验证每个文件的 frontmatter
  3. 对每个 SKILL.md，确认 frontmatter 包含必需字段，且 allowed-tools 中没有通配符
  4. 对每个 agent .md，确认 frontmatter 包含必需字段
  5. 报告每项检查的通过或失败状态，并提供可执行的修复建议

评论

支持 Markdown