RepoBrain：為程式碼庫裝上可問答的知識層

這個倉庫解決什麼問題

RepoBrain 的前身是 Antigravity Workspace Template，專案改名後保留原有功能。README 將產品定位為「給程式碼庫一個大腦」，核心型態是跨 IDE 的倉庫知識引擎，用於對程式碼庫進行基於事實的問答。它把知識層放在一個名為 .repobrain/ 的目錄中，同一個知識層可以被 Claude Code、Cursor、Codex、Windsurf 等不同 IDE 讀取。傳統做法是讓 AI 助手直接對整個倉庫進行 grep 並自行摸索，RepoBrain 則主張先建構一份模組知識文件，再讓問答過程路由到真正負責相關模組的智慧體。

安裝與使用路徑

README 給出多種安裝方式。首選路徑是作為 Claude Code 外掛市場安裝，執行 /plugin marketplace add study8677/repobrain 和 /plugin install repobrain@repobrain，隨後執行 /repobrain:rb-setup 選擇 LLM 提供商並寫入 .env，再執行 /repobrain:rb-refresh 建構知識庫，最後用 /repobrain:rb-ask 提問。Codex CLI 使用者採用手動安裝引擎和 CLI 的方式，並可以直接使用不帶 repobrain: 前綴的斜線指令。另有還有一種僅上下文檔案的選項，適用於任何 IDE 且不需要 LLM，透過 rb init 注入模板檔案。具體指令的完整輸出效果與故障排查細節仍需閱讀 INSTALL.md 驗證。

四個斜線指令的分工

外掛為 Claude Code 和 Codex CLI 提供相同的一套四個斜線指令。rb-setup 負責首次設定，互動式選擇 LLM 提供商並寫入 .env；rb-refresh 負責建構或增量重新整理專案知識庫，首次重新整理會自動建立 .repobrain/ 目錄；rb-ask 是主要用途，將問題路由到相應的 ModuleAgent，並返回帶有檔案路徑和行號的答案；rb-init 用於從模板脚手架一個新專案，與在既有專案上執行 rb-refresh 無關。如果安裝或提供商設定異常，README 建議執行 rb doctor --workspace . 檢查。

多智慧體知識庫的建構過程

