mcpField
A
adversarial-review

adversarial-review

github.com/potetoテスト・品質5641.5k 回インストール32 週間前に更新
リポジトリ

adversarial-review について

Adversarial Review は、成果物を変更せずに統合レビュー判定を作成するスキルです。反対側のモデルの CLI でレビューを実行し、明示された意図とプロジェクトの原則に基づいて評価します。

主な機能

  1. 01反対側モデルの CLI によるレビュー
  2. 02変更規模に応じたレビュー視点
  3. 03原則に基づくレビュー用プロンプト
  4. 04主担当の判断を含む統合判定
  5. 05レビュアー出力の確認

活用シーン

  1. 01マージ前のコード変更の検討
  2. 02明示された意図に照らした計画のレビュー
  3. 03懐疑派とアーキテクト双方の視点の取得
  4. 04不足しているレビュー出力の特定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/poteto/noodle --skill adversarial-review

インストール後、Claude Code で/adversarial-reviewを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
reviewer-lenses.md
reviewer-prompt.md
verdict-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を参照)。

コメント