记忆：让工作区文件替它记住

bot 会忘，文件不会。长期运行的 bot 最终都收敛到同一套文件布局。

「记住这个」是建 bot 时最贵的一句话。对话记忆会漂移、被摘要压缩掉、还没法审计。能连续运行几个月的 bot 都靠文件记事：工作区里的普通 markdown，每次运行重读，你和它都能编辑。

四文件布局

长期运行的 bot 最终都收敛到同一个书架：

/workspace
  role.md        —— 这个 bot 是谁：规则与边界
  config.md      —— 盯什么：阈值、偏好
  log.md         —— 处理过什么（已读日志）
  fixes.md       —— 出过什么事、怎么修的

• role.md 是宪法。短（20 行以内）、稳定、每次运行都引用。
• config.md 是数据。bot 可以提议修改；由你批准。
• log.md 是事件的记忆——只追加，每月修剪。
• fixes.md 是错误的记忆。最便宜的提示词改进，就是让 bot 重读自己的事故史。

为什么文件胜过记忆

**可审计。**打开 log.md 就能看到 bot 究竟做了什么。试试审计上下文窗口。

**可编辑。**改错偏好只需改一行——不用谈判。

**可迁移。**把四个文件拷进新 bot，它就继承了一切要紧的东西。大家像寄居蟹搬家一样迁移 bot。

**有边界。**文件的大小看得见；上下文的限额看不见——安静地撞上限，正是例程死亡的方式。

让文件真正生效的模式

开工先读，收工再写。

每次运行开始时重读 role.md、config.md、log.md。汇报给我之前，先更新 log.md。

**日志条目格式。**固定且极简，方便日后修剪：id | 标题 | 日期 | 一行结果。

提议，而不是悄悄重写。

如果你认为 config.md 有错，提议修改并等我确认。绝不擅自修改 config.md。

**按计划修剪。**日志会膨胀成噪音。每月一次：“列出 90 天以上的日志条目，提议归档。“

常见故障

• **不读文件的 bot。**提示词提到 config.md，但 bot「凭上周的记忆」干活。药方：一字不差地写上开工先读规则。
• **静默分叉。**两个 bot 各自维护同一份清单，然后越来越不一样。药方：每个文件一个所有者，其他人只读。
• **长篇小说。**log.md 变成没人看的档案馆。药方：当前日志保持小；旧条目挪去 archive-2026.md。

文件也是让例程安全接上工具的前提：bot 眼中的世界放在你能检查的地方——而不是一份只能凭信的摘要里。