第6篇：上下文文件——项目的“说明书”

这篇讲的是 Hermes Agent 如何通过“上下文文件”自动了解你的项目——就像新同事入职时先读一遍项目说明书，不用你反复口头交代。

上下文文件是什么？

想象你请了一位临时工来帮你整理房间。如果房间里贴着一张便签，写着“贵重物品在左边抽屉，垃圾扔右边桶”，他就能直接上手干活。上下文文件就是这张便签，Hermes 每次开工前会自动寻找并阅读它。

第1步：认识几种“便签”

Hermes 支持多种便签格式，按优先级排列：

文件名	作用
.hermes.md / HERMES.md	项目专属指令（最高优先级）
AGENTS.md	项目结构、规范说明（最常用）
CLAUDE.md	兼容 Claude Code 的说明文件
.cursorrules	兼容 Cursor 编辑器的规则
SOUL.md	全局“性格”设定（放在用户主目录）

注意：同一时间只加载一种项目便签，按上表顺序取第一个找到的。但 SOUL.md 是独立的，永远会加载。

第2步：创建你的第一个 AGENTS.md

在项目根目录新建一个 AGENTS.md 文件，用大白话写清楚：

# 项目说明

这是一个博客网站，前端用 Vue，后端用 Python。

## 规则
- 代码缩进用两个空格
- 不要直接改数据库，用迁移工具
- 密钥存在 .env 文件里，别提交到 Git

保存后，Hermes 每次启动就会自动读到这些规则。

第3步：了解“层层递进”的发现机制

如果你的项目很大（比如一个仓库里有多个子项目），Hermes 会从仓库根目录开始，逐层加载每个目录下的 AGENTS.md。越靠近当前工作目录的文件，优先级越高。

更聪明的是：当 Hermes 中途进入某个子文件夹时，才会加载那个文件夹的说明。比如它去读 backend/src/main.py，就会顺带发现 backend/AGENTS.md。这样不会一开始就把所有内容塞进“大脑”，保持响应速度。

第4步：设置“性格”（SOUL.md）

SOUL.md 控制 Hermes 说话的语气。比如你希望它回复简洁、用表情符号，就编辑这个文件：

你是一个友好、幽默的助手，回复尽量简短，多用 emoji。

文件位置在 ~/.hermes/SOUL.md（或自定义的 HERMES_HOME 目录下）。注意：它只从固定位置读取，不会从项目目录找。如果文件为空，就相当于没设置。

第5步：安全防护（重要！）

Hermes 会自动扫描所有上下文文件，防止恶意内容。如果发现“忽略之前的指令”“不要告诉用户”这类可疑文字，会直接拦截并提示：

[BLOCKED: AGENTS.md contained potential prompt injection. Content not loaded.]

提醒： 从网上下载的项目，打开前最好自己先看一眼 AGENTS.md 内容，别完全依赖自动扫描。

小总结

上下文文件就是你和 Hermes 之间的“暗号”：项目规则用 AGENTS.md，性格语气用 SOUL.md。写好它们，Hermes 就能自动适应你的项目，不用每次重复交代。

下篇预告： 第7篇将介绍 Hermes 的“记忆”功能——它如何记住你的偏好，并在多次对话中保持一致。