kris-hansen/comanda

解決的問題

Comanda 提供一個終端原生的執行環境，用於在軟體倉儲中管理持久且自我改善的代理工作流程。它透過實作可觀測的結束條件與自動化品質門檻（如測試與程式碼檢查工具），解決「幻覺式完成」的問題——即代理聲稱任務已完成，但實際上並未完成。

如何運作

Comanda 允許使用者以英文描述期望的結果，然後將其轉換為基於 YAML 的程式。此程式定義了步驟序列、平行流程或代理迴圈。它協調多種 AI 模型（Claude、Gemini、OpenAI、透過 Ollama/vLLM 的本地模型）與工具，透過檔案或標準輸入/輸出傳遞資料。

主要技術元件包括：

• 代理迴圈：具備狀態保持能力，能根據先前結果優化提示，並在每一步後執行品質門檻。
• 程式碼庫索引：捕捉倉儲結構與符號，建立可遍歷的知識圖譜，儲存在 SQLite FTS5 資料庫中以支援語意召回。
• 持久記憶：專案本地的語意記憶系統，允許代理回憶特定專案的決策、限制與事實。
• MCP 整合：工作流程可透過 Model Context Protocol (MCP) 作為工具與提示公開。

適用對象

希望在不切換至完整代理框架或視覺化自動化平台的情況下，管理並重用倉儲中持久代理工作的開發者。

特色亮點

• 決定性品質門檻：使用現有測試、安全檢查與程式碼檢查工具作為「完成」的定義。
• 知識圖譜視覺化器：互動式本地瀏覽器檢視，用於導航複雜的程式碼庫依賴關係與架構。
• 多代理協調：可在單一流程中協調不同模型（例如，Claude 負責審查，OpenAI 負責實作）。
• 檢查點機制：支援中斷並從最後一個檢查點恢復長時間執行的代理迴圈。
• 語意記憶：可選的、命名空間範圍的本地專案特定事實與決策記憶。