Cross-Modal Review 是一个“跨模型审查”技能,核心用途是在工作成果最终确定前,引入一个不同的 AI 模型作为质量闸门,依据来源技能的 Contract(即该技能承诺要交付什么)来评审产物,而不是凭主观感觉打分。约定见 conventions/cross-modal.yaml,其中定义了审查配对与拒绝路由链。
与 gbrain eval cross-modal 的关系:本技能是手动、流程中段的闸门(一个模型在提交前审查产物,并带拒绝路由);gbrain eval cross-modal 命令(v0.27.x)是它的姊妹界面——三个不同供应商的前沿模型,在测试固化行为前,按有文档记录的维度清单进行打分与迭代。本技能用于临时的第二意见;gbrain eval cross-modal 用于 skillify 第三阶段的质量闸门。两者互补而非重复。
契约保证:工作成果在最终确定前由不同模型审查;评审依据来源技能的 Contract 章节(承诺内容)而非感觉;一致与分歧会被透明报告;某一模型拒绝时静默切换到链中下一个;最终决定权始终归用户(用户主权)。
何时调用(v0.25.1 门控):显著代码改动(任何涉及 5 个以上文件或 100 行以上的提交)、架构决策、重构、API 变更;安全敏感变更(认证流程、brain-write 信任边界、webhook 转换、跨技能数据传递);卡壳或反复纠结(同一问题迭代 2 次以上无进展);批量操作前(运行批量富化、迁移或批量写入前,见 conventions/test-before-bulk.md);技能创建/修改(影响操作行为的新技能或重写技能);脑页质量担忧(brain 写入需要对照来源技能 Contract 验证时)。不应对以下情况调用:简单记忆写入或脑页更新、单文件拼写修正、常规 cron 输出或心跳操作、对已审查工作的 git commit / push。
阶段:1) 捕获工作成果(脑页、分析、代码 diff 或待评审决策);2) 加载 Contract,读取来源技能的 Contract 章节;3) 调起审查模型,将工作 + Contract 发送给不同模型,模型选择用 conventions/model-routing.md;4) 评分,模型评估输出是否遵循 Contract,给出带具体引用的通过/失败;5) 报告,向用户呈现一致/分歧,绝不自动应用审查者建议。
代码审查交接(v0.25.1 扩展):针对 diff 审查,gstack 提供 /codex 技能,封装 OpenAI Codex CLI,有两种模式。Codex Review 是从不同 AI 系统进行的独立 diff 审查,用户调用 /codex review(gstack 自带);cross-modal-review 的职责是识别何时该用它并明确推荐。推荐 /codex review 的时机:实质 diff 落地后、合并前;用户想要一个不是另一个 Claude 的第二意见。呈现 Codex 输出时的框架为:CODEX REVIEW(独立第二意见)逐字列出完整 codex 输出,再做 CROSS-MODEL ANALYSIS,列出“双方都发现”“仅 Codex 发现”“仅 Claude 发现”以及一致性百分比(N/M 发现重叠)。用户决定采取哪些行动;跨模型一致是信号,不是许可。
对抗性挑战:形态相同、提示不同,用于安全敏感变更;审查者被要求寻找注入向量、竞态条件、认证绕过、数据泄漏、权限提升路径。输出增加可利用性评级(CRITICAL / HIGH / MEDIUM / LOW)与建议缓解措施。
拒绝路由:若主审查模型拒绝,静默切换到链上下一个模型(见 conventions/cross-modal.yaml);不向用户展示拒绝;不宣布切换;若链上所有模型都拒绝,则升级给用户。
输出格式。标准审查:Cross-Modal Review,Reviewer(模型名)、Contract(来源技能)、Verdict(PASS | ISSUES FOUND)、Findings(带证据的发现)、与主模型的一致性百分比。代码审查:Cross-Modal Review (code),Mode(Codex Review | Adversarial Challenge)、Files changed、Lines changed(+N / -N),然后是模式特定输出。
用户主权规则(铁律):在用户逐条明确批准之前,审查者的发现只是“信息性”的。即使审查者是对的,也不得未逐条呈现并取得明确批准就把审查建议并入工作成果。跨模型共识是强信号——应如此呈现——但决定权在用户。
失败处理:遵循 agent operator 协议处理任何 gbrain 错误码、退出码、[AGENT] 块或通知块。本技能特有:审查模型拒绝时,静默切换到链上下一个模型,仅当所有模型都拒绝时才升级给用户;gbrain eval cross-modal 因缺少 provider key 或 no_pricing 失败时,要指出缺失的 provider,并用已配置的模型运行;绝不把未运行的审查报告为通过。
反模式:未经用户批准自动应用审查建议;向用户展示模型拒绝;用同一模型既生成又审查;跳过 Contract 引用(凭感觉而非承诺审查);对琐碎改动(拼写、格式)做代码审查;在没有 git diff 上下文的情况下运行代码审查。
相关技能:gstack /codex(本技能在 diff 审查模式中交接给它的实际 Codex CLI 封装;cross-modal-review 知道何时调用,/codex 知道如何调用);skills/testing/SKILL.md(运行项目测试套件,为“这次提交是否可安全落地”提供互补信号);skills/conventions/cross-modal.yaml(审查配对 + 拒绝路由)。