用途
Cross CR 用于在实现计划执行前或完整实现完成后,将目标交给其他代理 CLI 进行独立、只读的评审。主机代理负责准备自包含的评审简报,捆绑运行器以固定的只读策略启动评审器,评审结果随后交给 cr-received 作为待验证的主张处理。
主要能力
- 支持两种模式:plan(在执行前对照规格评审实现计划)和 implementation(对照规格与计划对完整实现做最终评审,或在没有规格与计划时对照对话中的请求评审变更)。
- 可指定评审器家族(claude、codex、gemini/Antigravity)、模型简写或完整模型 ID,以及推理强度(low|medium|high|xhigh|max)。
- 无参数时默认使用与主机相反的 CLI;多个评审组会并行运行在同一目标上。
- 运行器提供 resolve 命令解析参数并输出每个评审器的 agent、完整模型 ID、effort 和 same_cli 信息。
- 支持通过 --target 指定评审边界(working-tree、range、tree),并通过 --exclude 排除路径。
- 支持 --followup 用于后续轮次,并可通过 --dispositions 传入处置文件。
- 运行报告包含评审器、模型、effort、令牌用量、成本估算等信息;成本为列表价等价,不是实际账单。
- 结果检查要求 review.md 明确评审目标、覆盖范围、每个判定以及带 ID、严重性和位置的问题列表。
使用方式
- 确认依赖:定位同目录下已安装的 cr-request 技能,两种模式都需要其 references/brief.md 和 references/tree-fingerprint.md,implementation 模式还需要 references/target.md 和 references/lenses.md。缺失时报告依赖不可用并停止。
- 捕获目标身份:仓库根、分支或工作树、HEAD、工作树状态;plan 模式需提供计划与规格路径,通过 --plan 和 --spec 传给运行器进行哈希。
- 在选择材料时执行秘密卫生检查:排除 .env、凭证文件、私钥及不相关的未跟踪文件,遵循 gitignore 规则,不跟随指向仓库外的符号链接。
- 固定实现边界:从可信基线到当前工作树,使用 git diff BASE 加上选中的未跟踪文件完整内容。
- 记录目标指纹:包括 base、head、计划与规格哈希、选中跟踪差异的身份、每个选中未跟踪文件的哈希,以及 Tree 指纹。
- 构建一份 UTF-8 简报文件,包含角色、评审模式、目标身份与指纹、需求来源、范围内的外来变更、仓库规则、排除路径及响应语言等。
- 将简报写入私有临时文件,通过技能目录内 scripts/cross_review.py 的绝对路径调用运行器;多评审器时并行启动并等待全部退出。
- 检查并移交结果:核对 review.md 是否完整,向用户展示运行报告与判定,然后将所有发现交给 cr-received。
适用场景
- 用户明确要求跨评审或获取其他代理的意见。
- plan-craft 保存了引用规格的计划后,用户要求进行跨评审。
- implement 之后,用户要求以跨评审替代或补充 cr-request 步骤。
- 用户明确要求评审基于对话请求做出的变更,且没有规格或计划。
限制
- 该技能不修复发现、不判定其有效性、不运行验证、不结束分支。
- 不由任何 aw 技能自行调用,仅在用户请求时运行;跨评审从不阻塞计划移交,无法运行时返回 unavailable 及原因。
- 不自动回退到同一 CLI 或其他评审器;同一主机 CLI 的评审组虽可运行,但会标记为非跨供应商评审。
- 运行器不校验模型名称,拼写错误的模型会在评审器 CLI 内部失败。
- 超过 4 MiB 的差异或文件内容会以退出码 2 失败,而不是截断。
- 评审可能耗时十分钟以上,运行器对仍在工作的评审器不设超时。
- Antigravity 运行 agy 且仅当 gemini 组明确指定时使用;其只读行为来自 agy 本身,不来自运行器;agy 不报告成本,因此 Antigravity 运行的成本始终显示 unknown。
- 绝不为了获得运行器接受的边界而仅做提交。
- 缺失的事实(如具体价格表日期、完整退出码列表等)在资料中有部分提及,但未提供完整细节,暂未提供。