adversarial-review について
Adversarial Review は、成果物を変更せずに統合レビュー判定を作成するスキルです。反対側のモデルの CLI でレビューを実行し、明示された意図とプロジェクトの原則に基づいて評価します。
主な機能
- 01反対側モデルの CLI によるレビュー
- 02変更規模に応じたレビュー視点
- 03原則に基づくレビュー用プロンプト
- 04主担当の判断を含む統合判定
- 05レビュアー出力の確認
活用シーン
- 01マージ前のコード変更の検討
- 02明示された意図に照らした計画のレビュー
- 03懐疑派とアーキテクト双方の視点の取得
- 04不足しているレビュー出力の特定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ poteto/ noodle --skill adversarial-reviewインストール後、Claude Code で/adversarial-reviewを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/reviewer-lenses.mdreviewer-prompt.mdverdict-format.md詳細
敵対的レビュー
反対側のモデルでレビュアーを起動し、作業に異議を唱えさせます。レビュアーは、脳の原則に基づくそれぞれ異なる観点からレビューします。成果物は統合された判定です。変更は加えないでください。
**絶対条件:**レビュアーは、必ず反対側のモデルの CLI(codex exec または
claude -p)を介して実行してください。サブエージェント、Agent ツール、または
内部委任の仕組みをレビュアーとして使わないでください。これらは自分自身のモデルで実行されるため、目的に反します。
ステップ 1 — 原則を読み込む
brain/principles.mdを読みます。すべての[[wikilink]]をたどり、リンク先の原則ファイルをそれぞれ読みます。
これらの原則が、レビュアーの判断基準となります。
ステップ 2 — 範囲と意図を確認する
コンテキスト(最近の差分、参照されている計画、ユーザーメッセージ)から、レビュー対象を特定します。
意図、つまり作成者が何を実現しようとしているかを確認します。これは非常に重要です。レビュアーは、意図の正しさではなく、作業が意図をうまく達成しているかに異議を唱えます。先に意図を明示してください。
変更規模を評価します。
| 規模 | 基準 | レビュアー |
|---|---|---|
| 小 | 50 行未満、1~2 ファイル | 1 名(懐疑論者) |
| 中 | 50~200 行、3~5 ファイル | 2 名(懐疑論者+アーキテクト) |
| 大 | 200 行以上または 5 ファイル以上 | 3 名(懐疑論者+アーキテクト+ミニマリスト) |
レンズの定義については、references/reviewer-lenses.mdを読んでください。
ステップ 3 — モデルを特定し、レビュアーを起動する
レビュアーの出力用に一時ディレクトリを作成します。
REVIEW_DIR=$(mktemp -d /tmp/adversarial-review.XXXXXX)
自分がどのモデルかを特定し、反対側のモデルでレビュアーを起動します。
Claude の場合 — codex execで Codex のレビュアーを起動します。
codex exec --skip-git-repo-check -o "$REVIEW_DIR/skeptic.md" "prompt" 2>/dev/null
レビュアーにテストの実行が必要な場合に限り、--profile editを使用します。既定では読み取り専用にしてください。
run_in_background: trueで実行し、block: true, timeout: 600000を指定したTaskOutputで状況を確認します。
Codex の場合 — claude CLI で Claude のレビュアーを起動します。
claude -p "prompt" > "$REVIEW_DIR/skeptic.md" 2>/dev/null
run_in_background: trueで実行します。
各出力ファイルには、レンズ名を付けます。skeptic.md、architect.md、minimalist.mdとします。
references/reviewer-prompt.mdのテンプレートを使って、各レビュアーへのプロンプトを作成します。
ステップ 4 — 確認して判定を統合する
レビュアーの出力を読む前に、使用した CLI を記録し、出力ファイルが存在することを確認します。
echo "reviewer_cli=codex|claude"
ls "$REVIEW_DIR"/*.md
出力ファイルが存在しない、または空の場合は、その失敗を判定に記載してください。レビュアーを黙って省略してはいけません。
$REVIEW_DIR/から各レビュアーの出力ファイルを読み込みます。重複する指摘を統合します。
references/verdict-format.mdの形式に従って、単一の判定を作成します。
ステップ 5 — 判断を示す
レビュアーの意見を統合した後、自分自身の判断を加えます。明示した意図と脳の原則を基準に、どの指摘を受け入れ、どの指摘を退けるか、またその理由を述べます。レビュアーは意図的に敵対的な役割を担っています。すべての指摘に対応する必要はありません。誤検知、行き過ぎ、実質ではなくスタイルを問題にしている指摘を明示してください。
判定に「リードの判断」セクションを追加します(references/verdict-format.mdを参照)。