convoy

車隊系統 (Convoy System) 是 Gas Town 工作區管理器的核心架構組件，旨在為多個 AI 代理 (agents) 和工作站 (rigs) 提供持久、事件驅動且具備容錯能力的任務追蹤功能。它允許開發人員將工作項目 (beads) 打包成車隊，並進行自主管理、分段發布與指派給執行代理 (polecats)。此技能對於編排複雜的史詩級專案至關重要，需確保任務依賴關係受到尊重，並使狀態在代理重啟或崩潰後依然保持。

• 透過 bead 依賴項與基於 DAG 的波次執行，實現自動化批次任務追蹤。

• 內建安全機制，包括 IsSlingableType 過濾器與 isIssueBlocked 依賴檢測，防止無效的任務分發。

• 事件驅動的供給機制，利用 SDK 事件在先決任務完成時觸發後續工作分派。

• 具備韌性的滯留掃描功能，若車隊發生停滯，系統會自動恢復並重新分派工作。

• 結構化的生命週期管理，支援透過 gt convoy create 建立、透過 gt convoy stage/launch 執行分段工作流程，以及自動化的 sling 程序。

• 使用此技能來追蹤大型專案、定義依賴關係，並確保 AI 代理在無人工介入的情況下，能依照正確的邏輯序列處理工作。

• 實務流程包括執行 gt convoy stage 以計算依賴波次，隨後使用 gt convoy launch 初始化執行。

• 預期輸入包括 bead 識別碼、任務類型與依賴圖表。輸出包括車隊狀態更新、分發確認以及自動化的狀態轉換日誌。

• 限制：本系統專為 Git 後端環境設計，請確保您的環境符合 dolt、sqlite3 與 beads 分類帳的依賴需求。請務必使用 gt convoy check 與 gt convoy status 監控車隊健康狀況，以偵測瓶頸或執行路徑中斷。

• 進行偵錯時，請查看 operations.go 中的事件驅動行為或 convoy_manager.go 中的滯留掃描邏輯，以識別特定任務為何被跳過或未能分發。