vercel-labs/lat.md

解決的問題

它解決了使用單一平面檔案（例如 AGENTS.md）來記錄 AI 代理程式碼庫時的可擴展性問題。隨著專案成長，單一文件變得不切實際，導致設計決策被埋沒、商業邏輯未被記錄，以及因缺乏上下文而產生代理幻覺。

如何運作

該工具會建立一個知識圖譜，由儲存在 lat.md/ 目錄中的相互連結的 Markdown 檔案組成。它使用特定的連結系統，其中 Markdown 章節透過 [[wiki 連結]] 相互連結，並連結至特定的原始碼符號。相反地，原始碼檔案則透過 // @lat: 註解回連至知識圖譜。CLI 工具提供初始化圖譜、驗證參照一致性（lat check）以及使用本地 WebAssembly 嵌入模型或 OpenAI 等託管服務進行語意搜尋的實用功能。

適用對象

專為需要結構化、可維護方式來追蹤程式碼庫中架構、商業邏輯與測試規格的開發人員和 AI 編碼代理設計，以確保跨會話的上下文得以保留。

特色

• 雙向連結：將高階文件直接連結至原始碼中的實作細節。
• 強制一致性：lat check 命令會標示損壞的連結或遺漏的程式碼參考（針對所需的測試規格）。
• 離線語意搜尋：內建本地嵌入模型（all-MiniLM-L6-v2），無需 API 金鑰即可進行搜尋。
• 代理優化工作流程：提供 CLI 命令如 lat expand，協助代理解析提示中的參考，以及提供 MCP 伺服器以整合至編輯器。