| name | catchup-branch |
| description | 現在のブランチに main の最新を取り込み push する。 git fetch → main を merge → コンフリクト解消 → push を 自動実行する。「ブランチ同期」「sync」「main に追従」 「リモートと合わせたい」「最新にして push したい」で使用。 |
| user_invocable | true |
catchup-branch
現在のブランチに main の最新を取り込み、push まで完了させる。
処理フロー
各ステップの結果を確認してから次に進むこと。
1. 事前確認
git status
git branch --show-current
- 現在のブランチ名を把握する
- detached HEAD の場合は中断してユーザーに報告する
- main ブランチ上にいる場合は pull → push のみ行う
2. 未コミット変更の退避
未コミットの変更（staged / unstaged / untracked）が
ある場合、stash で退避する。
git stash push -u -m "catchup-branch: auto stash"
変更がない場合はスキップする。
stash したかどうかを記憶しておく。
3. main の最新を取得
git fetch origin main
4. main を現在のブランチに merge
git merge origin/main
コンフリクトが発生しなければステップ 6 に進む。
5. コンフリクト解消
merge でコンフリクトが発生した場合:
git diff --name-only --diff-filter=U で
コンフリクトファイルを一覧する- 各ファイルのコンフリクト箇所を Read で確認する
- ローカル側・リモート側の変更意図を読み取り、
両方の意図を活かすマージを行う
- 解消後、
git add して git commit する
6. push
git push origin <current-branch>
upstream 未設定の場合:
git push -u origin <current-branch>
7. stash の復元
ステップ 2 で stash した場合、復元する。
git stash pop
pop でコンフリクトが発生した場合は、
ステップ 5 と同じ手順で解消する。
8. 完了報告
git status
git log --oneline -3
報告内容:
- ブランチ名
- コンフリクトの有無と解消内容（あれば）
- push 先
- stash の復元結果（あれば）
