mcpField
R
relay-review

relay-review

github.com/sungjunlee测试与质量043 次安装5 周前更新
代码仓库

关于 relay-review

relay-review 是一种技能，可在 Relay 运行的生命周期证据允许审查时获取独立的结构化审查。它支持本地与 GitHub 交付路径，将审查绑定到已验证的提交和冻结的 Done Criteria，并记录结论。

主要功能

  1. 01支持本地与 GitHub 审查路径
  2. 02检查运行证据和审查资格
  3. 03暂存受约束的审查材料包
  4. 04支持六种绑定的主要审查器
  5. 05记录通过、要求修改或升级

适用场景

  1. 01验证后审查本地交付的更改
  2. 02依据冻结的 Done Criteria 审查 GitHub PR

安装

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

$npx skills add https://github.com/sungjunlee/dev-relay --skill relay-review

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
evaluate-criteria.md
review-lineage.md
reviewer-prompt.md
runner-notes.md
scripts/
review-runner-helpers.js
review-runner.js

详细介绍

Relay Review

适用场景

  • relay-recover inspect 推导出的唯一生命周期操作为 review。
  • 对于本地交付，最新的干净 Git HEAD/树和最新通过的验证绑定到同一提交；无需 PR 或 Forge 观察结果。
  • 对于 GitHub 交付，持久化 PR 事实、实时 PR 头、通过的验证以及冻结的 Done Criteria 均绑定到同一提交。
  • 独立的主审查者应生成下一个阻塞性生命周期事实。

所选路由继承自不可变的运行证据。本地审查不会获取数据、调用 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 审查者绑定。Relay 不支持可变的审查者切换，也不支持路由优先级。

受支持的主审查绑定包括 Codex、Claude、OpenCode、Pi、Antigravity 和 Cursor。Cline 仅支持派发，因为它没有已注册的结构化主审查输出契约。派发使用的同一平面适配器描述符会声明此能力。

可显式重复指定不可变绑定：--reviewer codex、--reviewer claude、--reviewer opencode、--reviewer pi、--reviewer antigravity 或 --reviewer cursor。这些标志会验证现有绑定，绝不会替换绑定。

运行时契约

运行器：

  1. 读取不可变的 Relay run.json 和冻结的 Done Criteria。
  2. 调用规范的 inspect，并要求推导出的操作为 review。
  3. 对于冻结的 Done Criteria 哈希，要求提供精确且最新的本地 Git 头/树及验证通过证明，或精确且持久化的实时 PR 标识、PR 头及验证通过证明。
  4. 构建一个审查包，其中仅包含不可变契约、精确差异、交付标识和验证事实。绝不包含派发提示词、执行器记录、会话 ID 或可变生命周期状态。
  5. 将该审查包暂存到私有临时目录，并要求绑定的适配器直接调用结构化输出；运行前后都会检查暂存字节是否不可变。
  6. 重新进入每次运行的锁，重复检查，并且只追加一个 review_recorded 事实。
  7. 再次检查并返回下一个推导出的操作。

审查者只返回：

{"verdict":"pass|changes_requested|escalated","summary":"...","issues":[]}

pass 会存储为 lgtm；changes_requested 会推导出 redispatch；审查者调用或结果错误会被持久记录为 escalated。运行时调用失败时，允许进行一次明确绑定到该事实的 review 重试；第二次失败则安全失败关闭。模型返回的升级不可重试。轮次根据先前的 review_recorded 事实推导。没有自动循环、审查预算、可变轮次状态、手动应用判定、分离式审查监督器、PR 评论权限或生命周期转换。

执行与失败行为

  • 身份验证和 HOME/XDG 配置属于用户本地的 CLI 环境状态。 Relay 不会复制凭据文件、重写 HOME/XDG，也不会序列化身份验证值或源路径。评审输入包仍会单独暂存。
  • GitHub 路由的评审器使用 --network-access enabled（默认值）；选择 disabled 会在调用前失败。启用的传输允许评审器进程不受限制地访问网络，不代表仅限提供商的网络访问，也不代表工具网络隔离。本地评审不需要 Forge 传输。
  • Relay 直接在受信任的本地主机上运行。只要适配器支持，就会请求其原生文件系统隔离；若隔离不可用或仅作声明，则返回非持久的 filesystem_isolation 诊断信息，不会拒绝评审。
  • 调用后会重新检查暂存的提示词、差异、标准、架构和可执行文件绑定。任何变更或偏差都会导致不生成评审事实。
  • PR 头提交过时、缺少验证、操作变更、适配器不受支持或评审器绑定不匹配时，都不会写入评审事实。

请参阅运行器说明和适配器平台。

评论

支持 Markdown