Cranot/roam-code

它解決了什麼問題

Roam-code 提供一個本地代碼庫智慧層給 AI 編碼代理，以減少代碼庫導航與理解所需的回合次數、代幣數量與成本。它透過在代理開始編輯前提供預先解析的代碼圖事實，防止代理執行昂貴且重複的搜尋操作（例如多次 grep）。

工作原理

Roam-code 將本地倉庫索引為以 SQLite 為後端的符號、呼叫、匯入與 Git 歷史圖，支援 28 種語言。它使用「任務編譯器」辨識代理所提問題的類型，並將答案（例如呼叫者清單、過濾後的 Git 歷史）直接注入提示中。

此外，它實作一個驗證迴圈，在每次編輯後執行，以檢查命名慣例違規、匯入幻覺、語法錯誤、複雜度、機密洩漏與演算法模式。它可作為 MCP 伺服器整合至 Claude Code、Cursor 與 Continue 等工具。

目標對象

使用 AI 編碼代理的開發者，想在降低 LLM 成本與延遲的同時，確保變更安全且可合併，且透過本地、無憑證的分析完成。

重點特色

• Task Compiler: 預先解析倉庫事實，以減少代理回合（在某些基準測試中減少高達 83%）與輸入代幣。
• Local-First: 不需要 API 金鑰或雲端登入；來源解析與索引皆在本機執行。
• Tamper-Evident Evidence: 產生已簽名的 ChangeEvidence 封包，記錄變更的上下文、風險與驗證。
• Verification Gate: 編輯後自動檢查幻覺、機密與結構性問題。
• Broad Language Support: 使用 SQLite 後端的代碼圖，支援 28 種語言。