| name | babysit-pr | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| maturity | stable | ||||||||||||
| description | PRのCI/レビュー完了までを自動監視。DIRTY→自動コンフリクト解決、CI通過+レビュー完了→verify (local)→マージ(またはマージ可能報告)。デフォルトはマージせず報告して停止。--merge で自動マージを有効化。 | ||||||||||||
| user-invocable | true | ||||||||||||
| argument-hint | PR番号 [--merge|--no-merge] | ||||||||||||
| allowed-tools |
|
||||||||||||
| hooks |
|
PR のCI完了→レビュー完了までを自動監視する。
{ARGUMENTS} を解析し、PR番号とマージモードを決定する:
{ARGUMENTS}に--mergeが含まれる → merge モード(CI通過+レビュー完了後に自動マージ){ARGUMENTS}に--no-mergeが含まれる → no-merge モード(マージせず報告して停止)- 両方含まれる → no-merge モード(安全側に倒す)
- どちらも含まれない → 必ず
printenv CLAUDE_SKILL_BABYSIT_PR_AUTO_MERGEを Bash ツールで実行し、その出力で判定する(未設定時は exit code 1 だが正常動作。推測で省略してはならない):- 出力が
1(完全一致のみ。true,yes,TRUE等は no-merge 扱い) → merge モード - それ以外(未設定・空・
0等) → no-merge モード
- 出力が
PR番号は {ARGUMENTS} から --merge / --no-merge を除いた数値部分。以降の手順では PR_NUM として参照する。
以降の手順では、解決済みのマージモードを MERGE_MODE(merge または no-merge)として参照する。
babysit-pr は PR のブランチに対応する既存の feature worktree を使って作業する。一時 worktree の作成・削除は行わない。
マージモード決定後、/loop 開始前に以下を実行する:
gh pr view {PR_NUM} --json headRefName -q .headRefNameでブランチ名を取得git worktree listで headRefName に対応する worktree を探す- 見つかった場合 → そのパスを WORKTREE_PATH とする
- 見つからない場合 →
/worktree-add {headRefName} origin/{headRefName}で作成し、そのパスを WORKTREE_PATH とする。worktree-add 完了後、停止せず直ちに CWD の移動と /loop の開始に進むこと(worktree-add の結果報告は中間成果であり、babysit-pr のフローはまだ続く)
検出後、cd {WORKTREE_PATH} で CWD を feature worktree に移動する。以降の全操作は feature worktree 内で行う。
feature worktree でファイル修正を行う前に、リモートの最新状態と同期する:
git fetch origin {headRefName}
git reset --hard origin/{headRefName}- 停止: CronDelete でジョブを削除し、ユーザーに報告する。feature worktree は削除しない(ユーザーが後続作業や調査に使う可能性があるため)
- 完了停止: 停止に加え、CWD をメインリポジトリに復帰(独立した Bash 呼び出しで
cd <メインリポジトリ>)してから feature worktree をgit worktree remove {WORKTREE_PATH}で削除し、git pullする。MERGED / CLOSED 時にのみ使用
マージモードセクションに従い PR_NUM と MERGE_MODE を決定し、Feature worktree セクションに従い WORKTREE_PATH を検出して CWD を移動した上で、以下のプロンプト内の {PR_NUM} を実際の PR 番号(数値)に置き換えて /loop 1m を開始する。
polling cadence は 1 分固定: /loop 1m(cron mode、毎分)を必ず使うこと。tick 中に「cron が積み重なって複数 tick が並列実行されそう」「state 欄が tick を跨いで永続化されない」等の挙動を観測しても、CronDelete で cron を止めて ScheduleWakeup の長い interval(5 分等)に切り替える workaround を取ってはならない。CI 完了待ちは 1 分単位の short polling が原則。並列実行や state 永続化の問題が再現する場合は別途 issue を作成し、本フローは 1 分 polling のまま運用する。
以下の bot を AI レビュアーとして扱う。手順 6-0 および 9 はこの一覧を参照する:
copilot-pull-request-reviewergemini-code-assistcoderabbitaichatgpt-codex-connectorqodo-code-review
[bot] サフィックスの正規化: GitHub API の user.login は copilot-pull-request-reviewer[bot] のように [bot] 付きで返される。比較時は [bot] サフィックスを除去してから上記一覧とマッチングする。
PR #{PR_NUM} を監視(MERGE_MODE は決定済み):
-
gh pr view {PR_NUM} --json baseRefName,state,mergeStateStatus,headRefOid,statusCheckRollup,reviewDecision,reviews,reviewRequests,isDraftでステータス取得 1a. 早期品質ゲート(CI 状態に依存せず投機的に実行。1a-0 comment-sweep → 1a-a〜d debate-review の順。debate-review skill は同 tick 内で blocking 完了するが、その間も GitHub 側の CI は並行進行するため wall-clock を短縮できる。CI 失敗時は debate-review の外部 AI コスト(Codex/Gemini/Cursor)が無駄打ちになる trade-off あり): 0. comment-sweep(コメント規約違反を debate-review より先に検出・修正し、レビュー noise と無駄な再 push を減らす):- skip 条件: 以下のいずれかに該当する場合、comment-sweep は実行せず 1a-a へ進む:
- state が MERGED または CLOSED(手順 2 で処理)
- mergeStateStatus が DIRTY(手順 4 のコンフリクト解決を先に行う)
- isDraft == true(Draft はマージ対象外)
- conversation history に
BABYSIT_HIST: comment-sweep 完了 (PR #<PR_NUM>, headRefOid: <SHA>, 違反なし)の 1 行(<SHA>は現在のheadRefOid(手順 1 で取得済み)、行頭プレフィックス込みの完成形)を残した自分自身のメッセージがある(詳細は後述「実行履歴の判定」セクション)
- 実行: feature worktree を同期(
git fetch origin {headRefName} {baseRefName}→git reset --hard origin/{headRefName})し、/comment-sweep {baseRefName}を実行する(headRefNameはgh pr view {PR_NUM} --json headRefName -q .headRefName、baseRefNameは手順 1 で取得済み。comment-sweep は引数をorigin/<引数>として解決するためorigin/プレフィックスは付けない)。babysit-pr からの呼び出しでは comment-sweep の承認ステップ(違反テーブル提示後の確認)を待たず、検出した違反を自律的に修正する - 結果判定:
- 違反を検出し修正した → comment-sweep が修正を commit 済みのため push(
git push origin {headRefName} --force-with-lease)。push 成功時のみ手順 1 に戻る(新 headRefOid で再評価)。push 失敗時はユーザーに報告して停止(手順 4f と同型。未 push の修正コミットが次 tick のgit reset --hard origin/{headRefName}で破棄され同一修正を繰り返す silent loop を防ぐため)。「comment-sweep 完了」は記録しない(push 失敗時に未 sweep の head を skip しないため。push 成功時は新 head に対し次 tick で再 sweep される) - 違反なし → 自分のメッセージの行頭から
BABYSIT_HIST: comment-sweep 完了 (PR #<PR_NUM>, headRefOid: <SHA>, 違反なし)の 1 行(プレフィックス込み完成形)を独立した行として記録し、1a-a へ進む - 修正不能(規範解釈が曖昧で機械的に直せない)→ ユーザーに報告して停止 a. skip 条件: 以下のいずれかに該当する場合、debate-review は実行せず手順 2 へ進む:
- 違反を検出し修正した → comment-sweep が修正を commit 済みのため push(
- state が MERGED または CLOSED(手順 2 で処理)
- mergeStateStatus が DIRTY(手順 4 のコンフリクト解決を先に行う。merge base が動いた状態で debate-review しても再 push 後に再実行になる)
- isDraft == true(Draft はマージ対象外)
- conversation history に
BABYSIT_HIST: debate-review 完了 (PR #<PR_NUM>, headRefOid: <SHA>)の 1 行(<SHA>は現在のheadRefOid(手順 1 で取得済み)、行頭プレフィックス込みの完成形)を残した自分自身のメッセージがある(詳細は後述「実行履歴の判定」セクション) b. 実行:/debate-review {PR_NUM}を実行し、結果を確認。完了直後、自分のメッセージの行頭からBABYSIT_HIST: debate-review 完了 (PR #<PR_NUM>, headRefOid: <SHA>)の 1 行(プレフィックス込み完成形)を独立した行として記録する c. findings 判定(手順 6c と同じロジック。🔧/📋 を先に分離し、🔧 のみ severity で判定): - critical を含む(🔧/📋 問わず) → ユーザーに報告して停止
- high / medium / low 🔧 を含む → 手順 6c-i の修正フロー(feature worktree 同期 → 修正 → push)を実行し、手順 1 に戻る(新 headRefOid で再評価)。ただし 1a から呼び出した場合、6c-i.3 の no-op 経路は 6d ではなく手順 2 へ進む(1a は CI 進行中も実行されるため、6d / 6e に到達すると「CI全通過」が前提の verify / マージ判定を CI 通過前に走らせる contract violation になる。同じく 6c-ii 実行後も 6d ではなく手順 2 へ)
- 📋(pre-existing)のみ → 手順 6c-ii の 📋 処理(PR コメント + タスク登録)を実行し、手順 2 へ進む。ただし 1a が同 PR で複数回キックされる場合(CI 失敗修正後の新 head 等)、同セッションで既に登録済みの 📋 finding を再登録しないこと(PR コメント・タスクの重複防止)
- findings なし → 手順 2 へ進む
- 🔧 と 📋 の混合: 🔧 の修正フロー優先 → 手順 1 に戻る(新 headRefOid で再評価)→ 次ループの新 head 上で debate-review が再評価される(4 AI の独立性により、前回の 📋 findings が必ず再現するとは限らない。前回の 📋 を carry forward する機構は本 SKILL.md にないため、新 debate-review に出ない 📋 は silent skip されうる点に注意)
d. CI 通過後の手順 6 では conversation history の
BABYSIT_HIST: debate-review 完了 (PR #<PR_NUM>, headRefOid: <SHA>)完成形(<SHA>は現在のheadRefOidで置換、whole-line 完全一致、6a と同じ判定)一致により 6a/6b/6c を skip して 6d(verify)→ 6e(マージ判定)に直接進む
- skip 条件: 以下のいずれかに該当する場合、comment-sweep は実行せず 1a-a へ進む:
-
state が MERGED or CLOSED → CLOSED の場合は結果報告して完了停止。MERGED の場合: a.
gh pr view {PR_NUM} --json mergeCommit -q .mergeCommit.oidでマージコミット SHA を取得。null / 空の場合は次の tick まで待機(5回連続で取得できない場合はユーザーに報告して停止) b. マージコミットの CI ステータスを取得(check runs と commit statuses の両方を確認):gh api repos/{owner}/{repo}/commits/{sha}/check-runs --paginateで check runs を全件取得gh api repos/{owner}/{repo}/commits/{sha}/statusで commit statuses を取得(statuses配列の各 context 最新stateで判定) c. check runs と statuses が両方とも 0 件 → 次の tick まで待機(5回連続で 0 件の場合は CI 未設定とみなし 2f へ進む) d. いずれかが未完了(check run のstatusがqueued/in_progress、または status のstateがpending)→ 次の tick まで待機。ただし GitHub Actions の check run がstartedAtから30分以上in_progressのままの場合はサブステップ 2d-i へ(外部 CI のpendingはこの対処の対象外) d-i. ハング疑い時の検証(3段階):statusCheckRollupやgh run view --jsonは stale な値を返すことがあるため、check run のdetails_urlから workflow run ID を抽出し、以下の順で確認する:
gh api repos/{owner}/{repo}/actions/runs/<run-id>で run レベルのステータスを確認。statusがcompletedなら stale であり、conclusionを正として判定に戻る(cancel/rerun は不要)- run レベルが
in_progressの場合、gh api repos/{owner}/{repo}/actions/runs/<run-id>/jobsでジョブのステップ進捗を確認。ステップが前回の tick から進んでいれば実行中であり、cancel せず次の tick まで待機 - ステップが進んでいない(またはステップ情報がない)場合のみ、真のハングと判定して d-ii へ
d-ii. ハング CI の cancel/rerun: d-i で真のハングと判定された場合のみ実行。
gh run cancel <run-id>でキャンセル → 次 tick でcompletedを確認後gh run rerun <run-id>で再実行(gh api -X POSTではなくgh runサブコマンドを使うこと。permissions.allow で自動承認される)。同一 run に対する cancel/rerun は 1回のみ。再実行後もハングが続く場合はユーザーに報告して停止 e. 失敗判定: check run のconclusionがsuccess/skipped/neutral以外(failure,cancelled,timed_out,action_required,stale等)、または status のstateがfailure/error→ 失敗チェック名(とdetails_urlがあれば URL も)を報告して停止 f. 全て成功系(または CI 未設定): /verify {PR_NUM} --mode=deploy --autoを実行する(CI 未設定でも必ず実行すること)- verify が exit 0 で正常終了し、以下のいずれかに該当する場合 → 完了停止する(判定は上から順に最優先のものを採用する)
- [最優先] 機械判定タグ: 出力に行頭から
VERIFY_REPORT: <PR番号> <mode>で始まる行がある → 検証完了 - [最優先] 機械判定タグ: 出力に行全体が
VERIFY_SKIP: auto-guardと完全一致する行がある(verify SKILL.md の「厳密なフォーマット」に従い、行頭・行末とも余計な文字・空白なし)→ opt-out 扱いで silent skip(CLAUDE_SKILL_VERIFY_AUTO=1未設定、default-off)。「post-merge verify はスキップ(opt-out)」とのみ報告し、「手動確認が必要」の警告は出さない - [最優先] 機械判定タグ: 出力に行全体が
VERIFY_SKIP: <理由>の形式に一致する行があり、かつ<理由>がauto-guard以外である(<理由>は verify SKILL.md の理由表に定義された識別子:url-unresolved/mode-missing/pr-missing/pr-not-merged等。同じく行頭・行末とも余計な文字・空白なし)→ 前提条件不足による skip。「verify 未実施のため手動確認が必要」と報告に含める - 機械判定タグの契約: 説明文・サンプル・補足中に同じ文字列が含まれていても、行頭から
VERIFY_REPORT:/VERIFY_SKIP:で始まる行以外は機械判定タグとして扱わない(verify SKILL.md 側で「行頭から開始・1回のみ・相互排他」の出力契約が明記されている) - [バックアップ] フレーズ・見出し検出(機械判定タグの行が見つからない場合のみ適用。verify 側がタグを出し忘れた場合の保険):
- 出力に検証結果レポート(「検証結果」「検証項目」等の見出し + 項目別 ✅ / ❌ /
⚠️ マーク)が含まれる → 検証完了 - 出力に verify 側の「案内して終了」フレーズ(「検証を行う場合は...を実行してください」等。verify SKILL.md
--auto ガードセクションのskip の契約参照)が含まれる → skip(理由識別不能のため安全側で「手動確認が必要」扱い。auto-guard の silent skip 分岐は機械判定タグ経路のみ有効)
- 出力に検証結果レポート(「検証結果」「検証項目」等の見出し + 項目別 ✅ / ❌ /
- [最優先] 機械判定タグ: 出力に行頭から
- 以下のいずれかに該当する場合 → 完了停止してはならない。「verify 実行不能のため手動確認が必要」と報告して停止する(安全側に倒す)
- verify が exit 0 以外で終了した(異常終了)
- 応答不能(コンテキスト上限、MCP 接続失敗、例外で中断等)
- exit 0 だが機械判定タグ・フレーズ・見出しのいずれも観測できない(skip/検証完了/実行不能の判別不能)
- CI success はデプロイ反映を保証しないため、
auto-guard以外の skip・実行不能時は必ず手動確認の警告を報告に残すこと(auto-guardはユーザー opt-out(default-off)のため警告対象外)
-
mergeStateStatus が BEHIND → 何もしない(マージ条件が整うまで待機。手順6で必要に応じて更新する)
-
mergeStateStatus が DIRTY → 自動コンフリクト解決を試みる: a.
gh pr view {PR_NUM} --json headRefName,baseRefNameでブランチ名を取得 b.git fetch origin {headRefName} {baseRefName}で最新のリモート情報を取得 c. 方式選択: PR のコミット数とファイル種別で判断する- コミット数を取得:
git rev-list --count origin/{baseRefName}..origin/{headRefName} - 複数コミットの場合、重複変更ファイルを検出:
git log --format= --name-only origin/{baseRefName}..origin/{headRefName} | sort | uniq -d - 重複ファイルにドキュメント/設定ファイルが含まれるか判定: 出力に対して
grep -E '\.(md|json|toml|yaml|yml|nix)$'を適用
- 単一コミット → rebase 方式
- 複数コミットで重複ファイルにドキュメント/設定ファイルを含む → squash 再適用方式
- 複数コミットで重複ファイルがコードファイルのみ、または重複なし → rebase 方式。ただし同一ファイルで2回目のコンフリクトが発生したら
git rebase --abortし、squash 再適用方式へ fallback d. rebase 方式:
- feature worktree を同期:
git reset --hard origin/{headRefName} git rebase origin/{baseRefName}を実行- コンフリクト解決の注意: rebase 時のコンフリクトでは、HEAD 側の変更が base ブランチの内容に相当する。「HEAD 側を採用」すると PR の変更が失われるため注意
- ファイル種別ごとの解決方針:
- ドキュメント/設定ファイル (
.md,.json,.toml,.yaml,.yml,.nix等): base ブランチの構造をベースとし、PR の変更意図を統合する。ドキュメントの変更は通常 additive なので一方を丸ごと捨てず両方の内容を統合する - コードファイル: 両方の変更意図を理解し、意味的正確性を優先して解決する
- ドキュメント/設定ファイル (
- 競合を解消したら
git add <resolved-files>→git rebase --continueで再開する(競合が続く限り繰り返す) - 解決不能(意図が不明、大規模な構造変更等)→
git rebase --abortし、ユーザーに報告して停止 e. squash 再適用方式(複数コミットが同一ファイルを段階的に変更し、rebase で繰り返しコンフリクトする場合に有効): gh pr diff {PR_NUM}で PR の最終差分を取得し、変更意図を把握する- feature worktree を base ブランチにリセット:
git reset --hard origin/{baseRefName} - base ブランチのファイルをベースに、PR の変更意図を手動で適用する。コードファイルは
git diff origin/{baseRefName}..origin/{headRefName} -- <path>で各ファイルの差分を確認しながら編集。設定ファイルはgit show origin/{headRefName}:<path>で最終状態を参照し、base との差分を統合する - 適用後
git add .→git commitを実行する。コミットメッセージはgh pr view {PR_NUM} --json title -q .titleを参照する - 解決不能 → ユーザーに報告して停止
f. push:
git push origin {headRefName} --force-with-lease。失敗時はユーザーに報告して停止 g. 手順1に戻って全条件を再評価
- コミット数を取得:
-
CI失敗(statusCheckRollup に FAILURE/ERROR あり) → 失敗チェック名を報告して停止 5a. CI実行中(statusCheckRollup に
in_progress/queued/pendingあり)→ 次の tick まで待機。ただし GitHub Actions の check run がstartedAtから30分以上in_progressのままの場合、check run のdetailsUrlから workflow run ID を抽出し、手順 2d-i の3段階検証(run ステータス → ジョブステップ進捗 → 真のハング判定)を適用する 5b. mergeStateStatus が BLOCKED(かつ CI 失敗・実行中でない場合にここに到達)→ 手順8(マージ要件の診断と解決)へ。手順8 内で CI 状態も含めた統合的な原因診断を行う -
CI全通過(statusCheckRollup が全て SUCCESS、または CI 未設定で空)かつ mergeStateStatus が BLOCKED でない → mark-viewed → レビュー確認 → debate-review ゲート → verify → マージ判定(手順8g からも参照される): -1. 自動生成ファイルの Viewed マーク(head SHA 変更時のみ実行): i. conversation history を遡り
BABYSIT_HIST: mark-viewed 開始 (PR #<PR_NUM>, headRefOid: <SHA>)の 1 行(<SHA>は現在のheadRefOid、行頭プレフィックス込みの完成形)を残した自分自身のメッセージを探す。見つかれば 6-0 へスキップ(詳細は後述「実行履歴の判定」セクション) ii. 自分のメッセージの行頭からBABYSIT_HIST: mark-viewed 開始 (PR #<PR_NUM>, headRefOid: <SHA>)の 1 行(プレフィックス込み完成形)を独立した行として記録する(以降のスキップ時も次回ループで再実行しないため、本体実行前に記録する) iii. プロジェクト CLAUDE.md から## Mark Viewed Patternsセクションを探す。セクションが存在しない、またはパターンが空の場合は 6-0 へスキップ iv.gh api repos/{owner}/{repo}/pulls/{PR_NUM}/files --paginate -q '.[].filename'で PR のファイル一覧を取得(gh pr view --json filesは 100 ファイル上限があるため REST API を使用) v. 各ファイルパスを Mark Viewed Patterns のグロブパターンと照合し、マッチするファイルを抽出 vi. マッチしたファイルがなければ 6-0 へスキップ vii.gh pr view {PR_NUM} --json id -q .idで PR の GraphQL Node ID を取得 viii. マッチした各ファイルに対してmarkFileAsViewedmutation を実行(GraphQL variables でパスを安全に渡す):gh api graphql -F id="<node-id>" -F path="<file-path>" -f query=' mutation($id: ID!, $path: String!) { markFileAsViewed(input: {pullRequestId: $id, path: $path}) { clientMutationId } }'ix. エラーが発生しても停止せず、6-0 へ進む(Viewed マークは補助機能であり、失敗がワークフローを阻害してはならない) 0. レビューコメント確認(mergeStateStatus が BLOCKED でなくても実行。BLOCKED 時の手順9 とは独立): i.gh api repos/{owner}/{repo}/pulls/{PR_NUM}/reviews --paginateでレビュー一覧を取得 ii.gh api repos/{owner}/{repo}/pulls/{PR_NUM}/comments --paginateでインラインコメント(diff 行に紐づくコメント)一覧を取得 ii-b.gh api repos/{owner}/{repo}/issues/{PR_NUM}/comments --paginateで issue コメント(総評・追加指摘等)一覧を取得。AI レビュアー bot のコメントのみ対象とする iii. 「AI レビュアー bot 一覧」セクションの bot のCHANGES_REQUESTEDまたはCOMMENTEDレビューを抽出(user.loginから[bot]サフィックスを除去して一覧とマッチング)。インラインコメントも同じ bot に限定し、pull_request_review_idで iii で抽出したレビューに紐づくもののみ対象とする。issue コメント(ii-b)も同じ bot に限定する iv. レビュー本文 + インラインコメント + issue コメント本文を統合して確認し、正当な指摘(バグ、セキュリティ、ロジックエラー等)があれば修正フロー(手順 6c-i と同様に feature worktree で同期→修正→push)を実施し、手順1に戻る v. 誤検知・スタイル提案のみの場合はスキップして 6a へ進む vi. レビュー・インラインコメント・issue コメントがいずれもない場合はそのまま 6a へ vii. 再評価時の重複防止: 修正 push 後に手順1から再評価すると、AI レビュアーが再レビュー前に同じCOMMENTEDレビューが残る。レビューのcommit_idが現在のheadRefOidと一致しない場合(commit_idが null の場合も不一致扱い)は旧コミットへのレビューであり、スキップして 6a へ進む。インラインコメントも同様にcommit_idが null またはheadRefOidと不一致ならスキップ。issue コメントはcommit_idを持たないため、created_atが現在のheadRefOidの push 時刻より前のものはスキップする(push 時刻はgh api repos/{owner}/{repo}/commits/{headRefOid} --jq .commit.committer.dateで取得) a. conversation history を遡りBABYSIT_HIST: debate-review 完了 (PR #<PR_NUM>, headRefOid: <SHA>)の 1 行(<SHA>は現在のheadRefOid(手順1で取得済み)、行頭プレフィックス込みの完成形)を残した自分自身のメッセージを探す。見つかれば debate-review の再実行を省略し 6d(verify)から続行。見つからなければ 6b へ進む(6b が完了を記録する)⚠️ debate-review の要否判定は、conversation history の「BABYSIT_HIST: debate-review 完了 (PR #<PR_NUM>, headRefOid: <SHA>)記録(行頭プレフィックス込みの完成形)」が現在のheadRefOidと一致するかで行う。conversation history が圧縮等で消失して確認できない場合は安全側で再実行する。変更規模・種類による省略(「軽微な変更だから」等)は禁止 b./debate-review {PR_NUM}を実行し、結果を確認。完了直後、自分のメッセージの行頭からBABYSIT_HIST: debate-review 完了 (PR #<PR_NUM>, headRefOid: <SHA>)の 1 行(プレフィックス込み完成形)を独立した行として記録する c. findings の判定(🔧/📋 を先に分離し、🔧 のみ severity で判定。混合時は 🔧 側の分岐を優先し、📋 は別途処理):- critical を含む(🔧/📋 問わず) → ユーザーに報告して停止
- high / medium / low 🔧 を含む → 修正フロー(6c-i)へ
- 📋(pre-existing)のみ → 📋 処理(6c-ii)を実行し 6d へ。ただし 1a / 6c が同 PR で複数回キックされる場合(CI 失敗修正後の新 head 等)、重複登録を best-effort で防ぐこと(重複判定の手順: 6c-ii の 1 で
gh pr commentを発行する前にgh api repos/{owner}/{repo}/issues/{PR_NUM}/comments --paginateで既存コメントを取得し、自分が過去に投稿した 📋 finding 本文と同じテキストブロックが含まれる場合は 1 を skip。タスク管理ツール側でも同じタイトルの open task が存在する場合は新規作成を skip) - findings なし → 6d へ
- 🔧 と 📋 の混合時: 🔧 の修正フロー → 手順1に戻って再評価 → 次ループの新 head 上で debate-review が再評価される(4 AI の独立性により、前回の 📋 findings が必ず再現するとは限らない。前回の 📋 を carry forward する機構は本 SKILL.md にないため、新 debate-review に出ない 📋 は silent skip されうる点に注意)
c-i. 修正フロー:
gh pr view {PR_NUM} --json headRefName -q .headRefNameでブランチ名を取得し:
- feature worktree を同期:
git fetch origin {headRefName}→git reset --hard origin/{headRefName} - feature worktree 内で修正を実施し、コミット・push(
git push origin {headRefName} --force-with-lease)。push 失敗時はユーザーに報告して停止(手順 4f と同型。未 push の修正コミットが次 tick のgit reset --hard origin/{headRefName}で破棄され同一修正を繰り返す silent loop を防ぐため) - 修正不能/意図不明 → ユーザーに報告して停止。差分なし(no-op)→ 未解決の 🔧 findings を
gh pr commentで共有し、📋 がある場合はさらに 6c-ii を実行してから 6d へ(ただし 1a から呼ばれた場合は、6d ではなく手順 2 へ進む。1a-c の override 参照) - push 成功時のみ手順1に戻って再評価(CI 再実行のため。push 失敗時は手順 2 で既に停止しているため本ステップは到達しない) c-ii. 📋 処理(pre-existing findings のタスク登録):
- 📋 findings を
gh pr commentで PR にコメント - 各 finding をプロジェクトのタスク管理ツール(GitHub Issues、Linear 等)に登録
- 作成したタスクのリンクを PR コメントに追記 d. verify (local)(スキップ厳禁: マージ前の動作検証として必ず実行すること):
- feature worktree を同期:
git fetch origin {headRefName}→git reset --hard origin/{headRefName}(headRefName はgh pr view {PR_NUM} --json headRefName -q .headRefNameで取得) /verify {PR_NUM} --mode=localを実行する(--autoは付けない。babysit-pr からの呼び出しでもCLAUDE_SKILL_VERIFY_AUTOガードなしで直接実行する)- verify が失敗した場合はユーザーに報告して停止 e. MERGE_MODE で分岐:
- no-merge: PR URL、head SHA (
{headRefOid})、手動マージコマンド (gh pr merge {PR_NUM} --squash) を含むサマリーを報告して停止 - merge:
gh pr merge {PR_NUM} --squash --match-head-commit {headRefOid}でマージを試行(CAS ガード: debate-review 済みのコミットと一致しない場合は失敗する)。成功 → CronDelete せずに手順 2a へ進む(マージコミット CI 確認 → verify(手順 2f)→ 停止。2a〜2d の待機は従来どおり次の tick へ持ち越してよい)。失敗 → 手順6f へ f. マージ失敗時のリトライ(楽観的並行制御、merge モード時のみ):
gh pr view {PR_NUM} --json mergeStateStatusで最新の mergeStateStatus を再取得する- 再取得した mergeStateStatus で分岐:
- BEHIND(他の PR がマージされた)→
gh pr update-branch {PR_NUM}でブランチ更新 → 手順1に戻って CI 再実行待ち - DIRTY → 手順4のコンフリクト解決フローへ
- その他 → 手順8へ(ルール確認から原因を切り分け)
- BEHIND(他の PR がマージされた)→
-
AIレビュアー固有ルール:
gh pr view --json reviewRequestsはボットレビュアーを返さないことがあるため、pending レビュアーの確認には REST API を使う:gh api repos/{owner}/{repo}/pulls/{PR_NUM}/requested_reviewers(.users[].loginと.teams[].slugを確認)copilot-pull-request-reviewer[bot]がエラー →gh api /repos/{owner}/{repo}/pulls/{PR_NUM}/requested_reviewers -X POST -f 'reviewers[]=copilot-pull-request-reviewer[bot]'でレビュー再リクエスト- copilot/gemini のタイムアウト判定: REST API で requested_reviewers に残っていることを確認し、初回検出からの経過時間を監視ループ側で追跡。20分超過ならタイムアウトとみなしスキップ
- CodeRabbit が rate limit メッセージを出している → 次のtickまで待機
- その他のAIレビュアーエラーは状況を見て判断
-
mergeStateStatus が BLOCKED → マージ要件の診断と解決: a. GraphQL 一括クエリでマージ要件と PR 状態を取得する。
$numberは PR_NUM:gh api graphql -F owner='{owner}' -F repo='{repo}' -F number={PR_NUM} -f query=' query($owner: String!, $repo: String!, $number: Int!) { repository(owner: $owner, name: $repo) { pullRequest(number: $number) { isDraft reviewDecision reviewThreads(first: 100) { totalCount pageInfo { hasNextPage } nodes { isResolved comments(first: 1) { nodes { author { login } } } } } commits(last: 1) { nodes { commit { statusCheckRollup { state contexts(first: 100) { totalCount pageInfo { hasNextPage } nodes { __typename ... on CheckRun { name status conclusion isRequired(pullRequestNumber: $number) } ... on StatusContext { context state } } } } } } } baseRef { name rules(first: 30) { totalCount pageInfo { hasNextPage } nodes { type parameters { ... on PullRequestParameters { requiredApprovingReviewCount requiredReviewThreadResolution requireCodeOwnerReview requireLastPushApproval } ... on RequiredStatusChecksParameters { requiredStatusChecks { context } strictRequiredStatusChecksPolicy } } repositoryRuleset { name enforcement source { __typename ... on Organization { name } ... on Repository { name } } } } } } } } }'
ページング上限:
reviewThreads(first: 100)・contexts(first: 100)・rules(first: 30)は上限を超えるとレスポンスが切り捨てられる。各フィールドのpageInfo.hasNextPageがtrueの場合、追加ページングは行わず、該当フィールドのデータを不完全として扱う。totalCountを使って「N件中M件を確認」(M はフィールドごとの取得上限)のように報告し、上限超過の旨をユーザーに伝える Required check の判定:CheckRunはisRequired(pullRequestNumber)で直接判定できる。StatusContextはisRequiredにpullRequestId(GraphQL Node ID)が必要なためクエリに含めず、代わりにbaseRef.rulesのrequiredStatusChecks[].contextリストとStatusContext.contextを照合して判定する b. クエリ結果からブロック原因を分類する。各原因に対する対処方針:ブロック原因 判定方法 分類 対処 Draft PR isDraft == true🚫 needs-human 報告して停止 未解決スレッド(AI bot) reviewThreads+ bot 一覧🤖 auto 手順9へ 未解決スレッド(人間) reviewThreads+ bot 一覧外🚫 needs-human 記録 承認不足 reviewDecision == REVIEW_REQUIRED+ ルールのrequiredApprovingReviewCount🚫 needs-human 記録 Changes Requested reviewDecision == CHANGES_REQUESTED+ 手順1のreviewsで人間レビュアーを特定🚫 needs-human 記録 CODEOWNERS 必要 ルールの requireCodeOwnerReview == true🚫 needs-human 記録 Required check 未通過(CheckRun) isRequired == true+conclusionが成功系以外🔴 ci-fail 報告して停止 Required check 未通過(StatusContext) requiredStatusChecks[].contextと一致 +stateがsuccess以外🔴 ci-fail 報告して停止 Required check 実行中 CheckRun: isRequired == true+statusがqueued/in_progress。StatusContext: 一致 +stateがpending⏳ wait 次の tick ページング不完全 いずれかのフィールドで pageInfo.hasNextPage == true❓ unknown 記録 ルール取得結果が空 baseRef.rules.nodesが空配列❓ unknown 記録 c.
isDraft == true→ 報告して即停止(以降のサブステップには進まない) d. 🤖 auto に該当するものがあれば手順9で解決を試み、手順1に戻る e. 🔴 ci-fail があれば失敗チェック名を報告して停止 f. ⏳ wait があれば次の tick まで待機 g. 残りが 🚫 needs-human / ❓ unknown のみの場合(両方混在も含む)→ CI が通過済みとみなし、手順 6(-1) ~ 6d を実行する(6(-1) mark-viewed → 6(0) レビューコメント確認 → 6a/6b/6c debate-review・findings 判定 → 6d verify。6e のマージ判定は実行しない)。自動化可能な品質チェックを全て完了させてから、残りの needs-human / unknown 項目を含むサマリーを報告する:- no-merge モード: PR URL、head SHA、ブロック原因一覧(needs-human 項目 + unknown があれば「原因不明」も併記)、手動マージコマンドを報告して停止
- merge モード: needs-human / unknown 項目があるためマージ不可。項目一覧を報告して停止(マージは試行しない)
-
未解決レビュースレッドの自動解決:
- ページネーションガード: 手順8a で取得した
reviewThreads.pageInfo.hasNextPageがtrueの場合、100件目以降に未確認のスレッド(人間レビュアーのものを含む)が存在する可能性がある。auto-resolve を行わず、PR URL、head SHA、「reviewThreads が100件を超えているため自動解決をスキップ(totalCount: N)」と報告して停止する - GraphQL で未解決スレッド一覧を取得(
reviewThreadsのisResolved == false) - 「AI レビュアー bot 一覧」セクションの bot のスレッドのみ対象(
user.loginから[bot]サフィックスを除去して一覧とマッチング)。人間レビュアーのスレッドは自動 resolve せずユーザーに報告して停止 - 対象スレッドの内容を確認し、以下を判断:
- 誤検知・スタイル提案: コードが既に対処済み、または任意のリファクタ提案 →
resolveReviewThreadmutation で resolve - 正当な指摘(PR スコープ内): PR の変更コードに起因する問題 → 修正を実施してから resolve。修正不能な場合はユーザーに報告して停止
- 正当な指摘(pre-existing): PR 以前から存在する既存コードの問題 → プロジェクトのタスク管理ツール(GitHub Issues、Linear 等)に登録し、PR コメントにリンクを追記してから resolve
- 誤検知・スタイル提案: コードが既に対処済み、または任意のリファクタ提案 →
- 🔧/📋 の分類基準: 「コード内容が元と同じ」は pre-existing の根拠にならない。判定基準は「この問題は PR 以前に存在していたか?」:
- リファクタリング(ファイル移動・リネーム・構造変更)で旧パス・旧名前への参照が壊れた → 🔧(PR 前は正常だった参照が構造変更で壊れたリグレッション)
- ドキュメント・テスト・設定が旧構造を前提としたまま → 🔧(更新漏れは PR の責務)
- 指摘対象のコードが PR 以前から同一内容で存在し、PR の変更と無関係 → 📋
- resolve 後、手順1に戻って全条件を再評価
- ページネーションガード: 手順8a で取得した
-
上記以外 → 「監視中...」と報告して継続
実行履歴の判定(tick をまたいで 3 つの処理の skip/再実行を判定するロジック。手順 1a-0 / 1a-a / 1a-b / 1a-d / 6a / 6b / 6-1-i / 6-1-ii から参照される):
cron mode の /loop 1m はプロンプトを固定文字列として再注入するため、プロンプト末尾に状態を書いても tick をまたいで保持されない。代わりに conversation history(直近の自分自身の tick メッセージ群)を SoT として判定する。
| 記録 | 参照する手順 | 記録する手順 |
|---|---|---|
BABYSIT_HIST: comment-sweep 完了 (PR #<PR_NUM>, headRefOid: <SHA>, 違反なし) |
1a-0 skip 条件 | 1a-0 結果判定(comment-sweep が「違反なし」を確認した時のみ。違反検出時は記録しない) |
BABYSIT_HIST: debate-review 完了 (PR #<PR_NUM>, headRefOid: <SHA>) |
1a-a skip 条件 / 1a-d / 6a | 1a-b / 6b(/debate-review 実行完了直後) |
BABYSIT_HIST: mark-viewed 開始 (PR #<PR_NUM>, headRefOid: <SHA>) |
6-1-i | 6-1-ii(6-1-i の比較直後・mark-viewed 本体 iii〜ix の前) |
判定: 各 tick の手順 1 で gh pr view から取得した現在の headRefOid 値で上記表の <SHA> プレースホルダーを、/babysit-pr のコマンド引数で渡された PR 番号 ({PR_NUM}) で <PR_NUM> プレースホルダーを置換し、完成形のリテラル文字列を作る(例の <SHA> / <PR_NUM> は説明用の synthetic 値: BABYSIT_HIST: comment-sweep 完了 (PR #1234, headRefOid: 0000000000000000000000000000000000000000, 違反なし))。自分自身の過去メッセージを走査し、行全体が完成形と完全一致する 1 行(trailing newline を除き、行頭・行末に余計な文字を一切含まない)が存在するか確認する:
- 存在する → 対応処理を skip
- 存在しない → 実行
この whole-line 完全一致は、VERIFY_REPORT: / VERIFY_SKIP: の機械判定タグ契約(手順 2f.2 の「行頭から開始・1 回のみ・相互排他」「行全体が VERIFY_SKIP: auto-guard と完全一致」)と同じ column-0 strict match パターンを採用したもの。substring match や前後トリミングを行うと narrative 文の literal 引用と区別できないため、完全一致のみを許容する。
判定の境界: 以下の出現は match 対象外。
- SHA 単独の出現(bash log の引用、
gh pr view出力中のheadRefOidフィールド、SKILL.md 仕様の literal<SHA>プレースホルダー記述等)。BABYSIT_HIST:プレフィックスを持たないため弾かれる - 行頭がバッククォート(インラインコード
`)・引用符・インデント・bullet マーカー等で始まる行。リテラルな行頭がBABYSIT_HIST:ではないため弾かれる(例:「次にBABYSIT_HIST: comment-sweep 完了 (PR #<PR_NUM>, headRefOid: <SHA>, 違反なし)を記録する」「BABYSIT_HIST:プレフィックスを持つ行を探す」等の narrative 引用) - 行頭から
BABYSIT_HIST:で始まるが、完成形の末尾)以降に trailing 文字(例:BABYSIT_HIST: debate-review 完了 (PR #<PR_NUM>, headRefOid: <SHA>) を記録する、BABYSIT_HIST: debate-review 完了 (PR #<PR_NUM>, headRefOid: <SHA>) ← これを次に記録等の narrative 補足)が続く行。whole-line 完全一致の要件を満たさないため弾かれる - fenced code block(
```で囲んだ Markdown コードブロック)内の行。例示・ログ引用・記録書式の解説等の目的で完成形を fenced block 内に貼る可能性があるが、それらは記録目的ではないため match 対象外とする。記録は fenced block の外で、独立した 1 行として残す
プレフィックスと whole-line match の組み合わせの目的は、後続 tick が 記録目的で残された 1 行 と 記録形式を引用する narrative 行 を機械的に区別すること。
記録の書式: 上表の BABYSIT_HIST: プレフィックス込みの完成形を、自分のメッセージの独立した 1 行としてそのまま残す(前後にバッククォート・引用符・記号・空白・trailing 文字等を置かないこと。Markdown 段落内なら段落間に空行を置いて独立した 1 行として記録する。fenced code block 内に書いてはならない — 上記「判定の境界」で除外されるため)。<SHA> 部分は手順 1 で取得した headRefOid の値(フル SHA)に、<PR_NUM> 部分は /babysit-pr のコマンド引数で渡された PR 番号 ({PR_NUM}) に置換する。後続 tick の自分が whole-line 完全一致で容易に検出できるよう、形式は固定する。
conversation history が圧縮で消失したケース: 長時間 polling 中にコンテキスト圧縮が発生して過去の tick メッセージが失われた場合、「実施済み」を確認できないため安全側で再実行する。comment-sweep / debate-review / mark-viewed のいずれも idempotent で、再実行による副作用は冗長コスト(外部 AI トークン・wall-clock)のみ。
headRefOid が変わるケース: 新しいコミットが push されると headRefOid が変わるため、conversation history に旧 headRefOid の記録が残っていても現在値と不一致となり、新 head に対する再実行が自動的に走る。明示的なクリア操作は不要。
異なる PR を同一セッションで監視するケース: 同一 Claude セッション内で複数の PR を順次 babysit する場合、PR 番号 (<PR_NUM>) が記録キーに含まれているため、たまたま 2 つの PR の headRefOid が一致しても (実用上ほぼ起こらないが) 前 PR の記録が後 PR の judge で誤マッチすることはない (cross-PR state leakage 防止)。