本篇导读
预计阅读时间：8 分钟。读完你会明白 AGENTS.md 是什么、放在哪里、写什么，并且写出你的第一份规则文件，让 Agent 一次性记住你的所有偏好。
上一节结尾的问题：Agent 每次都要从头交代，怎么解决？这一节讲第一个答案，也是性价比最高的一个：规则文件。
一个文件解决重复交代
你肯定遇到过这种烦躁：每次开新会话都要重复「注释用中文」「别动我的 xxx 文件夹」「改完跑一遍测试」。说了八百遍，它八百遍归零重来。
AGENTS.md 就是解决这个的。它是一个普通的文本文件，你把所有的规矩、偏好、背景写在里面，Agent 每次开工前会自动先读它。相当于给新员工发一本《员工手册》，入职第一天先背一遍。
这个名字不是某个软件的私有功能，而是一个开放规范（Agents.md），目前主流的 Agent 工具都认它。这也是它值得学的原因：写一次，处处能用。
放在哪里：三级体系
AGENTS.md 支持分层放置，Agent 会从上到下依次读取、逐层细化：
| 位置 | 作用 | 例子 |
|---|---|---|
| 全局：用户目录.zcode\AGENTS.md | 你个人的通用偏好 | 「所有回复用中文」「文件名不用空格」 |
| 项目：项目根目录\AGENTS.md | 这个项目的规矩 | 「构建命令是 xxx」「禁止修改 core 目录」 |
| 子目录：子文件夹\AGENTS.md | 更细的局部规则 | 「此目录下的代码必须写测试」 |
全局规则管你所有的项目，项目规则只管这一个项目，子目录规则管局部。离工作目录越近的，优先级越高——就像国家法律、地方法规和小区公约的关系。
在 Windows 上，全局文件就在你的用户目录下：C:\Users\用户名\.zcode\AGENTS.md。你也可以在文件管理器中输入%USERPROFILE%\.zcode\打开所在文件夹，并在里面创建一个名为AGENTS.md的文件，选择用记事本打开或其他支持md文件格式的软件打开，所有的全局规则可以统一放在里面。
写什么：高信号内容
规则文件不是越长越好。Agent 的注意力是有限的，写一堆废话不如写十句要紧的。高价值内容包括：
- 硬性命令：构建、测试、部署的具体命令。这是规范里公认最该写的内容。
- 禁忌清单：绝对不许做的事。「不要动 config 目录」「不要引入新的依赖」。
- 固定偏好：语言、代码风格、文件命名习惯、回复格式。
- 项目背景：这个项目是干嘛的、目录结构、关键文件在哪。
一个真实的最小例子：
# 项目规则
## 身份
- 你是运行在 Windows 环境中的全能助手，资深技术伙伴
## 偏好
- 中文母语，英文用于技术术语精准表达
- 复杂步骤用表格或列表在回复中清晰呈现
## 禁忌
- 批量改动前必须先列方案，等我确认
## 原则
- 不确定时不猜测，先检索或询问用户确认
- 涉及高风险或破坏性操作，必须获得用户授权后再执行就这么朴素的几十个字，能帮你省掉无数次重复交代。
两个实用心得
它是活的文档。 发现 Agent 又犯了某个错？别骂它，把规矩写进 AGENTS.md，下次就不会了。这个文件越养越顺手，是你会反复回来改的东西。
和聊天框的本质区别。 在聊天框里说的话是「一次性的」，写在规则文件里的话是「制度性的」。你所有的长期要求，都应该沉淀到这里，而不是飘在对话里。
下一站
规则文件解决「它不懂我的规矩」。但还有更麻烦的：有些聊过的重要信息，不值得写进全局 AGENTS.md，隔几天它也就忘了。下一节讲记忆系统——Agent 怎么才能真正「记住你」。