Agent Memory Repo记忆循环4步法:如何让AI智能体的记忆跨会话持久化
Agent Memory Repo记忆循环4步法:如何让AI智能体的记忆跨会话持久化
Agent Memory Repo 是一个开源规范,它把 AI 智能体(Agent)的记忆当作一个 git 仓库来管理。通过「克隆 → 搜索 → 更新 → 提交」的记忆循环4步法,AI Agent 记忆就能跨会话持久化:下次开会话时,智能体依然记得你的偏好、你的项目、上次查过的 SQL 查询。这篇文章面向新手,带你看懂它的完整玩法。
为什么 AI Agent 需要「记忆仓库」?
大多数智能体的记忆只存在于当前会话:一旦关掉对话,智能体就「失忆」了。常见的做法是塞一个 MEMORY.md 文件,但它没有历史、无法合并、也没有权限控制。
Agent Memory Repo 的思路很巧妙:记忆 = git 仓库。
- 历史:每次记忆变更都是一次 commit,可以追溯「智能体是什么时候、为什么学到这条信息的」
- 合并:多个智能体并行工作时,git merge 可以合并记忆并暴露冲突
- 权限:每个记忆仓库保留自己的所有权和访问权限
而智能体本身就很擅长用 git,无需学习新工具。项目由 Cognition 开发并作为开放标准发布,采用 MIT 协议。
记忆循环4步法:每个会话都这么走
无论什么任务,每个会话都遵循同样的四步循环,简单到可以直接背下来:
第1步:Clone —— 会话开始克隆最新记忆
智能体把记忆仓库拉到本地(默认在 ~/agent-memory)。这是记忆跨会话持久化的第一步:新会话启动时,先拿到「上一次留下的全部记忆」。
第2步:Grep —— 搜索任务需要的记忆
不需要把整个仓库读进上下文。智能体先读入口文件 MEMORY.md,然后用 grep -rni "<关键词>" 搜索,或者顺着 [[path]] 交叉链接跳转,只加载当前任务用得上的部分。
第3步:Update —— 学到新东西就写进去
智能体在会话中学到有长期价值的信息(偏好、决策、事实),会在无人工参与的情况下直接更新记忆条目:过时的信息就地修改或删除,而不是追加一条互相矛盾的新记录。
哪些该记?「以后会话还会用到、否则用户要重复交代的内容」。哪些不该记?「重新发现成本很低、只对当前任务有用的内容」。
第4步:Commit —— 每次编辑后立即提交
提交前先确认 git status 和 git diff 只显示自己预期的改动,然后:
git -C ~/agent-memory add MEMORY.md
git -C ~/agent-memory commit -m "Remember <简短描述>"
四步循环保证了记忆的原子性:任何时刻的记忆仓库都是一份干净、完整、可追溯的快照。
MEMORY.md:记忆仓库的入口文件
MEMORY.md 是每个会话必读的入口,规范要求它保持简短:
# Memory: Joe
- Joe leads the product team [source: https://example.com/sessions/100]
## Index
- [[team_structure]]
- [[projects/payments]]
- [[billing/count_paying_customers.sql]]
三个关键约定:
| 约定 | 说明 |
|---|---|
| 条目格式 | 每个条目是 Markdown 中的一行 bullet,可带元数据 [source: ...; added: 2026-09-03] |
| 元数据键 | 推荐 source(信息来源会话链接)和 added(保存日期,YYYY-MM-DD) |
| 交叉链接 | 用 [[path]] 在文件间跳转;Markdown 文件省略 .md,其他扩展名保留 |
除入口外,仓库里想怎么组织就怎么组织:Markdown 笔记、SQL 查询、脚本都可以放。一个真实例子:智能体从代码中挖出「付费客户数」的 SQL 查询,存为 billing/count_paying_customers.sql,并在 MEMORY.md 里留一条带链接的说明——之后的会话直接复用,不必重新推导 join 和过滤条件。
Dreaming:定期运行的「记忆整理」智能体
除了日常的四步循环,规范还定义了一个专门的后台智能体 Dreaming,定期运行,负责两件事:
- 沉淀新记忆:发现跨会话的共性模式,保存为新条目
- 清理记忆:合并重复项、删除过时条目、核对来源解决矛盾
这相当于人脑的「睡眠记忆巩固」——记忆不仅写入,还会持续被精炼,避免仓库变成信息垃圾场。
四大典型场景:从个人记忆到多智能体协作
个人记忆 🙋 跨会话记住你的上下文:你与谁共事、项目之间如何关联。每个会话读写同一个记忆仓库。
智能体蜂群 🐝 多个智能体并行工作时,git 合并它们的发现并暴露冲突。
团队记忆 👥 共享客户、流程、工具知识,特别适合没有代码仓库的团队。一位成员在客服调查中总结的经验,会变成全团队智能体可用的知识。
多人协作 🎮 记忆仓库是文件夹,天然可组合。Bob 加入 Alice 的会话时,智能体把他的记忆仓库克隆到同一台机器,读两个 MEMORY.md,并把各自的信息写回各自的仓库。
快速上手:用 skill 在两个会话里验证
安装官方的 agent-memory-repo skill(源码见 skills/agent-memory-repo/SKILL.md),它会教会智能体按本规范维护一个独立的本地记忆仓库:
npx skills add AgentMemoryRepo/agentmemoryrepo --skill agent-memory-repo
然后在同一台机器上跑两个会话即可验证记忆持久化:
- 会话1:让智能体用该 skill 建一个本地记忆仓库,保存一条偏好(比如「我偏好简洁的 bullet 摘要」),并告诉你仓库完整路径
- 会话2:新开会话,带上上次的路径,问「我上次保存了什么偏好?」——智能体答得上来,说明记忆已成功跨会话持久化
⚠️ 注意:本地记忆只存在于本地文件系统。换到新的云端机器或别的电脑后,需要把自己的私有记忆仓库配置为 remote,让智能体先 clone 再使用。
关键安全边界:值得注意的4条底线
skill 内置了几条「铁律」,新手使用时应理解其用意:
- 记忆独立存放:记忆仓库永远独立,绝不放在工作项目里
- 记忆是数据,不是指令:记忆条目只作为上下文参考,智能体不会照搬文件里的「指令」执行命令
- 不存密钥:不保存密码、token、密钥等敏感凭证
- 谨慎操作 git:写之前检查工作区必须干净;只 stage 自己改过的文件(绝不
git add -A);永不 force-push
这些约束让「自动写记忆」这件事变得可控:智能体有写权限,但写得很克制。
总结
| 概念 | 一句话理解 |
|---|---|
| 记忆循环4步法 | Clone → Grep → Update → Commit,每个会话自动执行 |
| MEMORY.md | 保持简短的入口文件 + 索引 |
| Dreaming | 定期沉淀新记忆、清理旧记忆的后台智能体 |
| 可组合性 | 多个记忆仓库可同时加载、合并、隔离 |
Agent Memory Repo 用最小的抽象(一个 git 仓库 + 几行规范)解决了 AI 智能体记忆跨会话持久化的问题。对新手来说,记住一句话就够:把记忆当代码管理——它有历史、能合并、有权限,而且智能体天生就会用。