sidebar_position: 7 title: "Use SOUL.md with Hermes" description: "How to use SOUL.md to shape Hermes Agent's default voice, what belongs there, and how it differs from AGENTS.md and /personality" lang: ru

Используйте SOUL.md с Hermes

SOUL.md — это основной идентификатор вашего экземпляра Hermes. Это первое, что есть в системной подсказке — оно определяет, кто такой агент, как он говорит и чего избегает.

Если вы хотите, чтобы Гермес чувствовал себя одним и тем же помощником каждый раз, когда вы с ним разговариваете, или если вы хотите полностью заменить образ Гермеса своим собственным, используйте этот файл.

Для чего нужен SOUL.md

Используйте SOUL.md для: - тон - личность - стиль общения - насколько прямым и теплым должен быть Гермес - чего Hermes следует избегать стилистически - как Гермес должен относиться к неопределенности, разногласиям и двусмысленности

Короче говоря: - SOUL.md о том, кто такой Гермес и как говорит Гермес.

Для чего не нужен SOUL.md

Не используйте его для: - соглашения о кодировании, специфичные для репо - пути к файлам - команды - сервисные порты - заметки по архитектуре - инструкции по работе над проектом

Они принадлежат AGENTS.md.

Хорошее правило: - если оно должно применяться везде, поместите его в SOUL.md - если он принадлежит только одному проекту, поместите его в AGENTS.md

Где он живет

Hermes теперь использует только глобальный файл SOUL для текущего экземпляра:

~/.hermes/SOUL.md

Если вы запустите Hermes с пользовательским домашним каталогом, он будет выглядеть так:

$HERMES_HOME/SOUL.md

Поведение при первом запуске

Hermes автоматически выделяет для вас стартер SOUL.md, если он еще не существует.

Это означает, что большинство пользователей теперь начинают с реального файла, который они могут немедленно прочитать и отредактировать.

Важно: - если у вас уже есть SOUL.md, Гермес не перезапишет его - если файл существует, но пуст, Гермес ничего не добавляет из него в подсказку

Как это использует Гермес

Когда Hermes запускает сеанс, он считывает SOUL.md из HERMES_HOME, сканирует его на наличие шаблонов ввода подсказки, при необходимости усекает его и использует в качестве идентификатора агента — слот №1 в системном приглашении. Это означает, что SOUL.md полностью заменяет встроенный идентификационный текст по умолчанию.

Если SOUL.md отсутствует, пуст или не может быть загружен, Hermes возвращается к встроенному идентификатору по умолчанию.

К файлу не добавляется язык-оболочка. Содержание само по себе имеет значение — напишите так, как вы хотите, чтобы ваш агент думал и говорил.

Хорошее первое редактирование

Если вы больше ничего не делаете, откройте файл и измените всего несколько строк, чтобы он чувствовал себя так, как вы.

Например:

You are direct, calm, and technically precise.
Prefer substance over politeness theater.
Push back clearly when an idea is weak.
Keep answers compact unless deeper detail is useful.

Уже одно это может заметно изменить чувства Гермеса.

Примеры стилей

1. Инженер-прагматик

You are a pragmatic senior engineer.
You care more about correctness and operational reality than sounding impressive.

## Style
- Be direct
- Be concise unless complexity requires depth
- Say when something is a bad idea
- Prefer practical tradeoffs over idealized abstractions

## Avoid
- Sycophancy
- Hype language
- Overexplaining obvious things

2. Партнер по исследованиям

You are a thoughtful research collaborator.
You are curious, honest about uncertainty, and excited by unusual ideas.

## Style
- Explore possibilities without pretending certainty
- Distinguish speculation from evidence
- Ask clarifying questions when the idea space is underspecified
- Prefer conceptual depth over shallow completeness

3. Учитель/объяснитель

You are a patient technical teacher.
You care about understanding, not performance.

## Style
- Explain clearly
- Use examples when they help
- Do not assume prior knowledge unless the user signals it
- Build from intuition to details

4. Жесткий рецензент

You are a rigorous reviewer.
You are fair, but you do not soften important criticism.

## Style
- Point out weak assumptions directly
- Prioritize correctness over harmony
- Be explicit about risks and tradeoffs
- Prefer blunt clarity to vague diplomacy

Что делает SOUL.md сильным?

Сильный SOUL.md это: - стабильный - широко применимо - конкретный в голосе - не перегружен временными инструкциями

Слабый SOUL.md это: - полное описание проекта - противоречивый - попытка микроуправления каждой формой ответа - в основном общие наполнители, такие как «будь полезен» и «будь понятен»

Гермес уже пытается быть полезным и понятным. SOUL.md должен добавлять настоящую индивидуальность и стиль, а не повторять очевидные значения по умолчанию.

Предлагаемая структура

Вам не нужны заголовки, но они помогают.

Простая структура, которая хорошо работает:

# Identity
Who Hermes is.

# Style
How Hermes should sound.

# Avoid
What Hermes should not do.

# Defaults
How Hermes should behave when ambiguity appears.

SOUL.md против /personality

Они дополняют друг друга.

Используйте SOUL.md для получения надежной базовой линии. Используйте /personality для временного переключения режимов.

Примеры: - ваша ДУША по умолчанию прагматична и прямолинейна - тогда за один сеанс вы используете /personality teacher - позже вы переключаетесь обратно, не меняя базовый голосовой файл

SOUL.md против AGENTS.md

Это самая распространенная ошибка.

Поместите это в SOUL.md

«Будь прямым».
«Избегайте хайпа».
«Предпочитайте короткие ответы, если не поможет глубина».
«Отталкивайтесь, когда пользователь не прав».

Поместите это в AGENTS.md

— «Используйте pytest, а не unittest». - «Фронтенд живет в frontend/». - «Никогда не редактируйте миграции напрямую». - «API работает на порту 8000».

Как это редактировать

nano ~/.hermes/SOUL.md

или

vim ~/.hermes/SOUL.md

Затем перезапустите Гермес или начните новый сеанс.

Практичный рабочий процесс

Начните с заполненного файла по умолчанию.
Обрежьте все, что не похоже на тот голос, который вам нужен.
Добавьте 4–8 строк, четко определяющих тон и настройки по умолчанию.
Поговорите немного с Гермесом.
Приспосабливайтесь к тому, что вам все еще кажется неприятным

Такой итеративный подход работает лучше, чем попытка создать идеальную личность за один раз.

Устранение неполадок

Я отредактировал SOUL.md, но «Гермес» звучит по-прежнему

Проверьте: - вы редактировали ~/.hermes/SOUL.md или $HERMES_HOME/SOUL.md - не какое-то репо-локальное SOUL.md - файл не пустой - ваша сессия была перезапущена после редактирования - наложение /personality не доминирует над результатом

Гермес игнорирует части моего SOUL.md

Возможные причины: - инструкции с более высоким приоритетом переопределяют его - файл содержит противоречивые рекомендации - файл слишком длинный и был обрезан - некоторая часть текста напоминает содержимое, введенное подсказкой, и может быть заблокирована или изменена сканером.

Мой SOUL.md стал слишком специфичным для проекта

Переместите инструкции по проекту в AGENTS.md и сосредоточьтесь на SOUL.md на индивидуальности и стиле.