ARTICLE · 989019
AI 工具不是「健忘」,是你没给它记忆的地方——我用 1 个文件治好了 MiniMax Code 的「失忆症」
AI 工具不是「健忘」,是你没给它记忆的地方——我用 1 个文件治好了 MiniMax Code 的「失忆症」上周我开 MiniMax Code 改 ESP32-P4 固件,前 5 分钟全花在跟它说:esp 军团调度纪律、根目录约束、5 分钟代决兜底机制……开到第 3 个会话,我突然意识到:这不是 AI 的问题,是我的项目缺一个「长期记忆」。 
AI 工具的对话窗口是临时的,任务一结束,上下文就清零。下次开新会话,它看到的就是一个「陌生项目」,得重新摸一遍规矩。 我们以为是 AI 健忘,其实是它没地方存。 AGENTS.md 是一个标准化的项目配置文件,放在仓库根目录。它不是某个 AI 的私有功能,是行业标准 —— OpenCode、Codex、Cursor、Aider、Devin、Gemini CLI、Claude Code,以及 MiniMax Code,都会在打开项目时自动读这个文件。 
核心机制就三条: 只要项目里有 AGENTS.md,所有认这个标准的 AI 工具都能立刻「懂规矩」 —— 不用每个工具单独配一遍。 第一件,工作区约束。 我有个规则:「项目根目录只允许 4 项 —— input/、output/、tool/、AGENTS.md。」这条写在 AGENTS.md 里后,MiniMax Code 进项目就不会再把临时文件、配置、依赖乱丢到根目录。 
第二件,Agent 调度纪律。 我的 ESP32 项目里有套「esp 军团」:esp-dev(写代码)、esp-rev(独立审核)、esp-git(推 Gitea)、esp-doctor(异常诊断)、esp-time(看门狗)。原本每次开新会话都要重新解释「先 esp-time 巡检,再 root 直接拆 brief」。写在 AGENTS.md 里后,root session 不会再绕过 esp-time 直接调下游。 第三件,用户偏好沉淀。 连公众号署名必须用「想法多多的懒人」、不要在文末写「参考来源」整段、不要写 AI 元注释这种细节,我都写进了 AGENTS.md。这样不管哪个 AI 来帮我写公众号草稿,都不会踩我的雷区。 
第一,用祈使句,不要解释。 写「根目录只允许 input/output/tool/AGENTS.md」,不要写「为了保持项目整洁,建议根目录只放……」。AI 不需要你解释为什么,它需要你告诉它做什么。 第二,不要写成「愿景」,要写成「指令」。 「打造一个优雅的项目结构」是愿景,AI 看了不知道下一步。「先 esp-time 巡检,再开下游」是指令,AI 看了立刻知道动作。 第三,每次踩坑就追加一条。 我的 AGENTS.md 已经迭代过 5 版了。每一版新增的,都是某个 AI 实际踩过的坑 —— 比如「不要写 AI 元注释」、「不要在标题里出现「震惊!」字样」、「配图标注每 300-500 字一处」。把 AI 当成新员工:它每犯一次错,你就往员工手册补一条。 过去我把项目知识存在脑子里或 Notion 里,每次和 AI 协作都要「翻译」一遍。AGENTS.md 让我第一次把「和 AI 协作」这件事,变成了「和同事协作」一样的体验 —— 你不用每次重新 onboarding 它,它会自己看员工手册。 
如果你也在用 AI 工具改项目,不妨现在就在根目录建一个 AGENTS.md,从你最常重复的那条规矩开始写起。第一次写会很别扭,写完第二版就回不去了。 你的项目里,有哪些规矩是 AI 每次都要重新听你说一遍的?评论区聊聊,我挑有意思的下次写进我的 AGENTS.md。 觉得有用的话,建议先收藏,下次给项目装「员工手册」的时候翻出来对照。
一、AI 工具不是「健忘」,是你没给它「记忆的地方」
二、AGENTS.md 是什么?为什么 7 个工具都默认读它?
自动加载:你不需要在 prompt 里 @ 它,工具会自己读
优先级最高:它比 system prompt 还先加载,相当于「项目的开场白」
可叠加:根目录写全局规则,子目录写局部规则,层层覆盖
三、我用 AGENTS.md 解决了 3 件具体的事
四、写好 AGENTS.md 的 3 条经验
五、它改变的不只是工作流,是协作方式
晚安,看到这里的都是自己人。 如果你喜欢这种「AI 工具 + 个人项目」的实操视角,点个 【在看】 + 关注,下一篇我会写《AIcheckfile 工作区:从 0 搭一个只允许 4 个目录的项目》,把我的根目录约束详细拆给你看。 —— 想法多多的懒人 · Debug我的后花园