身份系统 2026年4月17日核验 · 6 分钟
SOUL.md:官方定义的职责边界
来源 官方文档
SOUL.md 真正该做什么
官方指南将 SOUL.md 定义为 Hermes 实例的主身份文件。很多用户的问题不在于不知道它存在,而在于把太多项目级规则也塞了进去。
适合放进去的内容
- 语气与人格
- 沟通风格
- 高层行为边界
不适合放进去的内容
仓库级命令、文件路径、端口与项目流程规则应放到 AGENTS.md,而不是 SOUL.md。在实际使用里,把这个边界守住,会显著减少跨项目行为混乱。
一个好的 SOUL.md 通常包含
- 跨项目都保持稳定的沟通风格
- 少量但持久的行为边界,而不是一大本规则手册
- 足够明确的人格轮廓,但不会僵化到难以协作
为什么大家容易放错地方
SOUL.md 看起来像一个“所有重要东西都可以塞进去”的文件。但越把项目级细节压进去,越难在多个项目之间维持一个稳定身份。官方这个拆分之所以重要,就是因为它能把人格层和项目策略层隔离开。
操作者视角的结论
如果一条规则应该跟着 Hermes 到处走,那就考虑放进 SOUL.md;如果它只在某个 repo 或 workspace 生效,那它大概率属于 AGENTS.md。这个过滤器非常有效。