git-branch-cleanup

git-branch-cleanup 是一個專為開發人員與 DevOps 工程師設計的工具，旨在維護整潔的本地開發環境。隨著時間推移，本地 Git 儲存庫往往會積累過時、已合併或孤立的分支，這會使開發工作流程變得混亂並增加認知負擔。此技能透過根據分支與基礎分支（如 main 或 master）的關係、最後提交活動以及遠端追蹤狀態進行分類，自動執行這些分支的識別與安全移除。

• 將分支分為特定類別：已合併（安全刪除）、遠端已刪除（gone）、過時（30 天以上無活動）、未合併（進行中）以及與 Git 工作樹相關聯的分支。

• 實施嚴格的安全防護機制，防止刪除 main、master、trunk 等關鍵分支及目前檢出的分支。

• 提供互動式分步驟工作流程：分析目前狀態、審核安全分類、確認刪除並執行清理。

• 支援進階 Git 功能，包括偵測與正確管理 git worktree 關聯，以避免刪除過程中導致檔案系統毀損。

• 具備預覽刪除（Dry Run）模式，使用者可在執行任何指令前預覽刪除結果，確保對儲存庫維護的完全掌控。

• 利用標準 Git 指令（如 for-each-ref、branch --merged 及 branch -vv）確保在標準 Git 環境下的可靠性。

• 推薦給管理大型儲存庫或遵循敏捷開發工作流程（頻繁產生功能分支）的開發者使用。

• 此工具需具備 Git 2.17+ 以獲得完整工作樹支援，建議 Git 2.22+ 以獲得最佳分支識別能力。

• 常見使用場景包括：合併後清理分支、移除連結至已刪除遠端 PR 的分支，以及識別長期遺忘的實驗性分支。

• 使用者需注意，「過時」門檻是可配置的；預設的 30 天視窗可根據特定團隊的衝刺（Sprint）週期或專案需求進行調整。

• 該技能區分了針對已合併分支的「git branch -d」安全刪除，以及針對未合併或孤立分支的強制「-D」刪除，並提供何時使用何者清楚的指導。