SuperAPI AI 工具集

plugin-validator

智能体与模型

查看项目

更新于 10-16 03:44

技能介绍

用途:Plugin Validator 用于校验 Claude Code 插件的健康状态,检查清单、结构、frontmatter、依赖与配置问题,适合在插件无法加载或组件出错时排查,不负责创建、修改或安装插件。

主要能力:

  1. 清单校验:确认 plugin.json 位置、JSON 语法、必填字段(name、description、version)、语义化版本(X.Y.Z)格式及数组字段与重复项。
  2. 结构校验:检查清单引用的 agents、commands、skills 文件是否存在、路径是否为相对路径、有无失效引用及目录规范。
  3. Frontmatter 校验:校验 YAML 语法、必填字段、字段类型、tools 列表、model 取值(sonnet|opus|haiku|inherit)及冲突或废弃字段。
  4. 依赖校验:检测 agents/skills 间循环依赖,验证 skill 引用、工具权限、交叉引用与外部依赖说明。
  5. 配置校验:检查组件间设置冲突、文件可读性、重名、文件间版本一致性与仓库元数据。

使用方式:技能会先定位插件位置,例如执行 find . -name "plugin.json" -o -name ".claude-plugin/plugin.json";随后依次做清单、结构、frontmatter、依赖与配置校验,最后按 CRITICAL、WARNING、INFO 分级报告,给出文件/行号与修复建议。常见命令如 python3 -m json.tool plugin.json 校验 JSON 语法,test -f .claude-plugin/plugin.json || test -f plugin.json 检查位置,grep '"agents"' plugin.json 查看 agent 路径,head -20 agents/my-agent.md 查看 frontmatter。

适用场景:用户提到“validate plugin”“check plugin health”“插件不加载”“agent 文件报错”等。不适用于创建、更新版本或安装插件的请求。

限制:资料未提供安装方式、运行环境要求、是否收费或价格信息,暂未提供。