merge

マージ

merge-and-cleanup と merge-to-main を1つのフローに統合します。デフォルトではファストフォワードを使用し、ファストフォワードができない場合、またはユーザーが希望した場合はマージコミットを保持します。ブランチやワークツリーの削除については、必ずユーザーに確認します。

フロー

1. すでに main にいる場合は拒否します。 git rev-parse --abbrev-ref HEAD が main（または master）を返した場合は停止して報告します。マージするものはありません。
2. 作業ツリーをクリーンな状態にします。 未コミットの変更がある場合は、コミット、スタッシュ、または中止のどれにするかユーザーに確認します。黙ってスタッシュしてはいけません。
3. フィーチャーブランチ名を取得します — FEATURE=$(git rev-parse --abbrev-ref HEAD)。
4. main を同期します。
   • git checkout main
   • git pull --ff-only origin main
5. まずファストフォワードマージを試します。
   • git merge --ff-only "$FEATURE"
   • 成功した場合、履歴は直線的です。マージの手順はこれで完了です。
   • 失敗した場合（ブランチが分岐している場合）、手順6に進みます。
6. マージコミットに切り替えます — git merge --no-ff "$FEATURE"。
   • コンフリクトが発生した場合は停止して報告します。自動で解決してはいけません。
   • 意味のあるマージコミットメッセージを記述します。単に「Merge branch …」となるデフォルトのメッセージは受け入れないでください。
7. プッシュします — git push origin main。
8. クリーンアップについてユーザーに確認します。 「$FEATURE（ローカルとリモート）と、関連するワークツリーを削除しますか？」と尋ねます。
   • はいの場合：
     • $FEATURE のワークツリーが存在する場合（git worktree list | grep -F "$FEATURE"）、先にメインリポジトリのディレクトリへ cd してから、git worktree remove <path> を実行します。
     • git branch -d "$FEATURE" を実行します（ユーザーが明示的に確認した場合に限り -D を使用します。-d はブランチがマージされていない場合に拒否します。これが望ましい安全策です）。
     • git push origin --delete "$FEATURE" を実行します（ブランチがプッシュされていない場合の失敗は無視します）。
   • いいえの場合：何も変更せずに残します。
9. 最終状態を報告します — main 上のコミットハッシュ、ブランチが削除されたかどうか、ワークツリーが削除されたかどうかを報告します。

注意事項

• ff-only を優先します。 直線的な履歴のほうが把握しやすいためです。ブランチが実際に分岐している場合に限り、マージコミットに切り替えます。
• --no-verify は決して使いません。 pre-push フックに失敗した場合は、根本原因を修正します。回避してはいけません。
• ワークツリーを先にクリーンアップします。 フィーチャーブランチがワークツリーで開発された場合、そのワークツリー内からブランチを削除することはできません。必ず先にメインリポジトリの作業ディレクトリへ cd してください。
• コンフリクトへの対応方針。 このスキルではコンフリクトを自動解決しません。git merge がコンフリクトを報告した場合は停止し、ユーザーに伝えます。どうするかはユーザーが判断します。

注意が必要な点

• main 上で git pull --ff-only が失敗するのは、main がローカルで分岐している場合です（たとえば、main に直接コミットした場合）。これは別の問題なので、表面化させてください。--rebase で取り繕ってはいけません。
• git branch -d はマージされていないブランチの削除を拒否します。この拒否は安全策です。自動的に -D に切り替えてはいけません。
• リモートブランチが存在しない場合、git push origin --delete はゼロ以外で終了します。このフローでは問題ありません（ブランチがローカルにしか存在しなかった場合です）。記録して処理を続けてください。
• macOS の大文字小文字を区別しないファイルシステムでは、大文字小文字だけが異なるコンフリクトが見えないことがあります。フィーチャーブランチ名が別のブランチ名と大文字小文字だけ異なる場合、git checkout の動作に注意してください。