Hermes Agent 为什么不读 AGENTS.md？先看启动目录

Hermes Agent 没读到你的 AGENTS.md，最常见不是文件坏了，而是 启动目录不对，或者当前目录里其实先命中了更高优先级的 .hermes.md。官方 Context Files 文档写得很清楚：项目上下文是按启动时工作目录扫描的，而且项目级上下文有优先级，.hermes.md → AGENTS.md → CLAUDE.md → .cursorrules，不是所有文件一起无脑加载。

先查这 3 件事

1. 你启动 Hermes Agent 时，当前目录是不是项目根目录。
2. 当前目录里是否已经有 .hermes.md，它会优先于 AGENTS.md。
3. AGENTS.md 是否放在你真正进入的目录里；子目录规则是“用到时再发现”，不是启动时全盘扫完。

为什么子目录里的 AGENTS.md 一开始没生效

因为 Hermes Agent 采用的是“渐进发现”。启动时先读当前目录的项目上下文，等它真的访问到 frontend/、backend/ 这些目录时，才会把对应子目录的 AGENTS.md 注入进来。

一句话：AGENTS.md 不生效，先看你从哪启动，再看有没有更高优先级文件抢先命中。

官方开源地址：https://github.com/NousResearch/hermes-agent；官方文档入口：https://hermes-agent.nousresearch.com/。