AGENTS.md 项目上下文流程 | AI生成和翻译
现在我清楚了。以下是 AGENTS.md 在 hermes-agent 中作为项目级规则的工作方式：
AGENTS.md 在 Hermes Agent 中的工作方式
项目上下文文件有两个注入点：
1. 启动时：系统提示注入
当你在某个目录中启动 hermes 时，agent/prompt_builder.py::build_context_files_prompt() 会在启动时运行。它会扫描当前工作目录，按优先级顺序查找项目上下文文件（先找到的优先）：
1. .hermes.md / HERMES.md （向上遍历至 git 根目录）
2. AGENTS.md / agents.md （仅当前工作目录）
3. CLAUDE.md / claude.md （仅当前工作目录）
4. .cursorrules （仅当前工作目录）
只有其中一个文件会被加载到系统提示中（最大 20,000 字符）。找到的内容会被包裹上标题 # Project Context — The following project context files have been loaded and should be followed，然后注入到系统提示的 context 插槽中。
与此独立的是，~/.hermes/SOUL.md（你的全局身份/个性）始终单独加载到 stable 插槽中。
2. 运行时：子目录提示发现
这是巧妙的部分。agent/subdirectory_hints.py 实现了一个 SubdirectoryHintTracker，它监控工具调用的发生。当 agent 导航到某个子目录（通过 read_file、terminal、search_files 等）时，跟踪器会：
- 从工具参数中提取目标目录
- 向上遍历最多 5 个祖先层级，查找 AGENTS.md / CLAUDE.md / .cursorrules
- 首次访问某个目录时，加载找到的任何提示文件（每个最大 8,000 字符）
- 将提示文本追加到工具结果中——而非系统提示
这意味着：如果 project/AGENTS.md 包含顶层规则，而 project/backend/AGENTS.md 包含后端特定规则，那么 agent 会在开始处理 backend/ 时获得后端规则——无需修改系统提示（从而保持提示缓存）。
如何使用
在你的项目根目录放置一个 AGENTS.md。以下是 hermes-agent 自身的示例（就是你正在看的这个）：
hermes-agent/AGENTS.md ← 项目级规则
通常包含的内容：
- 开发环境设置（虚拟环境、依赖）
- 项目结构概览
- 如何添加工具/命令
- 测试约定
- 提交约定
- 关键架构决策
–ignore-rules 标志
如果你想跳过所有上下文文件加载（用于批处理、数据生成等）：
hermes --ignore-rules
# 或：HERMES_IGNORE_RULES=1 hermes
这会在 AIAgent 上设置 skip_context_files=True 和 skip_memory=True。
流程总结
会话开始：
CWD/AGENTS.md → 系统提示 "context" 插槽（启动时一次性加载）
~/.hermes/SOUL.md → 系统提示 "stable" 插槽（始终加载）
对话过程中：
Agent 调用 read_file("backend/src/main.py")
→ 跟踪器发现 "backend/src/" 是新的
→ 扫描 backend/src/、backend/、项目根目录寻找提示文件
→ 将找到的 AGENTS.md 内容追加到工具结果中
→ 标记该目录已加载（不会重复）
该设计在保持提示缓存（系统提示在对话中不变）的同时，仍然在 agent 需要时提供项目特定的上下文。