Project Brain – AI程式設計的持久記憶索引

Project Brain 是一個針對 Claude Code 的創新技能，旨在解決 AI 程式設計助手在多個專案中工作時的記憶問題。許多開發者每天都要花費大量時間向 Claude 解釋專案架構、部署方式、技術棧和歷史，但每次新會話都要重新來過。更糟糕的是，長時間工作後，模型可能會混淆不同專案的細節，導致錯誤決策和重複勞動。

Project Brain 透過一個簡單的約定來解決這個問題：在專案根目錄下建立一個 .project-brain/ 資料夾，包含一個輕量級索引檔案（index.md）和按需載入的主題檔案。索引檔案僅包含專案列表、主題及其狀態和指標，而詳細內容則儲存在單獨的檔案中，僅在需要時讀取。這樣，Claude 不會一次性載入所有知識，而是根據問題精準獲取相關資訊。

該技能的核心優勢在於其狀態追蹤功能。每個主題不僅標記為“已完成”，還區分了“已驗證成功”、“嘗試失敗”和“進行中”。例如，當 Claude 查詢某個問題解決方案時，如果地圖顯示該方案三天前已驗證透過，它會主動告知使用者並詢問是否重複。這種設計有效減少了幻覺，防止模型憑空捏造部署細節或混淆不同專案棧。

此外，Project Brain 支援版本管理。當某個方法被替換時，舊版本會被保留為“已替代”筆記，完整記錄嘗試歷程和變更原因。這種非覆蓋式的歷史記錄為團隊協作和長期專案維護提供了寶貴上下文。

安裝過程非常簡單：透過 git 克隆倉庫，執行 install.sh 指令碼即可將技能複製到 ~/.claude/skills/ 目錄。注意，技能是每臺機器安裝一次，而記憶資料（.project-brain/）則存在於每個工作區中。首次使用時，只需在工作區內執行 /project-brain init 命令，它會自動檢測專案（基於 package.json、pyproject.toml 或 git）並建立索引。初始化過程非常輕量，不會讀取原始碼。

對於已有大量程式碼庫的專案，使用者可以選擇進行“深度回填”，讓 Claude 讀取現有程式碼和文件並生成摘要。這需要一次性令牌投入，但之後每次會話都會更便宜、更精準。技能還會在執行深度回填前給出警告，以避免意外消耗。

Project Brain 的設計注重隱私和靈活性。.project-brain/ 資料夾中的內容可能包含基礎設施細節（如資料庫名稱、埠、伺服器路徑），使用者可以根據需要決定是否將其納入版本控制。專案自帶 .gitignore 預設忽略該資料夾，以防意外洩露。

該技能的背景來自作者執行多個獨立 SaaS 產品的實際經驗，包括 Sentinel AI、24ad.info 等。當每個專案都承載著數千行上下文時，AI 遺忘或混淆的代價是真實的。Project Brain 提供了一種實用的工作記憶，幫助保持專案清晰。

總而言之，Project Brain 不僅是一個工具，更是一種讓 AI 助手持續瞭解專案狀態的方法。它透過智慧索引、狀態追蹤和版本歷史，顯著減少了令牌消耗和幻覺，支援跨月記憶，是提升 AI 編碼效率的有力補充。

該技能基於 MIT 許可證開源，歡迎開發者試用和改進。