using-git-worktrees

using-git-worktrees 技能為軟體開發代理程式提供了一套系統化的框架，用於管理平行分支，避免頻繁切換上下文造成的效能損耗。透過利用 git worktrees，代理程式可以建立共享同一底層儲存庫的隔離工作空間，從而實現同步的實作、測試與除錯。此技能專為需要乾淨、隔離環境來進行功能開發或錯誤修正的工程工作流程所設計。

• 自動化的目錄選擇優先考慮 .worktrees 等隱藏資料夾或專屬的全域設定路徑，以確保工作空間組織的一致性。

• 強制性的安全驗證使用 git check-ignore 來確保工作空間目錄不會與儲存庫追蹤衝突，防止意外的原始碼污染。

• 智慧化的專案設定功能可檢測 package.json、Cargo.toml、requirements.txt 或 go.mod 等檔案標記，以自動觸發如 npm install、cargo build 或 pip install 等安裝指令。

• 基准測試整合機制要求在工作空間正式啟用前，必須先執行專案特定的測試套件，確保開發環境在已知的穩定狀態下啟動。

• 嚴格遵守專案慣例與現有文件 (CLAUDE.md)，防止代理程式做出未經授權的目錄選擇。

• 執行前請務必宣佈意圖：「我正在使用 using-git-worktrees 技能來建立隔離的工作空間。」

• 若針對專案本地的 worktrees 偵測到未被忽略的目錄，技能強制要求立即採取補救措施，將該路徑加入 .gitignore 並提交變更後才可繼續。

• 當遇到基准測試失敗時，代理程式必須報告具體錯誤並請求人類介入，而不是貿然進入不穩定的開發環境。

• 極適合用於涉及多重功能開發、複雜分支管理或子代理程式驅動開發 (subagent-driven-development) 的使用場景，因為這些場景中快速的上下文切換容易導致設定錯誤。

• 此技能作為實作任務的先決條件，確保在任何新邏輯注入儲存庫之前，所有依賴項皆已就緒且程式碼基準皆可驗證。