用途:在本地分支尚未成为 PR 之前,对当前所在分支做深度代码审查。审查范围是 merge-base..working-tree,即把已提交、已暂存和未暂存改动合并为一个面,等同于“将要推送的全部内容”。它是 review-pr 的姊妹技能,使用相同的智能体、证明契约与校准,区别在于范围发现方式,且代码属于你自己。
主要能力:按级别调度审查智能体。quick 仅 implementation-reviewer;standard(默认)增加 verification-reviewer、alternative-approach、security-reviewer;deep 再增加 comment-analyzer、docs-reviewer、performance-analyzer、security-analyzer。也可用 --agents 显式指定。reproduce-verifier 不在任何级别中,需在分支确实修复已登记 issue 时手动加入。
使用方式:先确定范围,刷新 origin/master 并计算 merge-base,用 git diff "$BASE" 生成 diff,收集改动文件与未跟踪文件;随后启动本地沙箱并生成只读视图;编写 charter;按级别调度智能体;验证每个智能体确实审查了内容;裁剪并写出草稿到 ~/.nx-branch-reviews;最后停止沙箱并提示未运行的智能体。
限制:仅生成草稿,从不提交、推送或编辑工作区。本地沙箱无隔离,exec=screened 只是护栏而非安全边界,会拒绝明显写入命令。未跟踪文件不会出现在 diff 中,需单独列出并声明未被审查。默认分支上拒绝运行。dirty 树无稳定身份,需重新审查而非去重。不执行 close-without-merge 检查、Polygraph 会话检查,也不调用 gh。