tree-ring-memory - SKILL

name: tree-ring-memorydescription: “Use Tree Ring Memory for local-first AI-agent memory lifecycle work: recall, evidence, audit, forgetting, and consolidation without transcript dumping.”category: developmentrisk: safesource: communitysource_repo: TerminallyLazy/Tree-Ring-Memorysource_type: communitydate_added: “2026-07-08”author: TerminallyLazytags: [agent-memory, local-first, recall, privacy, codex, sqlite, cli]tools: [claude, codex, cursor, gemini, antigravity, opencode]license: “Apache-2.0”license_source: “https://github.com/TerminallyLazy/Tree-Ring-Memory/blob/main/LICENSE”Tree Ring Memory年轮记忆概述Tree Ring Memory 是一个与框架无关、本地优先的 AI 智能体记忆生命周期层。当智能体需要回忆、保存、审计或遗忘持久的项目记忆而不把原始对话记录当作记忆时请使用本技能。公开运行时是一个 Rust CLI/TUI具有本地 SQLite/FTS 存储、限定范围的回忆、证据记录、审计、确定性整合、维护、DOX/Revolve 源适配器、框架发现、脱敏redaction和显式遗忘功能。何时使用本技能在恢复一个项目之前使用如果该项目中之前的决策、警告、偏好或失败的方法可能仍然重要。在更改架构、存储、安全、隐私、发布或智能体记忆行为之前使用。当用户要求记住、回忆、审计、脱敏、遗忘或整合智能体记忆时使用。在测试、审查、事故或生产行为验证了未来智能体应保留的经验教训之后使用。当项目包含.tree-ring/SKILL.md、.tree-ring/CLI.md或其他 Tree Ring 桥接文件时使用。工作原理步骤 1发现本地指导检查当前项目是否已有 Tree Ring 指导test-f.tree-ring/SKILL.mdsed-n1,220p.tree-ring/SKILL.mdtest-f.tree-ring/CLI.mdsed-n1,220p.tree-ring/CLI.md将项目本地的.tree-ring文件视为比本技能中的通用示例更具权威性。如果 CLI 已安装在假设标志位之前先检查当前命令界面tree-ring--helptree-ring recall--helptree-ring remember--helptree-ring evidence--helptree-ring audit--helptree-ring forget--help如果 Tree Ring 未安装不要自动运行远程安装命令。请将用户引导到项目仓库或安装文档并询问他们是否需要安装帮助。步骤 2在冒险工作之前先回忆首先使用窄范围、限定项目的回忆tree-ring recallrelease behavior--scopeproject tree-ring recallsqlite migration--scopeproject tree-ring recalluser preference--scopeglobal将回忆到的记忆作为上下文而非权威。在做出更改之前对照当前的源文件、测试、文档、问题、拉取请求、日志和运行时状态进行核实。步骤 3只写入持久的记忆仅在可能对未来智能体有帮助时写入简洁的记忆tree-ring rememberRun project-scoped recall before release changes.--event-type lesson--scopeproject在本地支持的情况下优先使用特定的事件类型decision决策lesson经验教训warning警告correction更正user_preference用户偏好tool_result工具结果summary摘要hypothesis假设存储持久的经验教训、决策、警告或后续事项。不要存储完整的对话。步骤 4为已评估的结果记录证据对测试运行、事故、已审查的更改或其他已评估的结果使用证据记录tree-ring evidence\--outcomeobserved\--summaryInstaller smoke test passed in an isolated HOME.\--evidence-refci/install-smoke/2026-07-08结果指导promoted提升由有力证据支撑的持久事实rejected拒绝失败或已回滚的方法值得保持可见deferred推迟未解决的想法或未来的选项observed观察正常的已评估结果不要将薄弱、过时或未经审查的主张提升为持久事实。步骤 5谨慎使用源适配器当仓库具有结构化的源记录时先运行试运行tree-ring doxsync--source-root.--dry-run tree-ring revolvesync--source-root revolve --dry-run tree-ring integrations scan --source-root.仅当适配器摘要简洁、与源关联、有用且隐私安全时才写入。导入的记忆不会替代底层的AGENTS.md、Revolve 记录、测试、拉取请求、问题或文档。年轮选择使用最符合需求的持久年轮ringcambium形成层活动或近期任务上下文outer外层近期决策和任务经验教训inner内层较早的压缩项目知识heartwood心材持久的、高置信度的事实scar疤痕失败、回归、被拒绝的方法、警告seed种子未解决的想法、假设、后续事项除非用户确认持久性或证据充分否则优先使用outer或seed。最佳实践在冒险或重复工作之前先回忆。保持项目记忆限定于项目范围除非它是持久的跨项目用户偏好。附加源引用如文件路径、问题 ID、PR ID、评估运行或文档路径。在根据回忆到的记忆行动之前重新检查当前的源文件和运行时状态。在收尾时询问未来智能体应记住、避免或重新审视什么。当记忆错误、过时、敏感或已被更新的决策取代时使用脱敏、删除或取代supersession。安全与注意事项切勿将 Tree Ring Memory 用作隐藏的记录器。不要存储机密、凭据、令牌、私钥、恢复代码、原始思维链或临时草稿内容。除非用户明确要求且保留边界安全否则不要存储敏感的个人数据。除非是允许的短摘要否则不要存储受版权保护的源代码文本。未经用户明确批准和明确的目标环境不要运行安装程序、网络、破坏性或变更命令。将所有示例视为需要根据本地--help检查后调整的命令而不是保证可用的命令界面。局限性Tree Ring Memory 不能替代源代码控制、问题跟踪器、文档、测试、日志或实时运行时验证。回忆到的记忆可能过时或错误。在使用它们做出更改之前务必对照当前项目核实重要声明。CLI 界面在不同版本之间可能发生变化。优先使用本地.tree-ring指导和tree-ring --help而不是复制的命令示例。它不应被用于机密存储、全面的对话存档、合规保留或未经审查地收集敏感个人数据。跨智能体互操作性取决于每个工具调用本地 CLI 或读取项目本地指导文件的能力。常见陷阱问题回忆到的记忆与当前源代码冲突。解决方案将源文件、测试、文档和运行时证据视为权威取代或遗忘过时的记忆。问题记忆开始变成对话记录存储。解决方案只存储持久的决策、警告、偏好、结果和后续事项。问题一条经验教训很有用但包含敏感细节。解决方案存储脱敏后的摘要或者干脆不存储。相关技能agent-memory-systems- 用于广泛的智能体记忆架构选择。agent-memory- 用于列出的混合记忆 MCP 系统。planning-with-files- 当简单的持久文件就足够时使用。其他资源Tree Ring Memory 仓库https://github.com/TerminallyLazy/Tree-Ring-MemoryCodex 插件包装器https://github.com/TerminallyLazy/tree-ring-memory-codex-plugin