用途:对一组代码改动进行审查并报告实际问题,重点在于借助 Baz 的索引搜索,把改动与本检出之外的代码对照,发现签名变更等在本仓库看似安全、却会破坏其他仓库调用方的情况。审查默认只读,不编辑文件、不 amend、不 push;只有 --fix 循环或用户明确要求时才修改。
范围解析:解析 $ARGUMENTS 后构建 diff。先依次用 git rev-parse --verify 确认基准分支(origin/HEAD、origin/main、origin/master、main、master),--base 可覆盖;若都解析不到,应执行 git fetch --depth=100 origin <branch> 或询问用户,不要假设 main 存在。默认审查 git diff $(git merge-base <base> HEAD);committed 用 git diff <base>...HEAD;uncommitted 用 git diff HEAD;--include-untracked 追加 git ls-files --others --exclude-standard;--pr 用 gh pr diff <n> 或 glab mr diff <n>。冲突时 --pr 排他需询问,committed+uncommitted 等同默认,--include-untracked+committed 矛盾需停止,--base 对 uncommitted 无效。审查前用一行说明最终范围、基准、文件数、提交数及被拒或无效的标记。
主要能力:跨仓库检查被破坏的调用方(对外签名、响应结构、事件、DB 列、导出变更时 remote_grep 全组织搜索);检查契约两端;检查新增枚举/处理器/路由是否漏掉注册点;检查是否重复造轮子。还审查正确性、并发与状态、安全、失败处理、回归、测试。不报风格、格式、命名偏好、推测性重构,也不报改动未引入的既有问题。搜索预算为 10 次调用,耗尽需说明哪些符号未检查。
使用方式:Baz 工具(如 mcp__baz__repo_search)必须可用并已认证,调用时传 sessionId、sessionRepository、agentVendor 等会话关联参数。Baz 不可用时不得静默降级为纯本地审查:若 diff 有对外表面,应停止并说明未运行跨仓库检查;若无对外表面可继续并注明。报告按严重度分组,每条给出 file:line、触发条件与修复,并单列覆盖率;跨仓库检查未运行且有对外表面时,不得声称可安全合并。
适用场景:需要跨仓库影响的代码改动审查,尤其是签名、API、事件、schema、枚举、公共导出变更。限制:依赖 Baz 与 gh/glab 等工具,--pr 需 gh/glab 在 PATH 且已认证;大 diff 应分批审查而非截断;空 diff 应报告而非报错。