range-review

範囲レビュー: git 範囲「$ARGUMENTS」に含まれる全 PR の diff を 1 つの単位として、3 視点の読み取り専用 agent で並列レビューし、finding をオーガナイザーが一次ソースで再現してから disposition 案を出す。

このスキルは複数 PR のウェーブ（1 リリース分、または 1 セッション分）が main にマージされた直後に呼び出すことを想定している。per-PR レビューは「その PR 単独で正しいか」しか見ず、同じ範囲の複数 PR が同じ関数・同じ概念を触った結果の相互作用や、複数 PR を跨いで初めて実態と食い違う公開契約の文言は素通りする。本コマンドは issue も PR も作らない。案を出すところで止め、実行はオーガナイザーがユーザー確認のうえ行う。

引数

• <from>..<to> の git 範囲（例: c4453812..3ac089e1）
• 省略時の既定は「1 つ前の release commit → HEAD」。次で求める:

git log --grep='chore(main): release' -2 --format='%h %s'

出力の 2 行目（1 つ前の release）を <from>、HEAD を <to> にする。HEAD 自体が release commit なら、そのリリースに含まれた PR 群をレビューすることになる（1 行目が HEAD と一致する場合も 2 行目を <from> にすればよい）。release commit が 1 件しか無い場合はユーザーに範囲を明示するよう求めて終了する。

手順

Step 1. 範囲の確定と要約

git log --oneline <from>..<to>
git diff --stat <from>..<to>
git log --format='%s' <from>..<to> | grep -oE '\(#[0-9]+\)$' | tr -d '(#)' | sort -n | uniq

• 1 つ目が空なら「範囲が空」と報告して終了する
• 3 つ目で PR 番号を列挙する。squash merge の subject 末尾 (#N) から取るため、それ以外の形式の commit は git log の目視で補う
• 列挙した PR ごとに gh pr view <N> --json title,body --jq '.title' で題名を控える。Step 2 のプロンプトに PR 番号と題名の一覧、git diff --stat の出力、範囲文字列をそのまま貼る

Step 2. 3 視点の並列レビュー

Agent ツールで 3 本を 1 メッセージで同時に起動する。subagent_type: general-purpose、全て読み取り専用の指示で走らせる。各 agent に渡すプロンプトは、下の「共通規律」ブロックの後ろに視点別ブロックを 1 つ足したものである。共通規律は 3 本とも省略せず全文入れる。

3 本が同時に立ち上がらないとき: Codex CLI で直列に回す

並列起動は失敗する日がある。2026-09-04 から 09-08 までの 5 日連続で、メモリ逼迫による background task の kill とレート上限がログに残っている。視点を減らして 2 本で済ませてはならない（後掲「禁止事項」）。並列が通らないなら、同じプロンプトを Codex CLI へ渡して 1 本ずつ直列に回す。

準備は 1 回だけ行う。作業ツリーは全視点で共有してよい（読み取り専用のため）。

R=$(mktemp -d) && echo "$R" > /tmp/rr-base.txt
git worktree add --detach "$R/wt" <to>
# 共通規律を 1 ファイルに置き、視点別ブロックを後ろへ結合する
cat > "$R/common.txt" <<'EOF'
<共通規律の全文>
EOF
cat "$R/common.txt" "$R/pa-body.txt" > "$R/pa.txt"

各視点はこの形で起動する。--sandbox workspace-write は変異注入（規律 3）に要る。

export PATH=/opt/homebrew/opt/node@22/bin:$PATH
codex exec -C "$R/wt" --sandbox workspace-write --skip-git-repo-check - < "$R/pa.txt" > "$R/out-a.md" 2> "$R/err-a.log"