跳转到内容

项目指令与 Context Files

Context files 是 Hermes 每次进入项目时会读到的长期说明。它们很有用,也很危险:写得好,agent 更像熟悉项目的同事;写得乱,昨天的临时想法会变成今天的隐形政策。

适合放进 context files 的内容有三个特征:稳定、可复用、影响每次工作。

内容适合程度
项目目录约定适合。
编码风格和测试习惯适合。
安全边界,例如不要读取某些目录适合。
当前任务的临时计划不适合,放任务文档或 issue。
研究材料原文不适合,放内部研究记录。
未审核的草稿不适合,容易污染后续输出。

一个好文件通常短、具体、可维护,而不是把所有聊天记录塞进去。

如果项目已经有 AGENTS.md,可以把它当成跨 agent 的项目规则。.hermes.md 更适合 Hermes 特有的使用说明,例如启用哪些工具、偏好的会话习惯或 Hermes 专用限制。

# 项目规则
- 公开文档只放在 src/content/docs/。
- 研究记录和临时判断放在内部目录。
- 未明确要求时,不运行测试或构建命令。
- 修改公开页面时,不要写入内部工作说明。

规则要直接告诉 agent 怎么行动。不要写“保持专业”“认真思考”这类无法检查的句子。

Hermes 支持通过 SOUL.md 或 personality 影响默认语气。它适合写个人偏好和交互风格,不适合写项目安全规则、部署步骤或代码规范。

把风格和规则分开很重要。风格可以因用户而变;项目规则应该可审查、可版本化、可团队共享。

当任务需要某份文件、diff、URL 或目录,优先用明确引用,而不是把大段内容复制到 prompt 里。这样 Hermes 更容易定位来源,也更容易避免把临时材料永久写进 context files。

对技术文档项目尤其重要:公开页面应该直接回答读者问题,临时研究、工作记录和未确认判断都应该留在内部目录。

Context files 不是写完就不管。出现这些症状时要检查它们:

  • Hermes 每次都带回同一个旧假设。
  • 输出里出现不该公开的内部措辞。
  • 它总是运行你已经不想运行的命令。
  • 它忽略了新的目录约定或发布流程。

不要用更长 prompt 对抗坏 context。删掉或改掉源头。