Использование SOUL.md с Hermes

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

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

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

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

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

Коротко:

SOUL.md — это о том, кто такой Hermes и как Hermes говорит

Для чего SOUL.md не предназначен

Не используйте его для:

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

Они относятся к AGENTS.md.

Хорошее правило:

если это должно применяться везде, поместите это в SOUL.md
если это относится только к одному проекту, поместите это в AGENTS.md

Где он находится

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

~/.hermes/SOUL.md

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

$HERMES_HOME/SOUL.md

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

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

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

Важно:

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

Как Hermes его использует

Когда 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.

Уже только это может заметно изменить ощущение от Hermes.

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

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 — это:

полный деталей проекта
противоречивый
пытающийся микроменеджерить каждую форму ответа
в основном состоящий из шаблонных фраз вроде «будь полезным» и «будь понятным»

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

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

Заголовки не обязательны, но они помогают.

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

# Identity
Кто такой Hermes.

# Style
Как должен звучать Hermes.

# Avoid
Чего Hermes не должен делать.

# Defaults
Как Hermes должен вести себя, когда возникает неоднозначность.

SOUL.md vs /personality

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

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

Примеры:

ваш базовый SOUL — прагматичный и прямой
затем на одну сессию вы используете /personality teacher
позже вы возвращаетесь обратно, не меняя основной голосовой файл

SOUL.md vs AGENTS.md

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

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

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

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

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

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

nano ~/.hermes/SOUL.md

или

vim ~/.hermes/SOUL.md

Затем перезапустите Hermes или начните новую сессию.

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

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

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

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

Я отредактировал SOUL.md, но Hermes всё ещё звучит так же

Проверьте:

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

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

Возможные причины:

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

Мой SOUL.md стал слишком привязан к проекту

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