用途:本技能用于掌握 Hermes Agent 的上下文文件系统,包括优先级加载机制、AGENTS.md 渐进式发现、SOUL.md 特殊地位与安全处理,适用于需要配置项目上下文或理解文件加载顺序的场景。
主要能力:系统自动发现并加载配置文件来塑造 Agent 行为。支持类型包括 .hermes.md/HERMES.md(最高优先级,向上查找至 git 根)、AGENTS.md(当前目录及子目录渐进发现)、CLAUDE.md(Claude Code 兼容)、.cursorrules 与 .cursor/rules/*.md(仅当前目录)、SOUL.md(仅从 HERMES_HOME 加载,始终作为身份槽位 #1)。
加载规则:采用 first match wins,每个会话只加载一个项目上下文类型,按 .hermes.md → AGENTS.md → CLAUDE.md → .cursorrules 顺序检测,优先级不可自定义;SOUL.md 独立始终加载,不受优先级影响。AGENTS.md 采用渐进式发现,Agent 读取子目录文件时才注入该目录的 AGENTS.md,以减少提示词膨胀、保留前缀缓存并提升上下文相关性。
安全处理:文件内容依次经过 UTF-8 编码验证、提示注入扫描、长度检查;超过 20,000 字符时按约 70% 头部加 20% 尾部截断。常见问题包括文件名大小写不符、被更高优先级文件覆盖、子目录 AGENTS.md 未被触发、SOUL.md 需编辑 ~/.hermes/SOUL.md 并重启会话。建议将 AGENTS.md 纳入版本控制。