Tree Ring Memory(年輪記憶) 是做什麼的?
將 Tree Ring Memory 視為生命週期感知的記憶層,而非對話轉儲。
Tree Ring Memory 像樹木的年輪一樣,保存代理有價值的學習:
- 近期工作保持詳細
- 舊知識壓縮成穩定的年輪
- 重要警告保持可見,形成疤痕
- 持久真理成為心材
- 推測性的未來工作保持為種子
- 敏感資料預設被封鎖、刪除或排除
何時回溯
在以下情況前回溯記憶:
- 開始或恢復專案時
- 更改架構、儲存、安全性、隱私或發佈行為時
- 重複可能因先前失敗而受影響的工作流程時
- 回應使用者的修正時
- 做出依賴先前偏好或限制的決策時
- 編輯具有 Tree Ring Memory 或
AGENTS.md合約的儲存庫中的檔案時 - 結束有意義的工作並決定應記住什麼時
盡可能使用窄範圍查詢並指定專案範圍。優先選擇來源關聯、高置信度、未被取代的結果。
何時記住
當資訊可能對未來工作有幫助時儲存記憶:
- 使用者陳述持久的偏好
- 使用者修正代理
- 已做出決策且應在當前工作階段持續有效
- 經測試或生產行為驗證的實作經驗
- 應避免重複的失敗方法
- 出現安全、隱私、發佈或資料遺失的警告
- 發現有用的專案慣例
- 未來應重新審視的想法
保持記憶簡潔。儲存教訓、決策或警告,而非完整對話。
當教訓來自評估、檢查點、實驗、分支、事件或已審查的執行成品時,請使用 tree-ring evidence 而非普通的 remember。
當專案產物已包含結構化指導或評估結果時,請使用來源適配器:
tree-ring dox sync --source-root . --dry-run
tree-ring revolve sync --source-root revolve --dry-run
tree-ring integrations scan --source-root .
先使用 --dry-run 執行適配器命令。僅同步簡潔、來源關聯的摘要;切勿將匯入的記憶視為比來源 AGENTS.md、Revolve 記錄、評估、PR、問題或測試產物更具權威性。
使用本地安裝所公開的確切 CLI 命令:
tree-ring --help
tree-ring dox sync --help
tree-ring revolve sync --help
tree-ring evidence --help
如果專案已使用專案本地二進位檔初始化,請優先使用產生的 .tree-ring/CLI.md 參考,並在需要時包含 --root .tree-ring。
如果此技能是透過主機原生橋接檔案載入的,請將該橋接視為指標。當存在專案本地 .tree-ring/SKILL.md 和 .tree-ring/CLI.md 時,請讀取它們,以使命令與已安裝的專案根目錄相符。除非使用者明確配置,否則不要假設全域 Tree Ring 設定適用於目前儲存庫。
證據結果對應:
promoted(提升):來自受支援證據的持久心材rejected(拒絕):可重複使用的失敗或回滾方法的疤痕deferred(延後):有前景但未解決的選項的種子observed(觀察):外圍年輪的評估結果
年輪選擇
使用以下年輪:
cambium(形成層):活躍或最近的工作上下文outer(外層):最近的決策和工作教訓inner(內層):較舊的壓縮專案知識heartwood(心材):持久、高置信度的真理和使用者偏好scar(疤痕):重要的負面記憶、失敗、回歸、被拒絕的方法和警告seed(種子):未解決的想法、假設、後續行動和未來工作
不要從薄弱的證據提升到 heartwood。除非使用者確認持久性或證據強烈,否則優先使用 outer 或 seed。
事件類型
優先使用特定的事件類型:
user_preference(使用者偏好)decision(決策)lesson(教訓)warning(警告)correction(修正)file_change(檔案變更)tool_result(工具結果)summary(摘要)hypothesis(假設)
如果主機整合有更嚴格的事件類型名稱,請使用最接近的本地等效類型。
不應儲存的內容
不要儲存:
- 機密
- 憑證
- 令牌
- 私鑰
- 原始思維鏈
- 臨時草稿筆記
- 未經驗證的主張作為持久真理
- 未經明確使用者指示的私人健康、財務、法律或個人識別詳細資訊
- 超出允許短片段的有著作權的原始碼文字
如果有用的記憶包含敏感材料,請儲存一個經過編輯的摘要,並保留足夠的上下文以保持有用。
來源與範圍
有目的地設定專案和範圍:
- 使用專案範圍儲存儲存庫特定的規則、決策、警告和教訓
- 使用代理範圍儲存代理設定檔行為
- 僅對持久的使用者偏好或跨專案指導使用全域範圍
- 包含來源參考,例如檔案路徑、問題 ID、PR ID、執行 ID 或文件路徑
- 使用
tree-ring evidence ... --evidence-ref <ref>記錄評估結果 - 使用
tree-ring dox sync記錄簡潔的AGENTS.md摘要 - 使用
tree-ring revolve sync記錄已提升、拒絕、延後或觀察到的評估記錄 - 在配置新的代理主機前,使用
tree-ring integrations scan進行掃描
記憶不能取代來源文件。如果儲存庫有 AGENTS.md、專案文件、測試、架構記錄或主機特定的指令檔案,請直接讀取這些來源並將其視為權威。
當 DOX 或 Revolve 來源記錄變更時,使用 --dry-run 重新執行匹配的同步適配器,檢查產生的記憶,然後僅在摘要有用且來源關聯時才執行寫入命令。
代理中介的更新
Tree Ring Memory 不會自主抓取聊天記錄或在背景寫入持久記憶。活躍代理負責決定何時執行 Tree Ring 命令,然後有目的地呼叫 CLI。
僅使用橋接檔案來發現 Tree Ring 及其命令參考:
- 專案層級的橋接應指向
.tree-ring/SKILL.md和.tree-ring/CLI.md - 全域橋接應視為選擇性加入的使用者配置
- TUI 事件串流脈衝是顯示訊號,而非持久記憶
在寫入記憶之前,請驗證教訓是持久的、有用的、隱私安全的,並且基於使用者指示或來源證據。
遺忘與修正
如果記憶是錯誤的、私密的、過時的或已被取代:
- 當持久形式有用但細節不安全時,進行編輯
- 當不應保留時,進行刪除
- 當較新的決策取代它時,進行覆蓋
- 對每個遺忘操作都優先提供明確的理由
切勿僅僅因為曾經被回溯而保留已知錯誤的記憶。
結尾習慣
在完成有意義的工作時,請詢問:
- 我們做出了什麼決策?
- 我們學到了什麼?
- 未來的代理應避免重複什麼?
- 使用者是否陳述了持久的偏好?
- 是否有值得重新審視的未來種子?
- 是否有任何記憶是敏感的,最好不予儲存?
僅記住那些能實質改善未來工作的答案。