land

land

目的

• PR が main とコンフリクト無しでマージできる状態を保証する
• CI を green に保ち、失敗時は原因を直す
• 全チェックが green になり次第マージする
• マージ完了までユーザーへ制御を返さない。ブロックされない限りウォッチャーループを回し続ける
• マージ後のリモートブランチ削除は不要 (リポジトリ側で head ブランチ自動削除を有効にしている前提)

前提条件

• gh CLI が認証済み
• 対象 PR のブランチをチェックアウト済みでワーキングツリーが clean

手順

1. 現在のブランチに対応する PR を特定する
2. push 前に手元のゲート (lint / test / type check) を全て green にする
3. ワーキングツリーに未コミット変更があれば commit スキルでコミットし、push スキルで push してから次へ進む
4. main に対するマージ可否とコンフリクトを確認する
5. コンフリクトがあれば pull スキルで origin/main を fetch+merge してコンフリクトを解消し、push スキルで更新したブランチを publish する
6. Codex のレビューコメント (あれば) を確認し、必要な修正をマージ前に処理する
7. 全チェックが完了するまでウォッチする
8. チェックが失敗したらログを取って原因を直し、commit スキルでコミット、push スキルで push、再度チェックを回す
9. 全チェックが green かつレビューフィードバックが解消したらマージする (リポジトリ許可 merge method を判定する snippet はコマンド節)
10. コンテキスト確認 — レビューフィードバックを実装する前に、ユーザーの意図やタスク文脈と矛盾しないか確認する。矛盾していたらインラインで根拠を返し、ユーザーに確認してからコードを変える
11. 反対応答テンプレ — 反対する時はインラインで「受領 + 根拠 + 代案」の順に返す
12. 曖昧時ゲート — 曖昧で進めない時は確認フローを回す (PR を現在の GitHub ユーザーへアサインしメンションして返答を待つ)。曖昧さが解けるまで実装しない
    • レビュアーより自分が正しいと確信できる時はユーザー確認なしで進めてよい。その場合もインラインで根拠を返す
13. コメント単位モード — 各レビューコメントを受諾 / 確認 / 反対のいずれかへ分類する。インライン (Codex レビューは issue スレッド) で意図を述べてからコードを変える
14. 変更前に返信 — 必ず意図を返してからコードを push する。インラインレビューコメントはインライン、Codex レビューは issue スレッド

コマンド

# ブランチと PR 文脈を取得
branch=$(git branch --show-current)
pr_number=$(gh pr view --json number -q .number)
pr_title=$(gh pr view --json title -q .title)
pr_body=$(gh pr view --json body -q .body)

# 許可 merge method を判定 (優先順位 squash → マージコミット → rebase)
read -r allow_squash allow_merge allow_rebase <<<"$(gh api repos/{owner}/{repo} \
  --jq '[.allow_squash_merge, .allow_merge_commit, .allow_rebase_merge] | @tsv')"
if   [ "$allow_squash" = "true" ]; then merge_flag="--squash"
elif [ "$allow_merge"  = "true" ]; then merge_flag="--merge"
elif [ "$allow_rebase" = "true" ]; then merge_flag="--rebase"
else echo "no merge method allowed in this repo" >&2; exit 1
fi

# マージ可否とコンフリクトを確認
mergeable=$(gh pr view --json mergeable -q .mergeable)

if [ "$mergeable" = "CONFLICTING" ]; then
  # `pull` スキルで fetch + merge + コンフリクト解消
  # その後 `push` スキルで更新したブランチを publish
  exit 1
fi

# 非同期ウォッチ補助 (後述) を優先する。下の手動ループは Python が動かない時のフォールバック
# レビューフィードバックの到来を待つ。Codex レビューは `## Codex Review — <persona>` で始まる issue コメント
# として届く。レビュアーフィードバックと同じ扱いで `[codex]` issue コメントで受領を返す
while true; do
  gh api repos/{owner}/{repo}/issues/"$pr_number"/comments \
    --jq '.[] | select(.body | startswith("## Codex Review")) | .id' | rg -q '.' \
    && break
  sleep 10
done

# チェックをウォッチする
if ! gh pr checks --watch; then
  gh pr checks
  # 失敗した run を特定してログを見る
  # gh run list --branch "$branch"
  # gh run view <run-id> --log
  exit 1
fi

# 判定した method でマージ (squash の時のみ subject/body を渡す)
if [ "$merge_flag" = "--squash" ]; then
  gh pr merge --squash --subject "$pr_title" --body "$pr_body"
else
  gh pr merge "$merge_flag"
fi