long-running-agent

Long-Running Agent 框架為執行複雜、多工作階段專案的 AI 代理提供了強大的架構。它透過實作持久性狀態管理系統來彌補語言模型在不同開發工作階段之間的上下文斷層，從而解決了常見的「一次性完成」限制。此框架非常適合開發人員建構自主程式設計代理，這些代理需要處理大規模程式碼庫、增量功能開發以及長期嚴格的測試週期。

• 包含雙代理模式：用於環境設定的初始設定代理 (Initializer Agent) 和用於增量進度的編碼代理 (Coding Agent)。

• 使用 init.sh、feature_list.json 和 claude-progress.txt 的標準化工作階段啟動協定，確保上下文連續性。

• 透過進度追蹤進行嚴格的狀態管理，包括記錄工作階段時間戳記、git 提交歷史紀錄以及針對特定功能的通過/失敗驗證。

• 透過初始化指令碼自動處理環境設定，包括相依性安裝與開發伺服器編排。

• 增量開發方法論，強制執行一次處理一個功能，並附帶端對端測試要求。

• 確保初始設定代理僅執行一次，以設定基本目錄並建立必要的追蹤檔案。

• 維護 feature_list.json 的完整性，絕不修改測試說明，且僅在成功的端對端驗證後更新狀態欄位。

• 使用提供的進度範本總結變更、記錄目前狀態，並為後續代理工作階段定義清晰的下一步。

• 整合如 Puppeteer MCP 等瀏覽器自動化工具進行真實端對端驗證，而非僅依賴內部單元測試。

• 每個工作階段結束時務必將進度提交至 git，以維護下一個代理執行個體可恢復且乾淨的狀態。

• 當應用於非程式設計領域時，請專注於任務分解、進度持久化以及根據定義的約束條件驗證工作成果。