vibe-run

vibe-run 是 Vibe 編碼代理生態系統的核心組件，旨在將非結構化的編碼任務轉化為嚴謹、具備狀態感知且可重現的工作流。它作為一個編排層，超越了簡單的一次性提示詞回應，實現了長週期的自主運作。透過使用基於 .vibe/ 目錄下檔案（特別是 STATE.md、PLAN.md 和 CONTEXT.md）的共享合約，vibe-run 允許代理程式在多個會話中保持連續性、從中斷中恢復並提供可驗證的進度。此工具適用於軟體工程師與開發者，旨在自動化複雜的待辦事項、多步驟重構與持續性文件撰寫，同時確保對代理決策過程的掌控。

• 透過反覆調用調度引擎 (agentctl) 並執行建議的提示詞，來編排連續的代理循環。

• 維護持久的工作區狀態，確保代理程式遵循預先定義的確定性檢查點序列，而非隨意創建工作流。

• 具備強大的錯誤處理機制，僅在收到 'stop' 角色信號或確認關鍵阻礙時停止運行，確保產出符合運維信任標準。

• 支援多種操作模式，包括交互式終端使用、非交互式 headless CI 自動化以及模擬運行 (dry-run)。

• 透過強制性的 LOOP_RESULT JSON 結構標準化輸出，為下一次循環迭代提供清晰的審計追蹤與可執行的反饋。

• 系統依賴於 .vibe/ 狀態檔案；若需在不同會話間追蹤工作流歷史，請確保這些檔案已納入版本控制。

• 使用 vibe_run.py 等核心腳本進行標準操作，或使用如 continuous_refactor.py 的特定包裝器進行領域專屬自動化。

• 預期的輸入包括已正確初始化的儲存庫（含 .vibe/ 元資料）以及可存取的 template_prompts.md 目錄。

• 執行協議遵循：調度、獲取提示詞、執行、記錄結果與重複循環；當 STATE.md 中出現阻塞性問題時，請確保適時的人工介入。

• 運行器可處理如換行符號差異等機械雜訊，但若狀態追蹤檔案中標記為 'BLOCKED'，則需開發者手動更新狀態以解除阻塞。