在 AI 编程助手从代码补全转向执行开发任务的过程中，如何让它持续遵守项目规范，成为开发者绕不开的问题。掘金上一篇关于 AGENTS.md 与 CLAUDE.md 的讨论指出，许多开发者把精力放在如何向 Agent 提需求上，却容易忽略把长期规则写入配置文件。支持相关文件的 AI 编程工具，会在会话开始时加载适用规则，使 Agent 在后续任务中按照既定要求工作。
从聊天提醒到规则文件：Agent 需要可复用的项目约束
素材提到，学习者越来越容易忽略 AGENTS.md 和 CLAUDE.md，长期要遵守的规矩常常散落在一次次聊天里。相比临时提示，规则文件更像一份持续生效的项目说明书。素材强调，正式文件名是大写、复数的 AGENTS.md。以 Codex 为例，全局规则负责通用习惯，项目规则负责具体项目；发生冲突时，项目规则优先，不冲突的全局规则继续保留。
新版 Claude Code 也支持 AGENTS.md。如果项目里已有 CLAUDE.md，可以在其中加入 @AGENTS.md，导入同目录下的这份规则，原有有效内容保留。Claude 的个人全局规则放在 ~/.claude/CLAUDE.md，不会自动读取 Codex 的全局文件。修改后开启新会话，可以用 /context 检查 CLAUDE.md 是否出现在 Memory files 列表里，再通过一个小任务观察 Agent 是否按规则执行。
AGENTS.md 该写什么：真实、聚焦、可验收
文章给出的维护思路，并不是把文件写成冗长手册，而是把影响 Agent 行动的关键信息固化下来。项目级文件可以先以50—100行为参考，全局文件以30—60行左右为参考；长流程放到单独文档里，规则文件只留下入口。
- 说明项目用途和技术栈，避免 Agent 擅自更换语言、框架或依赖管理工具。
- 列出安装、启动、测试、检查和构建等真实命令，并写明执行目录；命令要从当前项目确认，不能照抄别人的 pnpm。
- 要求 Agent 先查找项目内相似实现，本地没有合适参考时，再查官方文档或 GitHub 公开项目。
- 明确改动范围和权限：授权内直接执行，超出范围再确认；不能顺手修改无关模块，也不能把私有代码和内部数据带到公开网站。
- 避免过度防御：不为理论上的极端情况堆出复杂系统；先说明真实风险和依据，再决定是否增加复杂度，必要的安全检查不能省略。
- 沿用现有命名、目录、错误处理和测试方式，减少每次任务都发明新风格的情况。
- 遇到卡点时说明缺少什么信息、已经尝试了什么、下一步准备怎么做，而不是悄悄绕远路。
- 完成时要给出实际验收信息：修改了什么、运行了哪些检查、哪里没有通过；没有运行的检查不能写成通过。
这些内容共同构成一份长期约定，使开发者不必在每次会话开始时重复交代相同要求。
模板与接入：先扫描项目，再增量合并
素材提供了一份项目级模板，包含项目定位与技术栈、常用命令、结构与代码模式、项目边界与验收等部分。文件建议放在项目根目录，也就是项目最外层的文件夹。已有 AGENTS.md 的项目，应采用增量合并方式，不建议用模板覆盖旧约定；不适用的条目可以删除，方括号中的占位内容需要替换为真实信息。
如果开发者不清楚如何填写，可以让已经打开项目的 Agent 先分析，再协助补全。素材给出的提示词强调安全边界：先读取已有 AGENTS.md、CLAUDE.md 及相关子目录规则，再查看 README、依赖配置、锁文件、测试和构建配置；每条命令注明来源、执行目录以及是否实际验证；找不到的信息列为待确认，不编造命令、路径或结果；只返回扫描结果和增量合并方案，不改业务代码，不安装依赖，不读取或输出密钥、凭证和私有数据，确认后再写入规则文件。
在全局配置上，原生 Windows 版 Codex 的默认位置是 C:\Users\用户名\.codex\AGENTS.md；如果设置了 CODEX_HOME，则放在该目录下的 AGENTS.md。使用 WSL 时，应放在 Linux 用户目录下的 .codex 中，不要混到 Windows 路径。已有全局文件时，同样建议只合并需要的内容。
对 AI 开发的意义：小文件承担工程化入口
这类规则文件看起来只是一个小文件，却决定了 Agent 每次如何开始、按什么要求执行、什么时候才算完成。当模型能力和工作流复杂度提升后，临时提示词的局限会更明显：它们难以沉淀，也无法在多人、多项目、多工具之间保持一致。
AGENTS.md 与 CLAUDE.md 的价值，在于把开发规范从聊天记录中抽离出来，转化为可复用、可审查、可合并的项目资产。对开发者来说，这意味着更少的重复交代；对团队来说，这也为 AI 参与代码修改、测试和验收提供了更清晰的边界。与其不断研究更强的模型、更复杂的工作流，不如先把这份基础规则写清楚。
原创文章，作者：点点，如若转载，请注明出处：https://www.dian8dian.com/bie-ba-kai-fa-gui-fan-liu-zai-liao-tian-ji-lu-li-agents-md
