adversarial-review reference

adversarial-review は、現在の branch または PR に ship を止めるべき問題がないか、指定した local AI Agent に確認させる read-only review である。 通常の改善提案や好みの指摘を集めたい場合ではなく、公開前に material finding だけを別の視点で探したい場合に使う。

使いどころ

  • 現在 branch の差分を公開前に厳しく確認したい
  • PR の変更に重大な見落としがないか、指定した reviewer で確認したい
  • 指摘の修正や再レビューは別の workflow で行い、この実行ではレビューだけ受け取りたい

まず何が起きるか

  1. PR 番号、PR URL、または現在 branch から対象を決める。
  2. base= があれば diff の起点に使い、指定した local reviewer へ read-only で渡す。
  3. reviewer は changed file の path と line を示せる material finding だけを返す。
  4. 呼び出し元は finding の有無、reviewer を開始できなかった理由、次に必要な対応を確認する。

この skill はファイルを編集せず、commit、push、PR コメント、thread 操作も行わない。

Options

引数 意味
agent=codex Codex reviewer を使う
agent=claude Claude reviewer を使う
agent=copilot GitHub Copilot CLI reviewer を使う
base=branch diff の起点 branch を指定する
PR番号 / PR URL PR context を reviewer に渡す

agent= を省略した場合の既定値は実行 runtime と policy に従う。 agent=copilot は local の GitHub Copilot CLI を指し、GitHub 上の Copilot reviewer ではない。

結果の読み方

  • finding がない: 対象差分について、ship を止める material finding は報告されなかった。
  • finding がある: path、line、重大度、理由、最小修正案を確認し、実装 workflow へ戻して採否を決める。
  • reviewer を開始できない: CLI 不在、許可不足、認証不備、対象解決失敗などの blocker を解消して再実行する。
  • timeout や出力不備: finding なしには数えず、失敗した reviewer と理由を残して停止する。

review attempt の完了は merge-ready や PR-ready を意味しない。 finding の修正、検証、再レビューは multi-review または呼び出し元 workflow で行う。

停止後の対応

material finding が返った場合、この skill は修正せず停止する。 妥当な finding は実装側で修正して必要な検証を行い、誤検出や scope 外の指摘は理由を記録する。

reviewer の起動に失敗した場合は、指定した agent= を別 runtime へ黙って変更しない。 利用可能な transport と許可を確認し、同じ reviewer で再実行するか、reviewer 変更を利用者が明示する。

このページは生成物です。原本は元リポジトリ側にあります。