告别AI健忘症：用四个文件给Claude Code装上外挂记忆
大家好，我是提米哥。今天我们来聊聊让很多开发者头疼的问题：AI总是记不住教训。
如果你给AI同一个项目，但它不记得昨天踩过的坑，今天它大概率还会在同一个地方绊倒。解决办法不是换个更聪明的模型，而是给它建一套“基于文件的外挂记忆”。
先澄清一个误区：“能不能直接给它喂个摘要？”不行。摘要的前提是你已经知道什么最重要。但昨天的你，并不知道今天会发生什么问题。所以，记录必须是原汁原味的原文，而且要把它们拆分开来，方便查找。
1. 四个核心文件结构
我们通过四个文件来搞定这套记忆系统：
memory/diary.md（工作日志）：按时间顺序记录工作背景。每次对话开始时读取。memory/mistakes.md（错题本）：只记录人类指出的错误。每次对话开始时读取。memory/MEMORY.md（核心地图）：记录不变的事实。每次对话开始时读取。memory/HANDOFF.md（交接班笔记）：记录当前状态和下一步要做什么。优先读取。
工作日志（diary.md）。每次对话积累几行：“什么时间，做了什么，为什么，结果如何”。加上日期标题（比如 ## 2026-08-07 ...），方便程序精准提取最近的记录。
错题本（mistakes.md）。格式是关键。
## [2026-08-06] 遇到403报错不查自己的文件，却怪系统
- **出了什么错**: 看到莫名的403报错，三次怀疑是对方系统的问题
- **为什么错**: 跳过了自己能控制的环节（文件格式），先去查别人的问题
- **正确做法**: 先查我的输出，再查我的调用，最后查账号。没确认前说“候选原因”，不要直接说是“根本原因”
只写“我做错了”的记录，是防不住下次再犯的。只有写了第三行（正确做法），这条记录才算有了预防作用。下一次AI只要读到这一行，就能改变行为。
核心地图（MEMORY.md）。单页存放项目里那些不会变的事实（比如项目结构、限制条件、禁止事项）。如果说日记是时间线，那这个就是地图。
交接班笔记（HANDOFF.md）。只写“如果下一次对话不知道这件事，就会出大事故”的内容。
## 当前正在运行的任务
- 每天 09:30 的收集器（验证命令：schtasks /query /tn ...）
## 绝对不能回退的改动
- 弱点评分功能已关闭。实测证据表明就该如此；不要因为“规则上是这么写的”就把它打开
## 等待老板拍板的事情
- 电子书价格，是否参加比赛
这个文件虽然最后才加上，但实际用下来，它成了被读取最频繁的文件。
2. 定规矩：强制“干活前先看记录”
光有记录没用，AI不读就白搭。得用两层手段强制执行：
- 在规则文件里写明：“在修改代码前，必须直接用 Read 工具打开记录文件。”
- 用一个钩子（Hook）从技术上拦截“没读记录就改文件”的行为。
没有第2点的技术拦截，第1点的规则也就是偶尔被遵守。尤其是对话时间一长，规则早就被AI抛到脑后了。
3. 当记录毁了AI的判断（真实事故）
这是最重要的一点。记录是资产，但一旦被污染，就成了负债。
事故过程：自动化巡检脚本产生的日志不断堆积在错题本（mistakes.md）里，AI把这些自动日志当成了“当前需要解决的问题”，把同一个错误答案重复了16次！它一直把一个早就解决的历史问题当成“眼下的大麻烦”。
原因分析：错题本是每次对话都会自动注入的文件。如果自动日志混进去，AI的整个视野就被污染了。
解决办法：按“信号来源”拆分文件。
- 错题本（mistakes.md）：只写人类指出的错误 —— 需要注入
- 工作日志（diary.md）：人类和AI的实际工作记录 —— 需要注入
- 审计日志（audit-log.md）：脚本和定时任务的自动日志 —— 不注入
然后在注入钩子里加个过滤器。
def is_auto_noise(line):
# 检查这行文字里是否包含自动日志的标记词，返回布尔值
return any(m in line for m in AUTO_MARKERS)
过滤器用明确的字符串，不用正则表达式，这是故意的。网撒大了，人类写的内容也会被误伤，视野反而又变窄了。
4. 另一种污染——编码问题
记录文件必须只通过能保证 UTF-8 编码的路径来写（也就是AI自带的文件工具）。在 Windows 上，用 Shell 重定向（比如 echo ... >> diary.md）写文件很容易弄乱编码。要是每次都注入乱码记录，你就等于养了一个“记忆受损”的AI。
5. 什么时候写记录？
如果你把“写记录”这个指令打包成一个必走的流程，就不会漏掉任何一步了。
比如原本有个流程的第三步（写交接班笔记）老是被跳过，最后干脆把它变成了一个自动钩子：如果代码提交成功了，但交接班笔记今天没更新，就会弹出通知提醒你。
想要完整系统？这本书有10章加4个拿来即用的模板（CLAUDE.md启动模板、记忆文件、审计清单、测量指南），每章都有实操部分。PDF版售价9.99美元。
直达网址：https://dbsoul.gumroad.com/l/autonomous-ai-agents-claude-code
