---
url: 'https://aisee.wiki/learn/agent-memory/index.md'
---
# Memory：让 Agent 带着上下文持续工作

Memory 让 Agent 不只依赖当前一句 prompt，而是能在不同层级读取和复用上下文。但 memory 不是事实真理，仍需要项目文件、官方文档和当前任务校验。更准确地说，它不是“万能长期大脑”，而是 Agent 进入任务时要读取的一组分层上下文。

## 为什么需要 Memory

如果每次协作都要从零开始重新描述项目结构、风格约束、安全边界和历史决策，Agent 很难稳定进入状态。Memory 的价值就在这里：它把那些会重复出现、又不适合每次都重新手写的上下文沉淀下来。

但这不意味着 Agent 会“永远记住一切”。在工程场景里，更准确的理解是：

* 当前任务负责方向
* 项目文件负责事实
* 规则负责约束
* Memory 负责帮助 Agent 更快进入正确状态

## 上下文层次

| 层次 | 典型内容 | 用途 | 边界 |
|---|---|---|---|
| 当前会话上下文 | 用户最新目标、执行状态、刚跑过的命令 | 保持本次任务连续 | 最新消息优先，旧上下文可能过期 |
| 项目规则 | `AGENTS.md`、项目工作流、禁止操作 | 约束 Agent 如何在本仓库工作 | 规则不能替代事实检查 |
| 项目记忆 | `.memory/rules.md`、`.memory/index.md`、长期偏好 | 复用本项目长期有效决策 | 需要索引和审查，不能无限堆 |
| 全局记忆 | 用户跨项目偏好、常用表达、长期习惯 | 减少重复沟通 | 不应覆盖项目规则和当前任务 |

这四层不是并列投票，而是有优先级的。你可以把它理解成一个读取顺序：

1. `当前消息`
2. `项目文件事实`
3. `项目规则`
4. `项目记忆`
5. `全局记忆`

越靠前，越直接决定本轮任务。越靠后，越偏辅助进入状态。

## Codex 中的读取顺序

在一个 Codex 协作项目中，`AGENTS.md` 通常提供项目级指令，`openspec/project.md` 提供项目上下文，`.memory/rules.md` 和 `.memory/index.md` 管理项目记忆，当前线程记录任务进度和刚刚发生的决策。

一个更实用的理解顺序是：

1. 用户当前消息决定这轮到底要解决什么。
2. `AGENTS.md` 告诉 Agent 在这个仓库里怎么工作。
3. `openspec/project.md` 补项目级技术事实和命令入口。
4. `.memory/index.md` 决定要不要继续读取某条项目记忆。
5. 当前线程再把刚刚的执行结果和判断接回下一轮。

全局记忆更偏“用户长期偏好”：比如回复语言、文档风格、视觉偏好、提交信息习惯。项目记忆更偏“这个仓库长期有效”：比如目录结构、组件约定、OpenSpec 流程、写作口径。

::: tip 优先级
用户当前消息和项目文件优先，其次是项目规则，再看项目记忆和全局记忆。涉及库、API、安装、价格、权限等易变事实时，要回到官方文档或项目源码核对。
:::

## 写入判断

这一步不用再背一份长清单，关键是看两条判断线：

1. `它会不会在未来反复出现？`
2. `它是不是不能简单从项目文件或官方文档直接读出来？`

如果两条都满足，才值得考虑写进项目记忆。

比如下面这些信息通常适合沉淀：

* 这个仓库长期有效的写作口径或组件命名方式
* 团队已经确认过的协作边界和安全习惯
* 某次复盘后沉淀出的上下文加载顺序

而下面这些信息更适合留在别的地方：

* 当前一次任务的临时状态，应该留在当前线程
* 版本号、安装方式、价格这类易变事实，应该回到官方文档
* 代码和 README 已经写清楚的事实，应该直接从项目读取

所以 Memory 更像“高频复用的项目背景”，不是“把所有信息都记下来”。

## Memory 的边界

Memory 应该小、准、可审查。它帮助 Agent 快速进入状态，但不能替代代码、测试、官方文档和人的最终判断。

这篇里最重要的边界有三条：

* Memory 不能覆盖当前用户消息。
* Memory 不能替代项目文件和官方事实源。
* Memory 不能绕过验证和人工审查。

所以 Memory 解决的是“带着上下文进入任务”，不是“替你完成判断”。

## 后续关系

理解了 Memory 以后，后面的文章会分别补这个体系里的其它缺口：

* `Skill`：把经验从“记得住”推进到“可复用”
* `MCP`：让 Agent 能带着上下文去连接外部能力
* `Agent Orchestration`：把 Memory 放回整体协作里看它和 Skill、MCP、Tool、Hook 怎么配合