wm-git-worktree-manager

wm (Git Worktree Manager) 技能是一項強大的 CLI 工具，專為需要維護多個並發功能分支的開發者而設計。它透過自動化建立、管理和清理隔離的工作區，簡化了 git worktree 的工作流程，有效解決了分支切換與暫存（stash）的繁瑣問題。此工具適合在具有複雜 CI/CD 流程、長時間建置過程或需要同時處理多個合併請求（PR）的儲存庫中進行開發的軟體工程師。

• 自動為特定分支建立隔離的 git worktree，讓開發者能同時處理多項功能，無需頻繁切換分支或儲存工作狀態。

• 支援智慧檔案同步，使用者可在 .wm.yaml 定義規則，將 .env 等關鍵設定檔或專案特定配置複製或連結至新工作區。

• 觸發自動化的安裝後任務，例如執行 npm install、pnpm install 或自訂背景腳本，確保新工作區在建立後立即具備開發能力。

• 自動偵測遠端分支，當開始處理存在於遠端但本機尚未擁有的功能分支時，能流暢地從遠端拉取。

• 提供強大的 CLI 介面並支援明確參數，非常適合整合至自動化環境、CI/CD 管線以及指令稿驅動的開發工作流中。

• 包含如主工作區保護等安全機制，防止意外刪除關鍵專案根目錄，並針對含斜線的分支名稱提供標準化命名約定。

• 確保在專案根目錄中配置 .wm.yaml 檔案，以定義基本目錄、檔案同步模式及安裝後任務命令，從而維持一致的開發環境。

• 在自動化腳本中運作時，請使用明確的命令參數（例如 wm add <branch>）而非互動模式，以避免處理程序掛起，因為互動模式需要終端機 TTY。

• 使用 wm list 指令以結構化且易讀的格式檢視所有活動中的工作區及其關聯的 git 分支或 HEAD 狀態。

• 管理複雜分支結構時，請注意包含斜線的分支名稱（例如 feature/auth）會被自動轉換為扁平目錄名稱（feature-auth），以確保路徑安全性與作業系統相容性。

• 在移除指令中使用 -b 參數，可同時刪除 git worktree 目錄與關聯的 git 分支，簡化功能完成或 PR 合併後的清理工作。