manage-worktree

此技能是專為管理 Rails-on-Services Apartment 專案中並行 git 工作樹 (worktrees) 的開發者所設計。它透過自動化設定與清理兄弟儲存庫目錄，簡化了複雜的 git 操作，讓您可以同時處理多個功能分支，而無需在單一目錄中反覆執行 stash 或切換分支。本工具旨在協助軟體工程師，特別是那些處理多租戶架構並需平行測試不同 schema 設定的開發者。透過此代理，您可以顯著降低手動目錄管理、分支追蹤與環境設定的作業負擔。

• 自動建立與主儲存庫目錄並行的 git 工作樹，確保路徑解析正確。

• 執行專案特定的設定任務，例如呼叫 'bin/dev/setup-worktree' 來配置 .claude、.bundle、.vscode 及 Peacock 顏色設定。

• 無縫處理 stash 作業，確保在進入或離開工作樹時保護未提交的程式碼異動。

• 具備模式偵測功能，能自動判斷使用者的意圖：建立新分支、移動既有分支或執行清理/刪除任務。

• 驗證開發者前綴（如 man/ 或特定功能標籤），以維持儲存庫的命名規範。

• 使用內部專案腳本 'bin/dev/remove-worktree' 自動化刪除分支與清理工作，確保不會遺留孤立的資料庫或 schema。

• 此技能預期接收分支名稱或意圖指令（如 'remove'、'move' 或 'create'）。

• 它會使用 'git worktree list --porcelain' 動態解析工作樹根路徑，避免在既有工作樹內執行時發生問題。

• 在嘗試移動操作前，總是會進行既有分支的安全檢查，以防止資料遺失。

• 當您需要快速切換情境、測試不同的租戶策略，或為 Apartment 基礎的 Rails 應用程式管理獨立開發環境時，請使用此工具。

• 請注意，此技能需要存取 bash 基礎的 git 指令以及儲存庫結構中定義的專案 bin 腳本。