AI编程助手的记忆文件怎么写？

一句话: CLAUDE.md / MEMORY.md 写得好不好决定了新窗口读一句就能写代码还是读完五个文件才能开始。本文用一个真实的改造案例讲清楚怎么写——开箱即用四个字是唯一的标准。适合谁读正在用 Claude Code、Cursor 等 AI 编程工具写代码想让助手少犯错的开发者。问题新窗口读完五个文件才开始写代码我有个嵌入式 C 项目用 Claude Code 写代码。项目的入口文件是 CLAUDE.md——Agent 打开新窗口先读它了解项目结构和规范。但原来的 CLAUDE.md 长这样# 嵌入式固件项目 ## 详细参考 - [编码规范](coding-style.md) - [构建流程](build-workflow.md) - [硬件抽象层](hal-guide.md) - [测试规则](test-rules.md)没了。核心信息全在四个链接里。Agent 打开新窗口 → 读 CLAUDE.md → 发现是目录 → 读 coding-style.md → 读 build-workflow.md → 读 hal-guide.md → 读 test-rules.md → 五个文件读完总算知道怎么写了。每开一次新窗口重复一遍这个过程。每次都要纠正同样的错误。改读第一段就能写代码网上找了一圈 CLAUDE.md 最佳实践核心原则就一条自包含。改完后的 CLAUDE.md 第一段就回答了三个问题Agent 的疑问原来的回答改完后的回答我是谁没说你是固件开发助手用 C 语言Keil MDK干什么没说写驱动→编测试→跑仿真编译用 armcc怎么开始读五个文件才知道立即开始代码块三条命令绝对禁止从散落各处集中到 CLAUDE.md 第四段——不改 HAL 层、不动链接脚本、不碰 bootloader。Agent 不用翻五个文件才能凑齐禁区清单。详细的编码规范、构建流程保留在链接文件里Agent 需要时才翻。但不是一上来就要翻。改造前后对比改之前改之后CLAUDE.md链接目录自包含第一段能写代码启动速度不知道从哪开始立即开始代码块三条命令错误反馈没有纠错机制犯错后立刻更新 CLAUDE.md禁区规则散落各处集中在一个段落代码风格没写变量加 s_ 前缀函数判 NULL五个关键设计1. 第一段就回答三个什么你是谁 → 干什么 → 有什么约束Agent 读完第一段就知道自己的角色、要完成什么任务、什么不能碰。不需要翻页。2. 立即开始代码块直接给可复制的命令不是描述。Agent 看到就能执行。# 编译 armcc -c --cpu Cortex-M3 -g main.c # 跑测试 make test # 烧录 openocd -f board/stm32f4discovery.cfg -c program build/firmware.elf verify reset3. 绝对禁止集中放不要分散到各个文件。Agent 一次读完就知道什么不能碰。典型的代码项目禁区不改 HAL 层自动生成的代码不动链接脚本.ld/.sct不碰 bootloader 目录不提交 .env 和密钥文件不自己加第三方库先问4. 犯错后立刻更新记忆这是最重要的机制。每次 AI 犯了一个会重复犯的错立刻写到 CLAUDE.md 里。例子Agent 每次都在函数里不判 NULL → 加所有公开函数第一行判 NULLAgent 总把结构体名泄漏到代码里 → 加项目结构体名用通用名替代Agent 写的注释又臭又长 → 加注释一行说完不写多行文档注释不做这一步同一个坑踩十次。5. 新窗口的打开语写进项目很多人换了新窗口不知道怎么跟 Agent 说。把标准打开语写在项目 README 里打开 CLAUDE.md然后帮我写 XXX 模块的驱动。或者项目配置了 CLAUDE.md 自动加载直接说需求就行。CLAUDE.md vs MEMORY.md vs AGENTS.mdCLAUDE.mdMEMORY.mdAGENTS.md加载方式Claude Code 自动读取需手动让 Agent 读Cursor/Copilot 自动读取作用域全局→项目→子目录逐级合并自定义目录单文件仓库根目录适合场景Claude Code 用户项目专属持久化记忆多工具团队统一配置如果你的团队有人用 Cursor 有人用 Claude Code建一个 AGENTS.md 再软链接ln -s AGENTS.md CLAUDE.md ln -s AGENTS.md .cursorrules一份内容所有工具都能读。怎么检查你的文件写得好不好打开一个新窗口让 Agent 开始写代码看它第一轮输出好Agent 直接开始写风格对、约束对、没踩禁区差Agent 问这个项目是干什么的用什么编译——入口文件没写清楚很差Agent 开始翻文件、读目录结构、探索项目——你的入口文件就是个目录它在自己找路用这个标准检查一遍改到 Agent 第一段代码就写对为止。实测对比改之前: 新窗口读 5 个文件才能干活 | 改之后: 读 1 段就开始有用的话点个收藏下次调试直接用。有问题欢迎评论区交流看到了都会回。下一篇一天学完15个源文件——DeepSeek看图、AI当老师、AI审查代码、省Token技巧——用AI加速嵌入式开发