用途:对插件进行分层质量审查,并根据依赖关系确定检查范围,适合 PR 与发布前审计。
主要能力:提供 branch、pr、release 三个层级,分别对应默认、合并前和版本升级前场景,检查深度与耗时递增。流程包括范围检测、计划、执行和报告;输出按插件列出 test、lint、type、reg 与 verdict,并给出总体 PASS、PASS-WITH-WARNINGS 或 FAIL 结论。支持 --quality-gate 模式用于 CI/CD,退出码区分警告与失败:0 全部通过,1 有警告但通过,2 阻断性失败,3 严重问题;可用 --fail-on warning 将警告视为阻断。
使用方式:通过 --tier 指定层级;范围检测用 git diff main --name-only 过滤 plugins/*/ 找出受影响插件,再从 docs/plugin-dependencies.json 的反向索引解析相关插件;release 层级或无 git diff 时覆盖全部插件。可在插件根目录放置 .plugin-review.yaml 自定义阈值与关注领域,如 structure_min、skills_min、hooks_min、tokens_max_total、bloat_max_percentage、focus_areas、exclude_patterns 和 severity_overrides。
适用场景:插件级质量审查、PR 合并前检查、发布前全量审计。
限制:不适用于单个技能审查(应使用 abstract:skills-eval)、hooks 审查(abstract:hooks-eval)或跨插件 Skill() 引用追踪(abstract:skill-graph-audit)。低于 structure_min(默认 80)或 skills_min(默认 75)的插件会被列为 FAIL 而非警告。