Communitygithub.com

Tree Ring Memory(年輪記憶)

框架無關、本地優先的 AI 代理記憶生命週期管理:Rust CLI、SQLite/FTS 回溯、遺忘、審計、合併、DOX/Revolve 適配器及 TUI。

Tree Ring Memory(年輪記憶) 是什麼?

Tree Ring Memory 是一個生命週期感知的記憶層,專為 AI 代理(如 Claude Code、Cursor、Codex 等)設計。它不記錄完整的對話記錄,而是像樹木的年輪一樣,將有價值的學習資訊分層壓縮保存:近期工作保持詳細,舊知識壓縮成穩定年輪,重要警告形成疤痕,持久真理成為心材,未來想法作為種子。此技能支援所有主流代理平台,並提供 Rust 命令列工具與 TUI 介面。記憶操作包括回溯(Recall)、儲存(Remember)、遺忘(Forget)、審計(Audit)與合併(Consolidate),並透過 DOX 與 Revolve 適配器將專案文件與評估記錄同步為記憶。它強調本地優先、隱私保護,且代理必須主動呼叫命令,不會自動寫入記憶。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add TerminallyLazy/Tree-Ring-Memory

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 事件串流脈衝是顯示訊號,而非持久記憶

在寫入記憶之前,請驗證教訓是持久的、有用的、隱私安全的,並且基於使用者指示或來源證據。

遺忘與修正

如果記憶是錯誤的、私密的、過時的或已被取代:

  • 當持久形式有用但細節不安全時,進行編輯
  • 當不應保留時,進行刪除
  • 當較新的決策取代它時,進行覆蓋
  • 對每個遺忘操作都優先提供明確的理由

切勿僅僅因為曾經被回溯而保留已知錯誤的記憶。

結尾習慣

在完成有意義的工作時,請詢問:

  • 我們做出了什麼決策?
  • 我們學到了什麼?
  • 未來的代理應避免重複什麼?
  • 使用者是否陳述了持久的偏好?
  • 是否有值得重新審視的未來種子?
  • 是否有任何記憶是敏感的,最好不予儲存?

僅記住那些能實質改善未來工作的答案。

相關技能