SuperAPI AI 工具集

plugin-validator

通用与其它

查看项目

更新于 10-15 23:28

技能介绍

用途:校验 Claude Code 插件的结构、JSON schema、frontmatter 格式、安全合规与市场目录一致性,运行与 CI 流水线相同的检查,在提交前发现问题。

主要能力:检查必需文件(.claude-plugin/plugin.json、README.md、LICENSE、至少一个组件目录);校验 plugin.json 必填字段(name 为 kebab-case、version 为 semver、description、author.name、author.email、license、keywords 至少 2 个)并拒绝允许集合之外的字段;校验 commands、agents、skills 的 frontmatter;检查目录层级;检查 .sh 文件执行权限;扫描硬编码密钥、AWS 密钥、私钥、危险命令与可疑 URL;校验 marketplace.extended.json 中的条目、版本/名称/分类/源路径一致性及重名;检查 README 是否含安装、用法、描述章节;检查 hooks 是否使用 ${CLAUDE_PLUGIN_ROOT} 而非硬编码绝对路径。

使用方式:需目标插件目录读权限、仓库级 .claude-plugin/marketplace.extended.json、已安装 jq、PATH 中有 grep 与 find,以及仓库根目录的 ./scripts/validate-all-plugins.sh。从上下文或用户请求确定插件路径,默认当前工作目录(若含 .claude-plugin/ 子目录)。输出结构化报告,含通过/失败计数、逐项结果、失败项的问题、文件位置与可直接运行的修复命令、非关键警告,以及 PASSED 或 FAILED 结论。

限制:仅针对 Claude Code 插件;依赖 jq、grep、find 与指定脚本;具体安装方式、收费与平台信息暂未提供。