AI 编程用久以后，很多人的问题不是“不会提示词”，而是规则散得到处都是：Cursor 里写一份，Claude Code 里写一份，Codex 项目里又写一份。刚开始还能靠记忆维护，项目一多，就会出现 AI 读错目录、忘记测试、重复解释同一套发布流程的问题。
所以今天这篇不再讲某一个工具的入门教程，而是讲一个更底层的问题：AI 编程项目规则到底怎么分层，AGENTS.md、CLAUDE.md、Cursor Rules 和 Codex 项目指令应该各自放什么。
先把规则分成三层
不要把所有要求都塞进一个文件。更稳的做法，是把项目规则拆成三层：
- 项目事实层：项目定位、目录结构、运行方式、测试命令、发布流程。
- 工具适配层：不同 AI 编程工具如何读取规则、触发规则、执行命令。
- 任务临时层：本次要改什么、不改什么、验收标准和风险边界。
项目事实层要尽量稳定，适合放在仓库里长期维护；工具适配层要尊重每个工具自己的读取机制；任务临时层则应该放在当次对话或任务说明里，不要永久沉淀成项目规则。
AGENTS.md 适合写什么
AGENTS.md 更适合作为“面向执行代理的项目说明”。它应该告诉 AI：这个项目是什么、哪些文件能改、发布前要检查什么、哪些命令不能乱跑。
比如老达AI博客项目里，AGENTS.md 就适合写 WordPress 发布规范：正文不要写 h1、每篇文章要有摘要、SEO meta、特色图 alt、站内链接和发布后检查。这类规则不是某个工具的偏好，而是项目本身的质量门槛。
如果你正在用 Codex 做网站维护、脚本修改或自动化发文，可以把 AGENTS.md 当成项目级操作手册。更完整的发布流程可以参考 AI 自动发布 WordPress 文章流程，那里讲的就是把分散动作变成可检查规则。
CLAUDE.md 适合写什么
Claude Code 官方推荐用 CLAUDE.md 存放项目记忆。它适合写 Claude 需要长期知道的工作方式，比如项目上下文、常用命令、代码风格和团队约定。
如果你的项目已经有 AGENTS.md，不建议再手动复制一份到 CLAUDE.md。更实用的方法是让 CLAUDE.md 只写 Claude Code 特有的补充规则，并用导入方式引用通用项目说明。这样项目事实只维护一处，减少两份文件越改越不一致。
例如：
# CLAUDE.md
@AGENTS.md
## Claude Code 补充约定
- 修改前先阅读相关模块，不直接重写大段代码。
- 涉及多文件修改时，先给出简短计划。
- 停止前说明测试结果和未验证项。
如果你想系统理解 Claude Code 的记忆机制，可以继续看 Claude Code 项目记忆怎么写。
Cursor Rules 适合写什么
Cursor Rules 更适合约束编辑器内的代码协作。它的重点不是“项目全局运营规则”，而是让 Cursor 在写代码、改组件、补测试时遵守项目规范。
比如前端项目可以写组件命名、目录分层、样式约定、测试位置；后端项目可以写 API 分层、错误处理、日志格式。不要把 WordPress 发文规范、服务器密码位置、运营流程都塞进 Cursor Rules，除非 Cursor 确实会参与这些任务。
这类规则可以和 Cursor Rules 实战模板 配合使用：一个文件管通用编码风格，几个局部规则管具体目录。
Codex 项目指令适合写什么
Codex 更常见的价值，是把任务从“回答问题”推进到“读文件、改代码、跑命令、验证结果”。所以 Codex 项目指令要写清楚执行边界：默认用什么命令、什么时候需要检查、哪些文件不能碰、最终怎么汇报。
这和 AI编程工具专题 里反复提到的一个原则一致：AI 编程工具不是越自由越好，而是边界越清楚，执行越稳定。
一个可落地的分层模板
如果你想今天就整理项目规则，可以按下面这个顺序做：
- 先把项目事实写进 AGENTS.md：定位、目录、命令、质量检查、禁区。
- 在 CLAUDE.md 里导入 AGENTS.md，再补 Claude Code 特有工作方式。
- 在 Cursor Rules 里只写编辑器内真正会用到的代码规范。
- 在每次任务说明里写临时边界：这次改什么、不改什么、怎么验收。
- 每月复盘一次，把重复出现的临时规则沉淀到项目事实层。
如果你担心 AI 还是读错上下文，可以搭配 AI编程上下文管理清单，把“该读哪些文件、不该猜哪些信息”也写进流程。
常见错误
错误一：一份规则到处复制
复制最省事，但后期最容易失控。项目事实应该尽量只有一个源头，其他工具文件只做引用和补充。
错误二：把任务需求写成永久规则
“今天只改首页”不应该写进项目规则；“修改页面前检查移动端布局”才适合沉淀。
错误三：规则太长，AI 反而抓不住重点
项目规则不是百科全书。真正重要的是边界、命令、验收标准和禁区。背景故事、个人偏好和临时想法，放在任务说明里更合适。
老达建议
AI 编程项目规则的目标，不是把 AI 训练成完全懂你的所有习惯，而是让它在关键动作上少犯错：少读错文件、少漏测试、少乱改范围、少忘记发布检查。
我的建议是：先从一个项目开始，整理一份短而清楚的 AGENTS.md，再按工具补 CLAUDE.md 和 Cursor Rules。等这套分层跑顺以后，再迁移到其他项目。你也可以把这篇和 普通人AI实践专题、AI编程验收清单 一起看，把规则、任务和验收连成一条完整链路。
