release-kick

release PR #$ARGUMENTS を、BLOCKED 解除からマージ・リリース公開の検証まで一貫して実行する。

release-please が生成するリリース PR の head は GITHUB_TOKEN push であるため、通常は mergeStateStatus: BLOCKED（"N of N required checks are expected"）になる（CLAUDE.md「N of N required checks are expected = bot/GITHUB_TOKEN push」ガード参照）。この BLOCKED の原因・RELEASE_KICK_PAT のセットアップ・workflow_dispatch 版が deprecated である理由は docs/runbook/bot-pushed-head-kick.md が SSoT。kick の正規手順は scripts/release-please-kick.sh であり、workflow 版は使えない。本コマンドはそれを前提に、実際にマージして公開を確認するまでの実行手順を1コマンド化したもの。矛盾があれば runbook を正とし、本コマンドを修正する。

手順

Step 0. 手順書の鮮度確認

git fetch origin
git diff --quiet HEAD origin/main -- .claude/commands/release-kick.md docs/runbook/bot-pushed-head-kick.md || echo "手順書が古い: origin/main 版を読み直すこと"

ローカル main が origin より遅れていると、改訂前の手順書を読んだまま実走することになる。上のメッセージが出たら git pull で追いついてから、本コマンドと runbook を読み直す。差分がなければ何も出力されない。

v1.67.1 の実走では、ローカルが 24 コミット遅れていた。その結果、#1702 による改訂前の版を読み込んだまま実走している。#1702 のマージ時刻はキックの 16 分前だった。

Step 1. gh アカウント確認

gh api user --jq .login | grep -q s977043 || gh auth switch -u s977043

PreToolUse hook (gh-account-guard.sh) が defense-in-depth で効くが、セッション開始時の確認は省略しない。 s977043 は本リポジトリのメンテナアカウント（CLAUDE.md「Verify gh active account before write ops」ガードと同一の値で、そちらが SSoT）。フォーク運用時は自分のアカウントに読み替える。

Step 2. PR 状態の確認と BEHIND 判定

gh pr view $ARGUMENTS --json state,mergeStateStatus,headRefOid
releaseBranch=$(gh pr view $ARGUMENTS --json headRefName --jq .headRefName)
gh api "repos/:owner/:repo/compare/main...$releaseBranch" --jq '{status, ahead_by, behind_by}'

mergeStateStatus: BLOCKED は release-please PR の通常挙動。CLEAN なら Step 3〜5 をスキップして Step 6 へ進む。

BLOCKED の場合は behind_by の値で次に打つ手が変わる。mergeable_state は単一の値しか返さず BEHIND と BLOCKED の複合状態を見分けられないため、compare の behind_by で判定する。

behind_by	状態	次に進む Step	空コミット kick
> 0	BEHIND + BLOCKED	Step 3（update-branch）	CI が実発火すれば不要
0	純 BLOCKED	Step 4（kick）	必要