上一讲做网页时你可能发现了：每开一个新对话，都得重新交代一遍"只用一个文件、回复用中文、改完告诉我怎么打开"。这一讲解决这个问题——给 AI 写一份项目说明书。Claude Code 叫它 CLAUDE.md，Codex 叫它 AGENTS.md。写一次，它每次开工前都会先读。

它是什么

项目说明书 ＝ 你给 AI 新同事的入职文档。项目是什么、怎么跑、有什么规矩、哪里不能碰，写清楚，它就不用每次问、你也不用每次说。

全局那份适合写"回复用中文""我是新手，解释得通俗点"这种个人习惯；项目那份写这个项目自己的事。

拼一份说明书

一份好用的说明书，通常由这几块组成。点一点，看它拼起来的样子：

注意看"踩过的坑"：这是说明书里最值钱的一块。每次 AI 犯了一个错、你纠正了它，就顺手写进来，它以后就不会再犯。

写成这样才管用

• 短。它每次开工都要读一遍，越长越占额度、越容易抓不住重点。一页纸以内最好。
• 具体。写命令、写路径、写例子，不写形容词。
• 常更新。项目变了、规矩变了，说明书跟着改，过时的信息比没有更害人。
• 不放秘密。密钥、密码不写进去，说明书常常会跟着代码一起提交。

两个工具共用一份

同时用 Claude Code 和 Codex 的，不用写两遍。规矩写在 AGENTS.md 里，然后在 CLAUDE.md 里只写一行，让 Claude Code 把它引进来：

@AGENTS.md

## 只给 Claude Code 的补充
- 【比如：动手前先进计划模式，把方案给我看】

Claude Code 的说明书支持用 @文件路径 引入其他文件，同一份规矩，两个工具都能读到。

课后动手

• 在上一讲的番茄钟文件夹里运行 /init（或让 Codex 写一份 AGENTS.md）。
• 读一遍它生成的草稿，删掉空话，补上至少一条"禁区"和一条"完成标准"。
• 在全局说明书里写上你的个人习惯，比如"回复用中文"。
• 开一个新对话，让它改一处，看它有没有按说明书来。

好的说明书，让 AI 第一天上班就像干了一年的老员工。