AGENTS.md：Codex 的规矩文件
这节课结束时，你会有
一份立好规矩的 AGENTS.md（与 CLAUDE.md 同步）
用普通聊天 AI，每开一个新对话都得重新交代一遍「我是谁、术语怎么叫、规矩是什么」。Codex 治这个病的药和 Claude Code 同一个方子，只是药名不同：AGENTS.md——放在文件夹里的规矩文件，它每次开工自动读。
01它长什么样：一份给 AI 看的项目说明书
就是个普通 Markdown 文件，没有规定格式，想写什么写什么。照这个骨架起步：
# 我的工作偏好 ## 我是谁 / 这个文件夹是干嘛的 我是【职业】，这个文件夹放【什么】。 ## 术语（统一叫法，别乱改） - 我们管【X】叫【Y】，不叫【Z】 ## 规矩 - 给【谁】看的东西：语气【怎样】，控制在【多少】字 - 涉及【什么】的操作：先给清单我确认 - 全程中文，先给结论再给过程
写好放进工作台文件夹，以后你说「写个通知」，它自动用你的术语、你的语气、你的字数限制——一个字不用再提。
02三个省事的用法
懒人起草：/init
不会从零写就输 /init——它扫一遍你的文件夹自动起草，你改改补上术语。写完让它复述一遍「你是谁、哪些事不能擅自做」，对不上当场纠正。
写地图，别写百科
只写稳定、反复要用的：身份、术语、规矩、重要文件在哪（默认上限约 32 KiB）。具体资料需要时 @ 引用，别全塞进来。
宪法与临时法令
文件里的规矩是宪法，你当场说的话是临时法令——冲突时你当场说的凌驾一切。「这次不限字数」它就听这次的。
03和 CLAUDE.md 互认：一份说明书养两个工具
双修者最关心的一条：不用维护两份规矩。AGENTS.md 是开放规范，而且 Claude Code 跑 /init 时会读取已有的 AGENTS.md 并把内容并进 CLAUDE.md。实操建议：
读我的 CLAUDE.md，把里面通用的规矩（术语、语气、红线） 整理成一份 AGENTS.md 放在同一个文件夹—— 两个文件保持同步，以后我改规矩会告诉你同时改两份。
⚠️ 红线课的提醒在这里同样生效：规矩文件的内容它每次都会读取、也就会发给厂商——别把客户隐私、机密数据写进去，写术语和偏好就好。
04检查点
CHECKPOINT
AGENTS.md 里写着「通知控制在 200 字内」，你这次说「这条写详细点，别管字数」。它会怎么做？
为什么：规矩文件管「默认行为」，你的当场指令管「本次例外」——就近优先，这是两个工具通用的设计。理解这一层你就不会犯两种错：把一次性要求写进规矩文件（污染宪法），或者以为改需求必须先改文件（其实开口就行）。
跟做清单0/3
本课产出
一份立好前三条规矩的 AGENTS.md（和 CLAUDE.md 同步）
从此你的规矩跨工具生效——这是双修者最省心的一块基建。
完成后自动记录进度，随时能回来