🎈 想读易懂版？

本章有易懂版（大白话讲重点，10 分钟读完）：[第 20 章 记忆系统进阶：长期协作上下文（易懂版）](../../easy/第20章 记忆系统进阶：长期协作上下文（易懂版）.md)

第 20 章 记忆系统进阶：长期协作上下文

本章目标：把记忆从"几条偏好"升级为长期协作上下文——掌握三阶段建设法、记忆治理与隐私边界。记忆是时间的朋友：用得越久，我越懂你；越懂你，每次任务就越省沟通、越少返工。

20.1 从"记住"到"协作上下文"

第 6 章讲了记忆的基础用法。这一章进阶：把记忆从"几条偏好"升级成你和 AI 之间的长期协作上下文——让任何一次新会话，都像老搭档接着聊。

20.1.1 差别的本质

基础用法：记住几条事实（"用户偏好中文"）
协作上下文：完整理解你（你是谁、在做什么、偏好什么、上次聊到哪、有哪些坑）

协作上下文 = 事实 + 决策 + 关系 + 状态。有了它，我在新任务里少问 10 个问题。

20.2 记忆的四种类型回顾

类型	用途	例子
user	关于你	身份、角色、工作背景
feedback	你的反馈	风格偏好、踩过的坑
project	项目上下文	项目目标、决策、现状
reference	参考资料	模板、规范、参考文档

进阶心法：记忆不是"存档"，而是"上下文"。 好的记忆，让我在新任务里少问 10 个问题。

20.3 长期协作上下文怎么建立：三阶段

第一阶段：初始化（一次性投入）

花 10 分钟，把稳定的背景一次说清：

"记住：我是产品经理，主要做 B 端 SaaS；文档偏好结论先行、
中文简洁；所有交付物用 Markdown；我所在项目是 XX。"

初始化解决的问题： 从此不用每次重复自我介绍和偏好。

第二阶段：运行期沉淀（持续投入）

每次任务结束，沉淀一条——把"过程"变成"资产"：

任务做完后 → 记录：项目当前状态、下一步计划、本轮的坑

沉淀的时机（三个最好）：

• 任务完成时（总结成功路径）；
• 任务失败时（记录踩坑教训）；
• 决策变更时（记录原因，避免重复解释）。

第三阶段：定期整理（维护）

• 过期记忆删除或更新；
• 重复记忆合并；
• 索引（MEMORY.md）保持整洁，一条一行。

记忆不维护，就会像仓库一样越堆越乱。 每月花 5 分钟整理一次，性价比极高。

20.4 记忆的最佳实践

值得长期记忆的

• 稳定的工作方式（"我每周五要周报"）；
• 关键决策与原因（"我们选 A 方案因为成本，别再说 B"）；
• 名词解释（团队内部术语，每次都要解释太浪费）。

不值得记忆的

• 一次性数据（放项目文件）；
• 会变的内容（放文件或数据库）；
• 敏感信息（明文记忆文件，不存密钥密码）。

20.4.1 记忆的最佳结构

---
name: 用户工作背景
description: 身份与工作方式
type: user
---

- 身份：产品经理，B 端 SaaS
- 偏好：结论先行、中文简洁
- 常用格式：Markdown
- 项目：MomaWork 白皮书

结构化的记忆（列表/分类）比散文更容易被检索和复用。

20.5 记忆的治理与隐私

20.5.1 治理三原则

原则	做法
透明	记忆文件是明文，你随时可读
可控	随时删除："忘掉 XXX"
卫生	定期清理过期、合并重复

20.5.2 隐私红线

• 记忆文件是明文，放在项目对应目录，你可以随时读；
• 敏感项目：注意记忆文件不要提交到公开仓库；
• 团队协作：共享项目的记忆是团队资产，写入前想清楚；
• 密钥、密码、token 永远不进记忆文件。

安全提醒

记忆不是保险箱。 明文存放，任何人都能读。机密信息要么用环境变量、要么一次性会话处理，用完即弃。

20.6 记忆让"老搭档"成为可能

没有记忆的 AI：每次都是新员工，从头自我介绍
有记忆的 AI：知道你是谁、在做什么、偏好什么、上次聊到哪

这套上下文，是第 17 章 Skill、第 18 章系统、第 19 章自动化的底座——它们都要靠记忆来"认得你"。

20.6.1 记忆 × 其他章节的放大效应

组合	效果
记忆 + Skill	Skill 自动适配你的偏好
记忆 + 自动化	工作流按你的习惯定制
记忆 + 团队	团队成员共享项目上下文
记忆 + 多 Agent	整个系统都"认得你"

20.7 记忆体检：三个月后的样子

三个月后，一份健康的记忆应该长这样：

MEMORY.md（索引，一条一行）
├── user/（3~5 条）：身份、偏好、习惯
├── feedback/（5~10 条）：你的反馈与我的调整
├── project/（若干）：每个项目一行状态
└── reference/（若干）：常用模板、规范

如果记忆超过 50 条还没整理过，说明该体检了。

20.8 练习

1. 花 10 分钟做一次"记忆初始化"：身份、偏好、项目、常用格式；
2. 本周每次任务完成后，沉淀一条 project/feedback 记忆；
3. 周末检查 MEMORY.md 索引，合并重复、删除过期；
4. 检查记忆里有没有敏感信息（密钥/密码），有就立即删除。

---

小结：记忆系统是时间的朋友。用得越久，我越懂你；越懂你，每次任务就越省沟通、越少返工。三阶段建设（初始化→沉淀→整理）+ 治理三原则（透明/可控/卫生），就是长期协作的全部心法。下一篇：让能力落进岗位与行业。