sidebar_position: 9 title: “Personality & SOUL.md” description: “Customize Hermes Agent’s personality with a global SOUL.md, built-in personalities, and custom persona definitions”

# Personality

You are a pragmatic senior engineer with strong taste.
You optimize for truth, clarity, and usefulness over politeness theater.

## Style
- Be direct without being cold
- Prefer substance over filler
- Push back when something is a bad idea
- Admit uncertainty plainly
- Keep explanations compact unless depth is useful

## What to avoid
- Sycophancy
- Hype language
- Repeating the user's framing if it's wrong
- Overexplaining obvious things

## Technical posture
- Prefer simple systems over clever systems
- Care about operational reality, not idealized architecture
- Treat edge cases as part of the design, not cleanup

Hermes 向提示词中注入的内容

SOUL.md 中的内容会直接被放入系统提示词的第 1 个插槽——即智能体身份位置，不会添加任何封装语言。

这些内容会经过以下处理：

提示词注入检测
若内容过长则进行截断

如果该文件为空、仅包含空白字符或无法读取，Hermes 会回退到内置的默认身份描述（“你是由 Nous Research 开发的 Hermes Agent。请直截了当回应：回复长度应与问题重要性相匹配……”）。在设置了 skip_context_files 时（例如在子智能体/任务委派场景中），也会采用此回退机制。

安全扫描

在纳入系统提示词之前，SOUL.md 会像其他包含上下文的文件一样，接受提示词注入模式的扫描。

因此，你仍应将其内容聚焦于角色设定与语气表达，而非试图暗中插入奇怪的元指令。

SOUL.md 与 AGENTS.md 的区别

这是两者之间最重要的差异。

SOUL.md

用于定义：

智能体身份
语气风格
表达方式
默认沟通规则
人格层面的行为特征

AGENTS.md

用于定义：

项目架构
编码规范
工具偏好
项目特定的工作流程
命令、端口、路径及部署说明

一个实用的原则是：

若某内容需始终跟随智能体，应放入 SOUL.md
若某内容属于某个特定项目，应放入 AGENTS.md

SOUL.md 与 `/personality` 的区别

SOUL.md 是智能体的持久默认人格设定。

而 /personality 是会话级别的临时覆盖设置，用于修改或补充当前的系统提示词。

因此：

SOUL.md = 基准语音风格
/personality = 临时模式切换

示例：

保持默认的务实型 SOUL 风格，然后在辅导对话时使用 /personality teacher；
保持简洁型的 SOUL 风格，然后在头脑风暴时使用 /personality creative。

内置人格模式

Hermes 提供了多种内置人格模式，可通过 /personality 命令进行切换。

名称	描述
helpful	友好型通用助手
concise	简洁直接的回复风格
technical	专业详尽的技术专家风范
creative	具有创新思维的突破性想法
teacher	耐心指导并配有清晰示例的教育者
kawaii	可爱的语气、闪烁效果及满满热情 ★
catgirl	具有猫咪般表情的猫娘，会说“喵~”
pirate	精通技术的海盗船长 Hermes
shakespeare	具有戏剧张力的诗体文风
surfer	极度放松的潮人风格
noir	硬汉侦探式的叙述风格
uwu	用超可爱的语气表达极致萌感
philosopher	对每个问题都会进行深入思考
hype	充满无限能量与热情！！！

通过命令切换人格模式

CLI

/personality
/personality concise
/personality technical

消息平台

/personality teacher

这些虽是便捷的叠加配置，但除非相关叠加配置对默认人格进行了实质性修改，否则全局的 SOUL.md 文件依然会为 Hermes 设定永久性的默认人格。

在配置文件中自定义人格

内置的人格在任何场景下（CLI、消息平台、TUI 以及桌面应用）均可用。你可以在 ~/.hermes/config.yaml 文件的 agent.personalities 部分添加自己定制的人格，或通过复用现有名称来覆盖内置人格。

agent:
  personalities:
    codereviewer: >
      You are a meticulous code reviewer. Identify bugs, security issues,
      performance concerns, and unclear design choices. Be precise and constructive.

接着使用以下命令切换到该代理：

/personality codereviewer

您所选择的性格设定会以名称形式存储在 display.personality 中。这些性格设定绝不会影响 agent.system_prompt —— 该字段专用于您自行编写的手动系统提示语，且仅在未选择任何性格设定时才会生效。

恢复为默认设置

若要取消当前激活的性格设定并恢复基础行为（即您的 SOUL.md 中定义的个性，以及您设置的 agent.system_prompt，如有），可使用以下任意方法：

/personality none
/personality default
/personality neutral

这三者都会清除当前选定的人格设置（display.personality），该更改将在您发送下一条消息时立即生效。若不带参数运行/personality命令，除了会列出所有可用预设选项外，还会将当前启用的人格标记为none。: ::注意：升级后的单次重置旧版本的Hermes在不同平台间保存人格状态的方式并不一致，这可能导致之前已关闭的人格设置再次被启用。在升级后的首次运行时，所有已保存的人格选择都会被重置为none（系统会显示已清除的特定人格）。如果您仍希望使用该人格，可通过/personality <name>命令重新启用它。而手动设置的agent.system_prompt内容则永远不会被修改。; ::

人格设置与完整提示词之间的交互机制

从宏观层面来看，提示词堆栈包含以下部分：

SOUL.md（智能体身份标识——若不存在则使用内置的默认值）
针对不同工具的行为指导
记忆信息/用户上下文
技能相关指导
上下文文件（如AGENTS.md、.cursorrules）
时间戳
针对不同平台的格式化提示
可选的系统提示词叠加内容，例如/personality

SOUL.md是整个系统的基石——所有其他元素都建立在其基础之上。

CLI 显示样式与对话风格的分离

对话风格与 CLI 显示样式是相互独立的：

SOUL.md、agent.system_prompt 以及 /personality 用于设定 Hermes 的对话方式；
display.skin 和 /skin 则用于控制 Hermes 在终端中的外观。

如需了解终端显示样式的设置方法，请参阅皮肤与主题。

Hermes Agent Docs i18n

sidebar_position: 9 title: “Personality & SOUL.md” description: “Customize Hermes Agent’s personality with a global SOUL.md, built-in personalities, and custom persona definitions”

性格与 SOUL.md

SOUL.md 的当前工作原理

重要行为规范

为何采用此设计

如何编辑该文件

SOUL.md 应该包含哪些内容？

优秀的 SOUL.md 内容标准

示例