majiayu000 解決 Git 衝突
協助使用者系統化地解決 Git Rebase 或 Merge 過程中的衝突。
核心功能
- 偵測當前的衝突狀態（rebase 或 merge）
- 列出所有衝突的檔案
- 逐個檢視並解決衝突
- 完成 rebase 或 merge 流程
執行步驟
1. 偵測衝突狀態
檢查當前是否處於衝突狀態：
git status
確認是 rebase 還是 merge 衝突：
- Rebase: 會顯示
rebase in progress - Merge: 會顯示
You have unmerged paths
2. 列出衝突檔案
使用以下指令列出所有衝突的檔案：
git diff --name-only --diff-filter=U
或從 git status 中擷取：
git status --short | grep "^UU\|^AA\|^DD\|^AU\|^UA\|^UD\|^DU"
3. 解決衝突
對於每個衝突的檔案：
讀取檔案內容
- 使用 Read tool 檢視衝突標記
- 識別衝突區塊（
<<<<<<<,=======,>>>>>>>）
展示衝突資訊
- IMPORTANT: 在詢問使用者前，必須先清楚展示衝突的詳細內容
- 明確標示雙方的修改內容
- 說明衝突發生的位置和原因
- 範例格式：
檔案：src/example.ts 衝突位置：第 10 行 衝突內容比對： <<<<<<< HEAD (當前分支) const value = "version A" ======= const value = "version B" >>>>>>> 合併進來的分支
使用 AskUserQuestion 提供解決選項
- 列出所有可能的解決方案
- 對於簡單衝突，提供：
- 保留當前分支版本（ours）
- 採用合併進來的版本（theirs）
- 對於需要手動整合的情況，明確列出所有組合：
- 方案 A + 方案 B
- 方案 B + 方案 A
- 其他自訂組合
- 讓使用者基於完整資訊做出選擇
執行解決
- 使用 Edit tool 根據使用者選擇移除衝突標記
- 保留或整合正確的程式碼
標記為已解決
git add <檔案路徑>
4. 完成流程
所有衝突解決後：
Rebase:
git rebase --continue
如果遇到「You must edit all merge conflicts」錯誤，可能是索引狀態不一致，使用以下方式重置：
git reset && git add <已解決的檔案> && git rebase --continue
Merge:
git commit
如果需要放棄：
- Rebase:
git rebase --abort - Merge:
git merge --abort
使用場景
適用情境
- 執行
git rebase時遇到衝突 - 執行
git merge時遇到衝突 - 需要系統化地處理多個衝突檔案
- 不確定如何正確解決衝突
處理策略
簡單衝突：
- 完全採用一方的修改（ours 或 theirs）
- 直接使用對應策略：
git checkout --ours <檔案> # 保留當前分支的版本 git checkout --theirs <檔案> # 採用合併進來的版本
複雜衝突：
- 需要手動合併雙方的修改
- 仔細檢視衝突區塊的上下文
- 整合兩邊的邏輯變更
工作流程範例
[執行 rebase 時遇到衝突]
User: 我在 rebase 時遇到衝突了，幫我解決。
Agent: 偵測到 rebase 衝突，有 2 個檔案需要解決：
1. src/auth/login.ts
2. README.md
開始解決第一個衝突...
檔案：src/auth/login.ts
衝突位置：第 15 行
衝突內容比對：
<<<<<<< HEAD (當前分支)
if (user.verified) {
return authenticateUser(user)
}
=======
if (user.isVerified && user.active) {
return authenticate(user)
}
>>>>>>> feature/new-auth
Agent: [使用 AskUserQuestion]
要如何解決這個衝突？
選項：
1. 保留當前版本（user.verified）
2. 採用新版本（user.isVerified && user.active）
3. 整合：保留 isVerified 和 active 檢查，使用 authenticateUser
4. 其他自訂方案
User: [選擇選項 3]
Agent: 已解決 login.ts 並標記為已解決。
繼續處理 README.md...
[展示衝突並詢問]
User: [選擇保留雙方的文件更新]
Agent: 所有衝突已解決，執行 git rebase --continue
Rebase 成功完成！
User: [確認結果並繼續開發]
注意事項
安全檢查
- 資訊透明化：在詢問使用者前，務必先展示完整的衝突內容和上下文
- 明確選項：提供所有可能的解決方案，包括手動整合的不同組合方式
- 解決衝突前先確認了解雙方的修改意圖
- 不確定時使用 AskUserQuestion 詢問使用者應該保留哪個版本
- 解決後建議執行測試確保功能正常
常見錯誤
避免：
- 未展示衝突詳細內容就直接詢問使用者如何解決
- 手動整合選項不夠明確（例如只提供「整合雙方」而不列出具體組合方式）
- 直接刪除所有衝突標記而不檢視內容
- 未理解程式碼脈絡就決定保留哪個版本
- 解決衝突後未執行測試
推薦：
- 先展示完整的衝突資訊，再使用 AskUserQuestion 提供明確選項
- 列出所有可能的解決方案，包括不同的整合順序
- 仔細閱讀衝突區塊的上下文
- 理解兩個版本的差異原因
- 可能的話整合雙方的優點
- 解決後執行相關測試
特殊情況
二進位檔案衝突：
# 只能選擇其中一個版本
git checkout --ours <二進位檔案>
# 或
git checkout --theirs <二進位檔案>
檔案刪除衝突：
- 一方修改，一方刪除
- 需要判斷是否應該保留或刪除該檔案
整合其他工具
解決衝突後建議：
- 使用
reviewers:requesting-code-review檢視解決方案 - 執行專案的測試套件