| 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がないか確認する。
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とは別用途）
