moai-workflow-worktree

moai-workflow-worktree 是一套專為高效能 AI 輔助開發設計的強健 Git 工作樹管理系統。透過為每個軟體規範 (SPEC) 任務建立完全隔離的工作空間，此工具消除了上下文切換的成本，並防止在多任務並行開發期間發生檔案系統衝突。它與 MoAI-ADK 生態系統深度整合，特別是 /moai:1-plan、/moai:2-run 與 /moai:3-sync 生命周期，確保即使同時處理數十個實驗性分支或獨立開發環境時，Git 狀態依然保持一致且易於管理。

• 隔離的工作空間：為每個 SPEC 建立專屬目錄結構，允許獨立的檔案狀態與分支管理，且不影響主要專案儲存庫。

• 自動化登錄系統：維護中央 JSON 註冊表，追蹤所有活動的工作樹、對應的 SPEC ID 以及上次同步時間與狀態等元數據。

• 與 ADK 無縫整合：在規劃階段自動設定工作樹，並在同步階段協助與基準分支進行無衝突的整合。

• 生命周期自動化：支援對已合併或過時分支的智慧清理，減少開發者的認知負擔並防止程式碼庫熵增。

• CLI 驅動的工作流程：提供包含 new、switch、go (shell 評估)、sync、status 與 config 等指令集，促進在隔離環境間快速切換。

• Shell 整合：提供安全的路徑切換指令，適合用於 CI/CD 管線與自動化開發腳本。

• 使用場景包含：同時開發多個 SPEC、在沙盒中測試實驗性功能、管理隔離的程式碼審查，以及維持長期的開發環境而不發生內容漂移。

• 輸入要求：需要於 MoAI-ADK 內初始化的有效專案內容。指令依賴於位於 ~/.moai/worktrees/{ProjectName}/ 的全局配置根目錄。

• 實務限制：請確保您的專案為 Git 儲存庫。工作樹應完全透過提供的 CLI 管理，以保持中央註冊表元數據與實際檔案系統狀態的一致性。

• 推薦模式：在 shell 腳本中使用 go 指令進行動態工作空間切換。變更合併後請務必執行 clean 指令以保持本機開發環境的效能。