🏠 Главная › Документация › Возможности

Личность и SOUL.md

Персонализация Hermes Agent полностью настраивается. SOUL.md — это основная идентичность — первый элемент в system prompt, определяющий, кем является агент.

Если вы хотите изменить то, кем является Hermes — или заменить его на совершенно другую персону агента — отредактируйте SOUL.md.

Как SOUL.md работает сейчас

Hermes теперь автоматически создаёт стандартный SOUL.md в:

~/.hermes/SOUL.md

Точнее, он использует HERMES_HOME текущего экземпляра, поэтому если вы запускаете Hermes с пользовательской домашней директорией, будет использоваться:

$HERMES_HOME/SOUL.md

Важное поведение

Это делает SOUL.md настоящей по-пользовательской или по-экземплярной идентичностью, а не просто дополнительным слоем.

Почему такая архитектура

Это сохраняет предсказуемость личности.

Если бы Hermes загружал SOUL.md из той директории, откуда вы его запустили, ваша личность могла бы неожиданно меняться между проектами. Загружая только из HERMES_HOME, личность привязывается к самому экземпляру Hermes.

Это также упрощает обучение пользователей:

Где редактировать

Для большинства пользователей:

~/.hermes/SOUL.md

Если вы используете пользовательскую домашнюю директорию:

$HERMES_HOME/SOUL.md

Что должно быть в SOUL.md?

Используйте его для постоянных указаний по голосу и личности, таких как:

Используйте его реже для:

Они относятся к AGENTS.md, а не к SOUL.md.

Хорошее содержимое SOUL.md

Хороший SOUL-файл:

Пример

# 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 вставляет в prompt

Содержимое SOUL.md помещается непосредственно в слот #1 system prompt — позицию идентичности агента. Никакой обёртки вокруг него не добавляется.

Содержимое проходит через:

Если файл пуст, содержит только пробелы или не может быть прочитан, Hermes использует встроенную стандартную идентичность («You are Hermes Agent, an intelligent AI assistant created by Nous Research...»). Это резервное поведение также применяется, когда установлен skip_context_files (например, в контекстах subagent/делегирования).

Проверка безопасности

SOUL.md сканируется, как и другие файлы с контекстом, на наличие паттернов prompt-инъекций перед включением.

Это означает, что вам всё равно следует сосредоточиться на персоне/голосе, а не пытаться протащить странные мета-инструкции.

SOUL.md vs AGENTS.md

Это самое важное различие.

SOUL.md

Используйте для:

AGENTS.md

Используйте для:

Полезное правило:

SOUL.md vs /personality

SOUL.md — это ваша постоянная личность по умолчанию.

/personality — это наложение уровня сессии, которое изменяет или дополняет текущий system prompt.

Итак:

Примеры:

Встроенные личности

Hermes поставляется со встроенными личностями, на которые можно переключиться с помощью /personality.

Имя Описание
helpful Дружелюбный, универсальный помощник
concise Краткие, по существу ответы
technical Детальный, точный технический эксперт
creative Инновационное, нестандартное мышление
teacher Терпеливый педагог с понятными примерами
kawaii Милые выражения, блёстки и энтузиазм ★
catgirl Нэко-тян с кошачьими выражениями, ня~
pirate Капитан Hermes, технически подкованный буканьер
shakespeare Бардовская проза с драматическим оттенком
surfer Полностью расслабленные братские вибрации
noir Рассказ крутого детектива
uwu Максимальная милота с uwu-речью
philosopher Глубокие размышления над каждым запросом
hype МАКСИМАЛЬНАЯ ЭНЕРГИЯ И ЭНТУЗИАЗМ!!!

Переключение личностей с помощью команд

CLI

/personality
/personality concise
/personality technical

Мессенджеры

/personality teacher

Это удобные наложения, но ваш глобальный SOUL.md по-прежнему задаёт Hermes его постоянную личность по умолчанию, если наложение не изменяет её существенно.

Пользовательские личности в конфигурации

Вы также можете определять именованные пользовательские личности в ~/.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

Хорошая настройка по умолчанию:

  1. Храните продуманный глобальный SOUL.md в ~/.hermes/SOUL.md

  2. Помещайте инструкции проекта в AGENTS.md

  3. Используйте /personality только когда хотите временно сменить режим

Это даёт вам:

Как личность взаимодействует с полным prompt

На высоком уровне стек prompt включает:

  1. SOUL.md (идентичность агента — или встроенная замена, если SOUL.md недоступен)

  2. руководство по поведению с учётом инструментов

  3. контекст памяти/пользователя

  4. руководство по навыкам

  5. файлы контекста (AGENTS.md, .cursorrules)

  6. временная метка

  7. подсказки форматирования для конкретной платформы

  8. опциональные наложения на system prompt, такие как /personality

SOUL.md — это основа — всё остальное строится поверх неё.

Внешний вид CLI vs личность в разговоре

Личность в разговоре и внешний вид CLI — это разные вещи:

О внешнем виде в терминале см. Скины и Темы.