知識管理與大腦維護指南
如何管理、備份及分享 Boring 的學習成果。
🧠 什麼是「大腦」(.boring/brain)？
Boring 將其持久性的智慧儲存在名為 .boring/brain 的目錄中。這個目錄包含：
- 學習經驗 (
learnings.json)：擷取到的「錯誤-修復」模式。 - RAG 索引 (ChromaDB)：代碼庫的向量中繼資料。
- 上下文 (Context)：計畫與進度的歷史記錄。
💾 備份與遷移
與團隊分享進度
若要讓團隊成員受益於 Boring 已學習到的經驗：
1. 複製中繼資料：分享 .boring/brain/learnings.json 檔案。
2. 匯入：同事可以將此檔案放置在他們本地的 .boring/brain/ 目錄中。
跨專案遷移
如果您啟動了一個與舊專案類似的新專案，可以透過複製 learnings.json 快速「繼承」之前的修復經驗。
🔄 RAG 索引管理
RAG 索引確保 Boring 「知道」每一段代碼的位置。如果代碼庫發生重大變動，而 Boring 顯得困惑：
重建索引
這將刪除舊的向量儲存並執行全新的掃描。🧹 重置大腦
如果您希望 Boring 從零開始（忘記所有之前的錯誤和修復）：
1. 停止 Boring。
2. 刪除目錄：rm -rf .boring/brain
3. 重啟：Boring 會重新初始化一個乾淨的大腦。
💡 最佳實踐
- 定期備份：您可以考慮將最新的
learnings.json放入 Git 版控，以追蹤專案知識庫的演進。 - 主動學習：如果您發現了一個非常巧妙的修復方式，可以手動呼叫
boring_learn工具，確保代理永遠記得它。