mcpField
C
cross-modal-review

cross-modal-review

github.com/garrytan测试与质量31.3k248 次安装今天更新
代码仓库

关于 cross-modal-review

cross-modal-review 是一项在定稿前使用另一模型审查成果的技能。它依据来源技能的 Contract 评估结果并报告共识与分歧,最终决定权始终由用户掌握。

主要功能

  1. 01使用不同模型进行审查
  2. 02依据来源技能的 Contract 评分
  3. 03附证据报告审查发现
  4. 04拒绝时转交下一位审查模型
  5. 05修改前须获用户批准

适用场景

  1. 01为重大代码改动征求第二意见
  2. 02评估安全敏感的工作
  3. 03检查新建或修改的技能
  4. 04审查陷入停滞的成果或批量操作

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/garrytan/gbrain --skill cross-modal-review

安装后在 Claude Code 中输入/cross-modal-review确认已加载。

详细介绍

跨模型审查

约定: 审查配对与拒绝路由链参见 conventions/cross-modal.yaml。

与 gbrain eval cross-modal 的关系: 本 Skill 是人工介入的流程中期关卡(在提交前由一个模型审查工作成果,并进行拒绝路由)。gbrain eval cross-modal 命令(v0.27.x)是其兄弟接口:由 3 个不同提供方的前沿模型依据一份文档化的维度列表进行评分并迭代,然后测试才将行为固化下来。临时的第二意见使用本 Skill;skillify 第 3 阶段的质量关卡使用 gbrain eval cross-modal。两者互为补充,并不重复。

契约

本 Skill 保证:

  • 工作成果在定稿前由另一个不同的模型进行审查。
  • 审查依据源 Skill 的契约部分(即承诺的内容)进行评分,而非凭感觉。
  • 一致与分歧都会被透明地报告。
  • 某个模型拒绝时,会悄无声息地切换到链中的下一个模型。
  • 用户始终做最终决定(用户主权)。

何时调用(v0.25.1 门控)

在以下情况调用本 Skill:

  • 重大代码变更:任何涉及 5 个及以上文件或 100 行及以上代码的提交。架构决策、重构、API 变更。
  • 安全敏感变更:认证流程、brain 写入信任边界、webhook 转换、跨 Skill 数据传递。
  • 停滞或反复:同一问题迭代 2 次及以上仍无进展。
  • 批量操作前:运行批量 enrichment、迁移或批量写入之前(参见 conventions/test-before-bulk.md)。
  • Skill 创建 / 修改:影响运行行为的新建或重写 Skill。
  • brain 页面质量问题:需要依据源 Skill 的契约验证 brain 写入内容时。

以下情况不要调用:

  • 简单的记忆写入或 brain 页面更新
  • 单文件错别字修复
  • 例行 cron 输出或心跳操作
  • 已审查工作成果的 Git 提交 / 推送

阶段

  1. 捕获工作成果。 需要审查的 brain 页面、分析、代码 diff 或决策。
  2. 加载契约。 阅读源 Skill 的契约部分(即承诺的内容)。
  3. 派生审查模型。 将工作成果与契约一并发送给另一个不同的模型。模型选择参见 conventions/model-routing.md。
  4. 评分。 模型评估:输出是否遵循了契约?给出通过 / 不通过的结论,并附具体引用。
  5. 报告。 向用户呈现一致与分歧之处。绝不自动应用审查者的建议。

代码审查交接(v0.25.1 扩展)

具体到 diff 审查,gstack 提供了一个封装 OpenAI Codex CLI 的 /codex Skill。两种模式:

Codex 审查

来自另一套 AI 系统的独立 diff 审查。用户调用 /codex review(gstack 自带);跨模型审查的职责是识别何时这是合适的工具,并明确推荐使用它。

何时推荐 /codex review:

  • 实质性 diff 落地之后、合并之前
  • 用户希望获得一个并非另一个 Claude 的第二意见时

输出呈现方式(跨模型审查展示 Codex 输出时):

CODEX REVIEW (independent second opinion):
══════════════════════════════════════════
<full codex output, verbatim>
══════════════════════════════════════════

CROSS-MODEL ANALYSIS:
  Both found:    [overlapping findings]
  Only Codex:    [findings unique to Codex]
  Only Claude:   [findings unique to my analysis]
  Agreement:     X% (N/M findings overlap)

由用户决定采取哪些行动。跨模型的一致是信号,而非授权。

对抗性挑战

形式相同,但提示词不同。用于安全敏感变更:审查者被要求找出注入向量、竞态条件、认证绕过、数据泄露以及权限提升路径。

输出会增加可利用性评级(CRITICAL / HIGH / MEDIUM / LOW)以及推荐的缓解措施。

拒绝路由

如果主审查模型拒绝:

  1. 悄无声息地切换到链中的下一个模型(参见 conventions/cross-modal.yaml)。
  2. 不向用户展示拒绝信息。
  3. 不宣布切换。
  4. 如果链中所有模型都拒绝,则升级交由用户处理。

输出格式

标准审查
Cross-Modal Review
==================
Reviewer:  {model name}
Contract:  {originating skill}
Verdict:   PASS | ISSUES FOUND

Findings:
- {finding with evidence}

Agreement with primary: {X}%
代码审查
Cross-Modal Review (code)
==========================
Mode:           Codex Review | Adversarial Challenge
Files changed:  N
Lines changed:  +N / -N

{mode-specific output above}

用户主导规则(铁律)

审阅者的意见仅供参考,在用户明确批准每一条之前,不得采纳。在未逐条呈现意见并获得明确批准的情况下,不得将审阅者的建议纳入工作成果。即使审阅者正确,也同样适用。跨模型的一致意见是很强的信号,应当如实呈现,但决定权在用户手中。

失败处理

对于任何 gbrain 错误 code、退出码、[AGENT] 块或提示块,请遵循 agent 操作员协议。本技能的具体要求如下:

  • 某个审阅模型拒绝时:静默切换到链中的下一个模型;只有当所有模型都拒绝时,才上报给用户。
  • gbrain eval cross-modal 因缺少提供方密钥或 no_pricing 而失败时:指明缺失的提供方,并使用已配置的模型继续运行;绝不能将未实际运行的审阅报告为通过。

反模式

  • ❌ 未经用户批准就自动应用审阅者的建议
  • ❌ 向用户展示模型的拒绝信息
  • ❌ 用同一个模型同时负责审阅和生成
  • ❌ 跳过 Contract 参考(只凭感觉审阅,而不是依据保证)
  • ❌ 对琐碎改动(错别字、格式调整)进行代码审阅
  • ❌ 在缺少 git diff 上下文的情况下进行代码审阅

相关技能

  • gstack /codex —— 本技能在 diff 审阅模式下移交给的实际 Codex CLI 封装。cross-modal-review 负责判断何时调用;/codex 负责具体怎么做。
  • skills/testing/SKILL.md —— 运行项目测试套件;对于"该提交是否可以安全合入"这一问题,是互补的信号。
  • skills/conventions/cross-modal.yaml —— 审阅配对与拒绝路由。

输出格式

技能的输出结构已在上文正文各节中以内联方式说明(参见"输出"、"Brain 页面格式"或同类章节)。此处的字面章节标题仅为一致性测试(test/skills-conformance.test.ts)而保留。

评论

支持 Markdown