JordanCoin/codemap

解決的問題

程式代理通常只能看到單一檔案的文字內容，難以理解程式碼庫中的結構關係。它們無法輕易判斷哪些檔案依賴於特定檔案，也無法確定變更的「爆發半徑」，更不清楚建置系統規則（如 go.mod 或 tsconfig 別名）如何影響匯入。codemap 提供一種結構化的「真實情況」，讓代理無需耗時的手動掃描，即可理解依賴關係與專案結構。

工作原理

codemap 使用生態系特定的規則分析程式庫，而非簡單的字串比對。它與 cargo metadata（Rust）、go.mod（Go）、package.json（JS/TS）等建置工具整合，以準確解析匯入。針對 21 種語言的通用匯入提取，使用 ast-grep。為確保可靠性，實作「覆蓋契約」，明確報告無法解析依賴關係的情況，防止代理將部分圖誤認為完整圖。

適用對象

專為使用 AI 程式代理（如 Claude Code 或 Codex）的開發者設計，他們需要代理對專案架構與依賴流程有更深入的結構性理解。

主要亮點

• 建置系統感知的解析：基於 Go、Rust、JS/TS 和 Dart/Flutter 的真實生態系規則解析匯入。
• 爆發半徑分析：快速識別「核心檔案」（被頻繁匯入的檔案），並精確判斷變更將影響哪些部分。
• 代理整合：提供包含 19 個工具的 MCP 伺服器、用於自動上下文的會話鈎子，以及用於機器可讀專案智慧的上下文協定。
• 跨代理交接：追蹤哪個代理編輯了哪些檔案，支援在不同 AI 工具間無縫切換。
• 遠端分析：無需完整本地克隆，即可分析公開的 GitHub 或 GitLab 程式庫。