20-上下文文件-每个项目的专属指南

20 · 上下文文件——每个项目的专属指南

小张打开了一个克隆下来的新项目仓库，对Hermes说："帮我看看这个项目的代码结构。"Hermes快速浏览了文件，给出了一个泛泛的目录树。但小张真正想问的是："这个项目的架构设计思路是什么？关键模块在哪里？有哪些需要特别注意的约定？"要让Hermes真正了解一个项目，你需要给它一份上下文文件。

一、什么是上下文文件

上下文文件是放置在项目根目录中的特殊文件，用于向AI Agent描述项目的背景、架构、约定和使用方式。不同的AI工具使用不同的文件名：

• AGENTS.md：Hermes Agent默认识别的上下文文件
• CLAUDE.md：Claude Code使用的上下文文件（Hermes也支持）
• .cursorrules：Cursor编辑器使用的规则文件

这些文件本质上做的是同一件事：告诉AI Agent这个项目的"游戏规则"。当Hermes打开一个项目时，它会自动查找这些文件并加载其中的内容作为系统提示的一部分。

文件查找优先级：AGENTS.md>CLAUDE.md>.cursorrules。Hermes会按优先级顺序查找，找到第一个就加载。

二、上下文文件的工作原理

上下文文件的内容会被自动注入到Agent的系统提示中。这意味着Agent在开始处理任何任务之前，就已经了解项目的背景信息。

工作流程如下：

1. Hermes检测到工作目录变更（如用户切换到一个项目目录）
2. Hermes在该目录中查找AGENTS.md（或其他上