AGENTS.md 在 Agent 上下文中的位置、读取时机和最佳写法

AGENTS.md：Agent 的"第二指令层"

理解它在 context 中的位置，才能写出真正有效的指令

1
什么时候被读取？
Agent 不是在你提到 AGENTS.md 时才去读它——它是自动的、最先的、每次都读的。
你在终端输入 claude 启动 Agent
Agent 框架启动，加载系统指令
Agent 自动扫描当前目录
寻找 CLAUDE.md / AGENTS.md / .cursorrules 等文件
找到了 → 自动读取，注入到上下文最前面
你还没开口说话，Agent 就已经读完了你的"规矩"
你开始输入任务指令
Agent 在 AGENTS.md 的规矩约束下，执行你的任务
下一次对话开始时
再次自动读取——每次新会话都重新加载，不会遗忘
关键：你不需要告诉 Agent "去读 AGENTS.md"——它会自己读。只要文件放在项目根目录，名字对了，Agent 每次启动时都会自动注入。
2
在上下文（context）里占什么位置？
Agent 的"大脑"有一个上下文窗口——它能同时看到的所有信息。这个窗口有大小限制，也有优先级层次。越靠前的内容，影响力越大。AGENTS.md 占据了非常靠前的位置。
Agent 的上下文窗口（从上到下 = 从先到后）优先级 ↓
最高
系统指令 框架内置
Agent 框架自带的底层指令（你看不到也改不了）。定义了 Agent 的基本能力和安全边界。
第二
⭐ AGENTS.md / CLAUDE.md 你写的
就在这里！紧跟系统指令之后，在你说的任何话之前。
Agent 的每一次思考和行动，都在这一层的"规矩"约束下进行。
↑ 上面的内容"永远在线"，影响 Agent 的每一次响应 ↑
第三
你的对话指令 你说的话
你在对话框里输入的任务要求，比如"帮我写周报"。
第四
对话历史 动态累积
之前的对话来回。越来越多，最旧的可能被截断。
第五
读取的文件内容 按需加载
Agent 用 cat 读取文件后，文件内容加入上下文。只有读了才有，没读就没有。
最低
工具执行结果 按需加载
Agent 运行命令、搜索网页等工具的返回结果。
为什么这个位置重要？因为它在你说的每一句话"之前"就已经存在了。不管你后续给什么任务，Agent 都会在 AGENTS.md 的约束下执行。它是"底色"，不是"临时指令"——相当于员工入职时刻在脑子里的公司规章，而不是某天领导交代的某个具体任务。
3
利用好这个位置，该写什么？
既然 AGENTS.md 是"永远在线"的底层规矩，那它适合放所有任务都通用的规范，而不是某一次任务的具体要求。
输出风格
  • 用什么语言（中文/英文）
  • 语气正式还是轻松
  • 数据精确到什么程度
  • 要不要用 emoji
  • 段落长短偏好
红线与禁区
  • 哪些文件不能动
  • 哪些目录不能写入
  • 不能删除任何文件
  • 不能编造数据
  • 不能安装未经允许的依赖
文件操作规范
  • 产出统一放到 output/ 目录
  • 文件命名格式：类型_日期.md
  • 数据从 data/ 目录读取
  • 引用 reference/ 里的模板格式
项目专属知识
  • 术语表（"KPI"在我们团队指什么）
  • 常见错误提醒
  • 团队惯例（缩写、命名规则）
  • 业务逻辑重点提示
✅ 适合放在 AGENTS.md 的 所有任务都需要遵守的通用规范
"不管做什么，都要用中文回复"
"不管做什么，产出放到 output/"
"不管做什么，不能编造数据"
→ 像宪法一样，长期有效
❌ 不适合放在 AGENTS.md 的 某一次任务的具体要求
"帮我生成本周周报"
"分析这个 CSV 文件"
"把第三段改短一点"
→ 这些是临时指令，直接在对话里说
一个写得好的 AGENTS.md 示例
# Agent 工作规范

## 语言与风格
- 始终使用中文回复和生成文件
- 语气正式、简洁，不使用 emoji
- 数据精确到个位数，百分比保留一位小数

## 文件操作规范
- 所有产出文件放到 output/ 目录
- 文件命名格式：内容_MMDD.md
- 数据从 data/ 目录读取，用程序计算，不要凭记忆编造数字
- 参考 reference/ 目录下的历史文档格式

## 禁止事项
- ❌ 不要删除任何已有文件
- ❌ 不要修改 data/ 和 reference/ 目录下的文件
- ❌ 不要安装系统级软件包
- ❌ 不要在输出中使用未经数据验证的结论

## 项目知识
- "KPI" 在本团队专指粉丝增长目标
- 本月目标：全平台 16 万粉丝
- 周报固定格式：数据概览 → 亮点 → 各平台详情 → 竞品 → 下周计划 → 待跟进
- 老板特别关注抖音数据和竞品动态

## 工作流程
1. 先读 README.md 了解项目背景
2. 再读本文件了解工作规范
3. 然后根据用户指令执行任务
4. 完成后自查：是否遗漏老板要求？数据是否从 CSV 计算？格式是否与历史一致？
写 AGENTS.md 的心法：想象你雇了一个能力很强但对你的项目一无所知的新员工。你不需要教他怎么思考（模型已经很聪明），你需要告诉他的是：我们这里的规矩是什么、哪些雷不能踩、产出要长什么样。写完后问自己：如果 Agent 严格按照这些来，产出的东西是不是就是我想要的？