Git

• 儲存庫任務：任何涉及 Git 儲存庫的工作——建立分支、暫存變更、提交、推送或開啟 Pull Request。
• 團隊協作：當歷史記錄的安全性至關重要，且需要自動強制執行功能分支流程、緊急修復工作流程或符合 PR 規範的提交規範時。
• 除錯歷史記錄：當需要使用 git bisect 追蹤回歸問題、透過 git reflog 還原遺失的提交，或安全地撤銷變更時。
• 衝突解決：當合併或變基產生衝突，且代理程式需要一套結構化、經過驗證的方法來解決衝突時。

• 非 Git 版本控制：若專案使用 Mercurial、SVN 或其他版本控制系統，此技能的指令將不適用。
• 唯讀分析任務：若代理程式只需讀取原始碼而完全不需與 Git 互動，此技能會增加不必要的負擔。

此技能強制使用 --force-with-lease 而非 --force，以防止覆蓋隊友的工作，並禁止對 main/master 等共用分支執行強制推送。在執行任何破壞性操作（例如 reset --hard 或 rebase）之前，必須先通過內建的安全檢查清單。

涵蓋功能分支（Feature Branch）與緊急修復（Hotfix）情境的逐步流程，包括何時壓縮提交（squash commits）、如何使用 git fetch --all --prune 進行同步，以及如何標記版本發布。適合採用主幹開發（trunk-based）或 gitflow 風格的團隊使用。

編輯衝突檔案後，此技能會使用 grep 驗證是否仍有衝突標記殘留，確認程式碼可正常建置，並在合併過於複雜時提供透過 git merge --abort 退出的選項。當合併變得混亂時，系統會建議以 rebase 作為替代方案。

涵蓋使用 git reflog 復原遺失的提交（最長約 90 天）、透過 SHA 還原已刪除的分支，以及使用 git reset --soft 撤銷提交而不遺失工作內容。同時包含完整的 git bisect 工作流程，用於精確定位引入回歸問題的提交。

此技能要求提交訊息遵循 type(scope): description 格式，且第一行須在 72 個字元以內，並使用標準類型（feat、fix、docs、refactor 等）。這能確保 Git 歷史紀錄易於閱讀，並與自動化變更日誌工具相容。

記錄並防範 Git 中常見的問題：分離的 HEAD 狀態、macOS/Windows 與 Linux CI 之間的大小寫敏感性差異、子模組複製錯誤、stash-pop 衝突，以及提交大型檔案或機密資訊。使用 git add -p 進行精細的部分暫存操作。

一個代理程式會自動建立新功能的骨架、從 main 建立分支、以符合慣例的提交訊息進行漸進式提交、在推送前將分支變基（rebase）至最新的 main、壓縮（squash）修補提交，並開啟一個已準備好提交 PR 的分支——全程無需手動操作 Git。

當發現正式環境的錯誤時，代理程式會從 main 建立一個 hotfix/ 分支，套用修復內容，將其合併至 main 與 develop，為版本建立標籤，並清除該分支——嚴格遵循已記錄的 hotfix 流程。

代理程式執行 git bisect，透過二分搜尋法遍歷提交歷史記錄，根據自動化測試結果將提交標記為「正常」或「異常」，直到找出引入錯誤的確切提交為止。

在長期執行的功能變基（rebase）過程中，代理程式會逐一檔案解決衝突，確認沒有殘留的 <<</>>> 標記，驗證建置通過後繼續進行變基——若衝突過於複雜，則會乾淨地中止操作。