cherry-pick-pr

name	cherry-pick-pr
description	featureブランチのコミットを別ベースブランチ(qa/staging/release等)へcherry-pick PR する。main汚染を避けるための短命ブランチ経由PR作成ワークフロー。
argument-hint	<base-branch> (例: qa/staging, release/v2)
disable-model-invocation	true
allowed-tools	["Bash","Read","Grep"]

cherry-pick PR 作成コマンド

featureブランチから指定ベースブランチへ、短命ブランチ経由で cherry-pick PR を作成する。feature → main の PR にベースブランチ固有コードが混入するのを防ぐ。

使用方法

/ndf:cherry-pick-pr qa/staging
/ndf:cherry-pick-pr release/v2

なぜ必要か

featureブランチに環境ブランチ(qa/staging等)を merge して conflict を解消すると、feature → main の PR に環境ブランチ固有のコードが混入する（main汚染）。短命ブランチ + cherry-pick で、必要なコミットだけを対象ブランチに届ける。

詳細な原則は /ndf:branch-fix-strategy スキル参照。

処理フロー

1. 引数・現状確認

• 引数からベースブランチ名を取得（必須。未指定なら確認）
• git branch --show-current で現在ブランチを取得

2. 既存PRのマージ済みチェック（必須）

同じベースブランチ向けの短命ブランチに既存PRがないか確認する。

# 同名パターンのブランチでマージ済みPRがないか確認
gh pr list --head "<current-branch>-for-<base-short-name>" --state merged \
  --json number,mergedAt --jq '.[]'

マージ済みPRが見つかった場合、同じブランチ名は使えない。サフィックスを付ける（例: -v2, -v3）。

3. コミット一覧の確認

git log --oneline main..HEAD

ユーザーに cherry-pick 対象コミットを確認（全コミット or 選択）。

4. 短命ブランチ作成

git fetch origin <base-branch>
git checkout -b <current-branch>-for-<base-short-name> origin/<base-branch>

• <base-short-name>: ベースブランチのスラッシュ以降（例: qa/staging → staging）
• 例: feature/add-auth-for-staging

5. origin/main を取り込む（必須）

git fetch origin main
git merge origin/main --no-edit

CIで最新main必須のWorkflowがあるため、取り込み忘れるとconflictやCIエラーになる。

6. cherry-pick 実行

git cherry-pick -x <commit-hash-1> <commit-hash-2> ...

-x オプションで元のcommit hashが参照として残り、追跡性が向上する。

conflict が発生した場合:

• git diff --name-only --diff-filter=U でconflictファイル一覧
• 解消を試み、ユーザーに確認後 git cherry-pick --continue

7. push して PR 作成

git push -u origin <short-lived-branch>
gh pr create --base <base-branch> --title "<タイトル>" --body "$(cat <<'EOF'
## Summary
- feature/xxx からcherry-pickした<環境名>向けPR
- 元コミット: <hash一覧>

## Test plan
- [ ] <環境名>で動作確認

<!-- I want to review in Japanese. -->
EOF
)"

8. 元ブランチに戻る

git checkout <original-branch>

注意事項

• 短命ブランチは PR マージ後に削除してよい
• feature → main の PR には影響しない
• ベースブランチを feature ブランチに merge するのは 禁止（main汚染の原因）
• -x オプションで元commit参照を残す（追跡性）

関連

• /ndf:branch-fix-strategy — なぜこの手順が必要かの原則
• /ndf:pr — 通常のPR作成（base=main）
• /ndf:deploy — ブランチ全体を環境へデプロイ（cherry-pickとは別用途）