在 Hermes 中使用你的 AgentSoul 文件

Hermes 无需任何配置，就会读取负责人格的 SOUL.md 和负责项目约定的 AGENTS.md。要使用 AgentSoul 灵魂，把熔铸好的 soul.md 以 SOUL.md 的名字放进 Hermes 主文件夹，让它对每次会话生效；再把 agents.md 里的工作流程写进各个项目的 AGENTS.md。这样一来，处处都是同一个声音，每个仓库又各有合适的规则。

Hermes 如何找到指令

Hermes 会自动发现并加载与代码放在一起的上下文文件，包括 SOUL.md 和 AGENTS.md：文件在，就会影响行为。放在 Hermes 主文件夹里的 SOUL.md，会让每次会话都带着同一个人格——语气、话多话少、在什么事上提出异议。项目里的 AGENTS.md 则记录那些你本来每次都要重复解释的东西：架构决定、命名约定、偏好的库。Hermes 还内置了按会话切换的人格预设；熔铸出的灵魂，是比预设更贴近你个人的选择。

四个文件如何对应到两个

AgentSoul 生成四个文件，而 Hermes 寻找两个。对应关系很直接：

• SOUL.md：以 soul.md 为底，加上 identity.md 中智能体的名字和对声音的简短描述，再补几行 user.md 里关于你喜欢的回答方式和智能体可访问范围的内容。
• AGENTS.md：以 agents.md 为骨架——使命、角色、步骤、升级规则——再加上项目自己的约定。
• 原始的四个文件存在一个稳妥的文件夹里，作为日后修改的源头。

具体步骤

1. 在干将 App 里打开你的灵魂，点“获取四个文件”，再点“发送到电脑”，隔空投送、存储到“文件”或用邮件发给自己。
2. 在主目录的 .hermes 文件夹里新建 SOUL.md，以 soul.md 为底，并入 identity.md 和 user.md 的要点。
3. 在常用 Hermes 的项目根目录新建或打开 AGENTS.md，加入 agents.md 的步骤和升级规则。
4. 开启新的 Hermes 会话，请它说说自己怎么工作、看重什么。
5. 按需调整。嫌它太啰嗦或太谨慎，就改掉 SOUL.md 里对应的那一行。

全局的声音，本地的约定

这样分层的好处在于，人格和流程的变化节奏不同。你的灵魂——性情、价值、它要警惕的阴影——很少改变；项目约定则经常变，而且每个仓库都不一样。把两者分开，打磨一次灵魂，所有项目都受益；每个项目又保留只在那里才有意义的规则。如果你需要在不同角色间切换，比如严谨的代码审查者和天马行空的头脑风暴伙伴，就各熔铸一个灵魂，会话前替换 SOUL.md。

灵魂好像没加载？

• 检查文件名。Hermes 寻找的是大写的 SOUL.md；仍叫 soul.md 的文件，未必会在你预期的位置被读到。
• 检查位置。全局灵魂应当放在主目录的 .hermes 文件夹里，而不是某个项目的子文件夹。
• 开启新会话。上下文文件在会话开始时读取，会话中途的修改要到下一次才生效。
• 排查相互冲突的指令。同一项目里如果有描述另一种语气的 CLAUDE.md 或 .cursorrules，智能体会被拉向两个方向。
• 直接问它。“你的 SOUL.md 对你应该怎样回应我是怎么说的？”——这是查看 Hermes 实际加载了什么的最快办法。

保持精简

臃肿的上下文文件比没有还糟，因为每一行都会出现在每一次提示里。AgentSoul 的文件是写给人读的，带着不少解释。给 Hermes 用时，只留精华：一段性格描述、价值排序、阴影，再加两三条你希望被怎样对话的偏好。也请记住，灵魂背后的解读是 AI 生成的假设，不是诊断——合身的留下，其余删去。