SuperAPI AI 工具集

relay-review

测试与质量

查看项目

更新于 10-16 02:22

技能介绍

Relay Review 是 Relay 生命周期中的一个评审技能,用于在恢复的 Relay 运行进入评审环节时,由独立的主评审者产出下一个阻塞性生命周期事实。

使用条件 当 relay-recover inspect 推导出唯一的生命周期动作 review 时使用本技能。本地交付路径下,全新的干净 Git HEAD/tree 与最近一次通过的验证必须绑定到同一提交,且无需 PR 或 forge 观测。GitHub 交付路径下,持久的 PR 事实、实时 PR head、通过的验证以及冻结的 Done Criteria 必须全部绑定到同一提交。应由独立的主评审者产出下一个阻塞性生命周期事实。所选路由继承自不可变的运行证据。本地评审不发起 fetch、不调用 gh,也不需要 forge 凭据;GitHub 评审需要确切的实时 PR 观测,以及评审者常规的环境 CLI 认证和网络可用性。

禁止用途 不要使用本技能规划工作、派发执行器、修复发布或合并。这些分别由 relay-plan、relay-dispatch、relay-recover 或 relay-merge 承担。

运行方式 命令:

node skills/relay-review/scripts/review-runner.js
--repo .
--run-id <run-id>
--json

可选输入为 --model <opaque-model> 与 --timeout <seconds>。CLI 认证与 HOME/XDG 配置保持为环境状态;凭据选择器标志未知。--reviewer 只能重复 run.json 中不可变的 reviewer 绑定;Relay 不实现可变的评审者替换或路由优先级。

支持的评审绑定 支持的主评审绑定为 Codex、Claude、OpenCode、Pi、Antigravity 和 Cursor。Cline 仍仅用于调度,因为它没有已注册的结构化主评审输出契约。用于调度的同一扁平适配器描述符声明了该能力。不可变绑定可显式重复为 --reviewer codex、--reviewer claude、--reviewer opencode、--reviewer pi、--reviewer antigravity 或 --reviewer cursor。这些标志用于校验现有绑定,从不替换它。

运行时契约 运行器执行以下步骤:读取不可变的 Relay run.json 与冻结的 Done Criteria;调用规范 inspect 并要求推导动作为 review;要求具备针对冻结 Done Criteria 哈希的确切全新本地 Git head/tree 与通过的验证证明,或确切持久/实时 PR 身份、PR head 与通过的验证证明;构建一个仅含不可变契约、精确 diff、交付身份和验证事实的评审包,绝不包含派发提示、执行器记录、会话 id 或可变生命周期状态;将该包暂存于私有临时目录,要求绑定的适配器进行直接结构化输出调用,并在其运行前后校验不可变暂存字节;重新进入每次运行的锁,重复检查,并追加恰好一条 review_recorded 事实;重新检查并返回下一个推导动作。

评审器仅返回: {"verdict":"pass|changes_requested|escalated","summary":"...","issues":[]}

pass 存储为 lgtm;changes_requested 推导出 redispatch;评审调用或结果错误被持久记录为 escalated。运行时调用失败允许一次显式的评审重试并绑定其事实;第二次失败则按失败关闭。模型返回的升级不可重试。轮次由先前的 review_recorded 事实推导。不存在自动循环、评审预算、可变轮次状态、手动裁定应用、分离的评审监督者、PR 评论权限或生命周期转换。

执行与失败行为 认证与 HOME/XDG 配置属于环境用户本地的 CLI 状态。Relay 不复制凭据文件、不重写 HOME/XDG,也不序列化认证值或源路径。评审输入包仍单独暂存。GitHub 路由评审者使用 --network-access enabled(默认值);选择 disabled 会在调用前失败。启用后的传输为无限制的评审者进程网络,不声称仅限提供方或工具网络隔离。本地评审没有 forge 传输要求。Relay 直接在受信任的本地主机上运行,并在可用时请求适配器的原生文件系统隔离;缺失或仅声明式的隔离会作为非持久的 filesystem_isolation 诊断返回,且不会拒绝评审。暂存的提示、diff、标准、schema 和可执行绑定在调用后重新校验,任何变更或漂移都不会产生评审事实。PR head 过期、验证缺失、动作变更、适配器不支持或评审者绑定不匹配均不会写入评审事实。

适用场景 适用于已具备确切提交与通过验证证明的 Relay 恢复运行,需要在本地或 GitHub 交付路径下进行独立主评审的场合。

限制 不承担规划、派发、修复、合并等职责;不支持可变评审者替换;Cline 不支持主评审;认证与网络依赖环境状态;文件系统隔离视适配器可用性而定。