Hermes Agent 没加载子目录 AGENTS.md,先确认它是否真的访问过该子目录。官方 context files 机制会在启动时加载项目根上下文,也会在工具调用涉及某个路径后,沿目录向上查找子目录规则。没碰到路径,就不一定提前加载。
适合 monorepo 的放法
根目录 AGENTS.md 写全局规则,例如包管理器、提交规范、禁止操作;frontend/AGENTS.md 写前端规则;backend/AGENTS.md 写后端规则。这样 Hermes 处理具体路径时,会看到更贴近当前目录的说明。
排查步骤
- 让 Hermes 明确读取目标路径,例如“查看 frontend/src/app 下的实现”。
- 确认子目录文件名是支持的规则文件,例如 AGENTS.md、CLAUDE.md 或 .cursorrules。
- 文件太长会被截断,尽量保持简短。
- 如果被安全扫描拦截,先清理可疑内容。
不要把所有细节塞到根 AGENTS.md。大型仓库更适合“根规则 + 子目录规则”,既减少 token,也能让 Agent 在正确范围内遵守正确规范。