relay-review

Relay Review

使用する場合

• relay-recover inspect によって、単一のライフサイクルアクション review が導出された場合。
• ローカルへのデリバリーでは、新鮮でクリーンな Git HEAD／ツリーと、最新の合格済み検証が同じコミットに紐付いています。PR やフォージの観測は不要です。
• GitHub へのデリバリーでは、永続的な PR の事実、現在の PR ヘッド、合格済み検証、凍結された Done Criteria がすべて同じコミットに紐付いています。
• 独立したプライマリレビュアーが、次のブロッキングライフサイクル事実を作成する必要があります。

選択されたルートは、不変の実行証跡から継承されます。ローカルレビューではフェッチや gh の呼び出しは行わず、フォージの認証情報も必要ありません。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. 不変の契約、正確な差分、デリバリーの識別情報、検証の事実だけを含むレビュー用バンドルを1つ作成します。ディスパッチプロンプト、実行担当者のトランスクリプト、セッション ID、変更可能なライフサイクル状態は含めません。
5. そのバンドルをプライベートな一時ディレクトリにステージングし、紐付けられたアダプターに構造化出力を直接呼び出すよう要求します。ステージングされた不変のバイト列は、実行前後に検証されます。
6. ランごとのロックを再取得し、検査を繰り返して、review_recorded の事実をちょうど1件追記します。
7. 再検査を行い、次に導出されたアクションを返します。

レビュアーが返すのは次の内容のみです。

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

pass は lgtm として保存され、changes_requested からは redispatch が導出されます。レビュアーの呼び出しエラーまたは結果エラーは escalated として永続的に記録されます。ランタイムの呼び出しに失敗した場合は、その事実に紐付けた明示的な review の再試行を1回だけ実行できます。2回目の失敗時にはフェイルクローズします。モデルが返したエスカレーションは再試行できません。ラウンド数は、以前の review_recorded の事実から導出されます。自動ループ、レビュー予算、変更可能なラウンド状態、手動での判定適用、分離されたレビュー監督プロセス、PR コメントの権限、ライフサイクルの遷移はありません。

実行と失敗時の動作

• 認証と HOME/XDG 設定は、ユーザーのローカル環境にある CLI の状態です。 Relay は認証情報ファイルをコピーしたり、HOME/XDG を書き換えたり、認証値やソースパスをシリアライズしたりしません。レビュー入力バンドルは別途ステージングされます。
• GitHub 経由のレビュー担当者は --network-access enabled（デフォルト）を使用します。disabled を選択すると、呼び出し前に失敗します。有効なトランスポートでは、レビュー担当者プロセスのネットワークアクセスに制限がなく、プロバイダー専用の分離やツールネットワークの分離は保証されません。ローカルレビューにはフォージのトランスポート要件はありません。
• Relay は、信頼されたローカルホスト上で直接実行されます。利用可能な場合はアダプターのネイティブなファイルシステム分離を要求します。分離がない場合、または宣言のみの場合は、永続しない filesystem_isolation 診断として返され、レビューは拒否されません。
• ステージングされたプロンプト、差分、基準、スキーマ、実行可能ファイルのバインディングは、呼び出し後に再確認されます。変更または不整合がある場合、レビュー事実は生成されません。
• PR ヘッドが古い場合、検証が欠落している場合、アクションが変更されている場合、アダプターがサポートされていない場合、またはレビュー担当者のバインディングが一致しない場合、レビュー事実は書き込まれません。

runner notesとadapter platformを参照してください。