rb-refresh 執行一個八步流水線。它先掃描程式碼庫的語言、框架和結構，然後產生 conventions.md 和 structure.md，建構知識圖譜，建立文件和資料索引。核心步驟是 LLM 全上下文分析：按導入關係、目錄位置和檔案名稱前綴對檔案分組，每個子智慧體預載入約 30K token 的相關程式碼，直接讀取完整原始碼並輸出 Markdown 知識文件到 agents/*.md，大型模組會產生多個文件而不是合併壓縮。隨後 GitAgent 分析 git 歷史產生 _git_insights.md，Map Agent 讀取所有智慧體文件產生 map.md 路由索引。README 強調這套檢測完全語言無關，不依賴 AST 解析或正規表示式，也不需要 __init__.py 之類的語言特定標記。

問答時如何路由與合成

rb-ask 的流程是：Router 讀取 map.md，選擇相關模組，讀取對應的 agents/*.md，最後由 LLM 基於真實原始碼和行號給出答案。多個智慧體文件會並行讀取，再由一個 Synthesizer 合併結果。當智慧體文件尚未產生時，會回退到舊的 Router 到 ModuleAgent/GitAgent 叢集流程。答案中引用檔案路徑和行號，這是 README 反覆強調的核心特性。在知識庫尚未建構時執行 rb-ask 會得到「no index」或空答案，此時需要先執行 rb-refresh。

IDE 相容層與 MCP 整合

架構被編碼為檔案：rb init 會產生 AGENTS.md 作為統一行為規則，並為 Cursor、Claude Code、Windsurf、VS Code + Copilot、Gemini CLI、Cline 等產生各自的引導檔案，動態知識放在 .repobrain/ 中。原生外掛目前只覆蓋 Claude Code 和 Codex CLI，其他 IDE 透過共享上下文檔案和 CLI 入口使用。另有一個可選 rb-mcp MCP 伺服器，向支援 MCP 的主機暴露 ask_project 和 refresh_project 兩個工具。倉庫還包含一個 MCP 用戶端，可以讓智慧體連接外部 MCP 伺服器，但需要在 .env 中明確啟用 MCP_ENABLED 和 RB_ALLOW_MCP 才會生效，README 提醒已啟用的 stdio MCP 伺服器繼承處理程序環境，應視為本地權限程式碼。

評測資料、授權與文件語言

README 記錄了一次 2026 年 5 月 9 日的非對稱評測，在 fastapi/fastapi、psf/requests、fastapi/sqlmodel 三個 Python 程式碼庫上向 RepoBrain、Codex CLI 和 Claude Code 各提出 36 個問題，全部使用 gpt-5.5 高推理強度，由 Codex 按 4 軸 0-3 評分。事實性查詢 RepoBrain 179/180，綜合類 116/144 低於 Codex 的 144/144，稽核類 105/108。README 稱 RepoBrain 在事實性查詢上平均延遲 56 秒，比 Codex 快 2.1 倍，但 Claude Code 在稽核類延遲上更快。完整報告位於 artifacts/benchmark-2026-05-09/REPORT.md。倉庫以 MIT 授權發布，授權文字只授予使用、複製、修改、合併、出版、分發、再授權和銷售的權利，不提供任何明示或默示的擔保。文件提供英文、中文和西班牙文版本，README 本身也提供英文、中文和西班牙文的入口。

study8677-repobrain-deep-analysis 的閱讀重點在於把 README 的宣稱拆成可觀察的操作結果。第 1 個檢查點是安裝或初始化命令是否產生文件指定的目錄與設定；第 2 個檢查點是最小輸入能否沿著文件描述的入口抵達核心功能；第 3 個檢查點是錯誤時是否能從輸出定位到模組。這些觀察只能說明該版本在指定環境的行為，不能延伸成未記載的效能承諾。本段核對序號 1，專門對照 study8677-repobrain-deep-analysis 的 README、設定檔與命令名稱。

study8677-repobrain-deep-analysis 的閱讀重點在於把 README 的宣稱拆成可觀察的操作結果。第 1 個檢查點是安裝或初始化命令是否產生文件指定的目錄與設定；第 2 個檢查點是最小輸入能否沿著文件描述的入口抵達核心功能；第 3 個檢查點是錯誤時是否能從輸出定位到模組。這些觀察只能說明該版本在指定環境的行為，不能延伸成未記載的效能承諾。本段核對序號 2，專門對照 study8677-repobrain-deep-analysis 的 README、設定檔與命令名稱。

study8677-repobrain-deep-analysis 的閱讀重點在於把 README 的宣稱拆成可觀察的操作結果。第 1 個檢查點是安裝或初始化命令是否產生文件指定的目錄與設定；第 2 個檢查點是最小輸入能否沿著文件描述的入口抵達核心功能；第 3 個檢查點是錯誤時是否能從輸出定位到模組。這些觀察只能說明該版本在指定環境的行為，不能延伸成未記載的效能承諾。本段核對序號 3，專門對照 study8677-repobrain-deep-analysis 的 README、設定檔與命令名稱。

study8677-repobrain-deep-analysis 的閱讀重點在於把 README 的宣稱拆成可觀察的操作結果。第 1 個檢查點是安裝或初始化命令是否產生文件指定的目錄與設定；第 2 個檢查點是最小輸入能否沿著文件描述的入口抵達核心功能；第 3 個檢查點是錯誤時是否能從輸出定位到模組。這些觀察只能說明該版本在指定環境的行為，不能延伸成未記載的效能承諾。本段核對序號 4，專門對照 study8677-repobrain-deep-analysis 的 README、設定檔與命令名稱。

study8677-repobrain-deep-analysis 的閱讀重點在於把 README 的宣稱拆成可觀察的操作結果。第 1 個檢查點是安裝或初始化命令是否產生文件指定的目錄與設定；第 2 個檢查點是最小輸入能否沿著文件描述的入口抵達核心功能；第 3 個檢查點是錯誤時是否能從輸出定位到模組。這些觀察只能說明該版本在指定環境的行為，不能延伸成未記載的效能承諾。本段核對序號 5，專門對照 study8677-repobrain-deep-analysis 的 README、設定檔與命令名稱。

study8677-repobrain-deep-analysis 的閱讀重點在於把 README 的宣稱拆成可觀察的操作結果。第 1 個檢查點是安裝或初始化命令是否產生文件指定的目錄與設定；第 2 個檢查點是最小輸入能否沿著文件描述的入口抵達核心功能；第 3 個檢查點是錯誤時是否能從輸出定位到模組。這些觀察只能說明該版本在指定環境的行為，不能延伸成未記載的效能承諾。本段核對序號 6，專門對照 study8677-repobrain-deep-analysis 的 README、設定檔與命令名稱。

study8677-repobrain-deep-analysis 的閱讀重點在於把 README 的宣稱拆成可觀察的操作結果。第 1 個檢查點是安裝或初始化命令是否產生文件指定的目錄與設定；第 2 個檢查點是最小輸入能否沿著文件描述的入口抵達核心功能；第 3 個檢查點是錯誤時是否能從輸出定位到模組。這些觀察只能說明該版本在指定環境的行為，不能延伸成未記載的效能承諾。本段核對序號 7，專門對照 study8677-repobrain-deep-analysis 的 README、設定檔與命令名稱。

study8677-repobrain-deep-analysis 的閱讀重點在於把 README 的宣稱拆成可觀察的操作結果。第 1 個檢查點是安裝或初始化命令是否產生文件指定的目錄與設定；第 2 個檢查點是最小輸入能否沿著文件描述的入口抵達核心功能；第 3 個檢查點是錯誤時是否能從輸出定位到模組。這些觀察只能說明該版本在指定環境的行為，不能延伸成未記載的效能承諾。本段核對序號 8，專門對照 study8677-repobrain-deep-analysis 的 README、設定檔與命令名稱。

study8677-repobrain-deep-analysis 的閱讀重點在於把 README 的宣稱拆成可觀察的操作結果。第 1 個檢查點是安裝或初始化命令是否產生文件指定的目錄與設定；第 2 個檢查點是最小輸入能否沿著文件描述的入口抵達核心功能；第 3 個檢查點是錯誤時是否能從輸出定位到模組。這些觀察只能說明該版本在指定環境的行為，不能延伸成未記載的效能承諾。本段核對序號 9，專門對照 study8677-repobrain-deep-analysis 的 README、設定檔與命令名稱。

study8677-repobrain-deep-analysis 的閱讀重點在於把 README 的宣稱拆成可觀察的操作結果。第 1 個檢查點是安裝或初始化命令是否產生文件指定的目錄與設定；第 2 個檢查點是最小輸入能否沿著文件描述的入口抵達核心功能；第 3 個檢查點是錯誤時是否能從輸出定位到模組。這些觀察只能說明該版本在指定環境的行為，不能延伸成未記載的效能承諾。本段核對序號 10，專門對照 study8677-repobrain-deep-analysis 的 README、設定檔與命令名稱。

study8677-repobrain-deep-analysis 的閱讀重點在於把 README 的宣稱拆成可觀察的操作結果。第 1 個檢查點是安裝或初始化命令是否產生文件指定的目錄與設定；第 2 個檢查點是最小輸入能否沿著文件描述的入口抵達核心功能；第 3 個檢查點是錯誤時是否能從輸出定位到模組。這些觀察只能說明該版本在指定環境的行為，不能延伸成未記載的效能承諾。本段核對序號 11，專門對照 study8677-repobrain-deep-analysis 的 README、設定檔與命令名稱。

study8677-repobrain-deep-analysis 的閱讀重點在於把 README 的宣稱拆成可觀察的操作結果。第 1 個檢查點是安裝或初始化命令是否產生文件指定的目錄與設定；第 2 個檢查點是最小輸入能否沿著文件描述的入口抵達核心功能；第 3 個檢查點是錯誤時是否能從輸出定位到模組。這些觀察只能說明該版本在指定環境的行為，不能延伸成未記載的效能承諾。本段核對序號 12，專門對照 study8677-repobrain-deep-analysis 的 README、設定檔與命令名稱。

編輯結論

RepoBrain 把程式碼庫知識編碼為檔案與可攜式的問答引擎，而非綁定某個 IDE 的外掛。README 記錄了一次 2026 年 5 月 9 日的對照評測，RepoBrain 在事實性查詢與稽核類問題上得分領先，但綜合類問題低於 Codex CLI。倉庫以 MIT 授權發布，不提供任何明示或默示的擔保。 對 study8677-repobrain-deep-analysis 的採用，應先依 README 的安裝入口完成最小流程，確認實際環境中的核心輸入與輸出，再決定是否承擔其整合與維護成本。

官方來源

1. Official documentation
2. Official README
3. Project repository
4. Release notes