用途:对一段 diff 做发布前的完整审查。它把并行、只读的多个审查者分别放在独立子智能体中,避免无障碍与安全等推理相互干扰,最后汇总成一个按严重程度排序的结论;两个审查者独立发现的同一问题被视为最高信号,会单独标出。
主要能力:审查者来自两类来源,一是按 diff 中文件类型选取的审计技能(a11y-audit、i18n、perf-audit、deps-audit、harden、safe-repo),二是作用于整个 diff 的智能体视角(正确性、测试有效性、类型安全、架构摩擦)。始终包含正确性(code-review)、敏感数据(safe-repo diff-only)、测试有效性三项;其余按 diff 内容增补。默认共 3 至 5 个,也接受 $ARGUMENTS 指定的数量(2 至 5)。不生成端到端或视觉验证审查者,那属于 VERIFY 阶段。
使用方式:先解析 diff——PR 编号用 gh pr view 与 gh pr diff,失败则回退到当前分支 diff 并警告;指定分支用 git diff <base>...<branch>;无参数则用 git merge-base HEAD main(依次回退 master、origin/HEAD,最后 HEAD~10 并警告)后执行 git diff <base>...HEAD;diff 为空则输出 "Nothing to review" 并停止,同时说明范围。随后公布所选审查者,逐个写一行跳过无关项的原因;在一条消息中并发启动全部审查者,各自获得仓库路径、确切的 diff 命令与文件子集、一段上下文、其指令、可选的 .specs/plans/*.md 指针,以及输出约定:带 file:line、严重程度(critical / important / suggestion)和一行理由的发现。全程只读,不做编辑、暂存、提交或推送。
汇总与结论:合并去重,标记收敛项(同一行至少 2 名审查者),出错子智能体记为跳过而非静默丢弃,不夸大也不压低真实严重程度;只有确认已处理才可删去发现并说明原因。输出包含范围、审查者、Critical、Important、Suggestions、Converged、Non-issues 的摘要。结论为 APPROVE(无 Critical 且无 Important)、REQUEST CHANGES(存在 Critical,或 3 个及以上 Important)或 NEEDS DISCUSSION(涉及架构取舍的 Important)。仅提供下一步建议,不自动修复。
限制:构建与安装可能冲突,perf-audit 会构建、deps-audit 可能触及 node_modules,需给它们 worktree 隔离或在只读审查者之后串行运行;审查者需匹配运行环境中真实可用的智能体类型,不得虚构;若子智能体无法加载技能,则退回到该技能的检查清单。官方文档未提供收费、价格、平台支持与效果数据。