SuperAPI AI 工具集

cross-cr

智能体与模型

查看项目

更新于 10-28 08:31

技能介绍

用途

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、严重性和位置的问题列表。

使用方式

  1. 确认依赖:定位同目录下已安装的 cr-request 技能,两种模式都需要其 references/brief.md 和 references/tree-fingerprint.md,implementation 模式还需要 references/target.md 和 references/lenses.md。缺失时报告依赖不可用并停止。
  2. 捕获目标身份:仓库根、分支或工作树、HEAD、工作树状态;plan 模式需提供计划与规格路径,通过 --plan 和 --spec 传给运行器进行哈希。
  3. 在选择材料时执行秘密卫生检查:排除 .env、凭证文件、私钥及不相关的未跟踪文件,遵循 gitignore 规则,不跟随指向仓库外的符号链接。
  4. 固定实现边界:从可信基线到当前工作树,使用 git diff BASE 加上选中的未跟踪文件完整内容。
  5. 记录目标指纹:包括 base、head、计划与规格哈希、选中跟踪差异的身份、每个选中未跟踪文件的哈希,以及 Tree 指纹。
  6. 构建一份 UTF-8 简报文件,包含角色、评审模式、目标身份与指纹、需求来源、范围内的外来变更、仓库规则、排除路径及响应语言等。
  7. 将简报写入私有临时文件,通过技能目录内 scripts/cross_review.py 的绝对路径调用运行器;多评审器时并行启动并等待全部退出。
  8. 检查并移交结果:核对 review.md 是否完整,向用户展示运行报告与判定,然后将所有发现交给 cr-received。

适用场景

  • 用户明确要求跨评审或获取其他代理的意见。
  • plan-craft 保存了引用规格的计划后,用户要求进行跨评审。
  • implement 之后,用户要求以跨评审替代或补充 cr-request 步骤。
  • 用户明确要求评审基于对话请求做出的变更,且没有规格或计划。

限制

  • 该技能不修复发现、不判定其有效性、不运行验证、不结束分支。
  • 不由任何 aw 技能自行调用,仅在用户请求时运行;跨评审从不阻塞计划移交,无法运行时返回 unavailable 及原因。
  • 不自动回退到同一 CLI 或其他评审器;同一主机 CLI 的评审组虽可运行,但会标记为非跨供应商评审。
  • 运行器不校验模型名称,拼写错误的模型会在评审器 CLI 内部失败。
  • 超过 4 MiB 的差异或文件内容会以退出码 2 失败,而不是截断。
  • 评审可能耗时十分钟以上,运行器对仍在工作的评审器不设超时。
  • Antigravity 运行 agy 且仅当 gemini 组明确指定时使用;其只读行为来自 agy 本身,不来自运行器;agy 不报告成本,因此 Antigravity 运行的成本始终显示 unknown。
  • 绝不为了获得运行器接受的边界而仅做提交。
  • 缺失的事实(如具体价格表日期、完整退出码列表等)在资料中有部分提及,但未提供完整细节,暂未提供。