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 許可證開源，歡迎開發者試用和改進。