用途:对 Claude Code 插件运行所有可用检查,并原样输出各工具结果,不做转述或改写。
主要能力:运行 claude plugin validate(清单权威校验)、plugin-dev 的 hook linter(每个 hook 脚本一次)与 agent validator(每个 agent 文件一次),以及自研 check.py 的三类检查——E 系列外部组件(路径能否解析、是否留在插件内、文件能否解析、是否重复键或标识符冲突)、S 系列自一致性(同一 frontmatter 块内既授权又拒绝、frontmatter 围栏不在第一行导致整块失效、围栏示例内的执行行仍被加载器运行)、P 系列容器性(绝对家目录路径、凭据、个人地址等外泄风险)。
使用方式:bash ${CLAUDE_PLUGIN_ROOT}/scripts/run-checks.sh <plugin-dir>;加 --strict 使警告也导致失败。check.py 可用 --only 只跑子集。退出码:0 表示全部检查通过,1 表示至少一项发现问题,2 参数错误,3 表示没有失败但存在无法检查的内容。
限制:agent validator 遇首个发现即停止,且会把可选的 model 或 color 缺失报为错误,不应据此直接修改;应修复后再跑,而非把一次结果当作完整列表。validate-hook-schema.sh 在标准 hooks.json 结构下会崩溃,validate-settings.sh 读的是 settings 文件而非插件,二者被刻意不运行。输出中标记为 UNCHECKED 并非通过,表示检查无法执行(缺少 CLI、python3 或 PyYAML,或无可读内容);若完全没有检查运行则退出码为 3 而非 0。结果仅打印到 stdout,不写入任何文件。