smithersai/smithers

解決的問題

Smithers 為編程代理提供了一個持久的執行環境，使其能夠在真實的倉庫上執行複雜的、多步驟的工作。它解決了當終端崩潰或工作階段結束時代理工作階段遺失的瞬時性問題，允許將長時間運行的任務進行持久化、檢查和恢復。

工作原理

Smithers 使用基於 JSX 的工作流系統，每個完成的步驟都會立即持久化到 SQLite 資料庫中。這使得執行環境能夠從持久化狀態重新渲染工作流以確定下一個任務，從而實現崩潰後恢復、回溯到之前的影格以及分叉備選時間線等功能。工作流通常由編程代理透過自然語言提示詞自行編寫，而不是手動編寫。

適用對象

使用編程代理（如 Claude Code、Codex、Cursor 或 Pi）的開發人員，他們需要執行大規模的工程工作——例如跨多個步驟實現功能或執行審查迴圈——這些工作需要人工核准、持久性和可觀測性。

亮點

• 零配置編寫：代理根據對預期結果的自然語言描述來構建工作流。
• 時光旅行：能夠從執行歷史中的任何特定點進行回溯、分叉或重放執行。
• 持久化執行：透過持久化每個完成的步驟，使執行在崩潰和重啟後得以延續。
• 跨代理持久化：在單個工作流中支援多個代理和模型（Claude、Gemini、Pi 等）。
• 人機回環 (Human-in-the-loop)：透過人工核准為高風險步驟提供內建閘門。
• 跨執行記憶體：持久化記憶體允許代理從之前的執行中召回資訊。
• 可觀測性：包括用於即時追蹤的專用監控器、Prometheus 指標和 OpenTelemetry 追蹤。