Использование SOUL.md с Hermes
SOUL.md — это основная идентичность вашего экземпляра Hermes. Это первое, что появляется в системном приглашении — файл определяет, кто такой агент, как он говорит, и чего избегает.
Если вы хотите, чтобы Гермес каждый раз ощущался как один и тот же ассистент, или хотите полностью заменить персонажа Гермеса на своего — подтвердите этот файл.
Для чего нужен SOUL.md
Используйте SOUL.md для: - тонна - личность - стиль общения - таким образом, настоящий стиль или тепло должен быть Гермесом. - того, чего Гермес должен стилистически руководствоваться - того, как Гермес должен приводить к неопределённости, несогласию и двусмысленности
Короче:
- SOUL.md определяет, кто такой Гермес и как он говорит
Для чего SOUL.md не предназначен
Не приветствуйте его: - Конгресс о кодексах, США для репозитория - путь к файлам - команда команды - портов сервисов - заметки по архитектуре - инструкция по рабочему процессу проекта
Всё это относится к AGENTS.md.
Хорошее правило:
- если это должно применяться везде — поместите в SOUL.md
- если относится только к одному проекту — поместите в AGENTS.md
Где он находится
Hermes теперь использует только глобальный файл SOUL для примера:
~/.hermes/SOUL.md
Если вы запустите Hermes с пользовательской домашней директорией, путь будет такой:
$HERMES_HOME/SOUL.md
Поведение при первом запуске
Гермес автоматически создаёт начальный SOUL.md, если его ещё нет.
Это означает, что большинство пользователей теперь начинают с реального файла, который можно сразу прочитать и отредактировать.
Важно:
- если SOUL.md уже существует, Гермес не перезаписывает его
- если файл существует, но пуст, Гермес ничего из него не добавлял в подсказку
Как Гермес его использует
Когда Гермес запускает сессию, он читает SOUL.md из HERMES_HOME, сканирует его на наличие шаблонов промпт-инъекций, при необходимости усекает и использует как ** идентичность агента** — слот №1 в системном приглашении. Это означает, что SOUL.md полностью заменяет встроенный текст идентичности по умолчанию.
Если SOUL.md отсутствует, пуст или не может быть загружен, Гермес возвращает встроенную идентичность по умолчанию.
Вокруг файла не добавляется никаких обёрток. Важные самотребования — напишите так, как хотите, чтобы ваш агент думал и говорил.
Хорошее первое редактирование
Если вы больше ничего не сделали, замените файл на несколько строк, чтобы он стал похож на вас.
Например:
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 для временных переключений режимов.
Примеры:
- ваш базовый SOUL — прагматичный и прямой
- затем на одном сеансе вы держите /личностный учитель
- позже возвращаются обратно, не меняя базовый файл голосов
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 не доминирует в результате
Hermes нарушает часть моего SOUL.md
Возможные причины: - инструкции с более высоким приоритетом переопределяют их - файл содержит противоречивые указания - файл слишком длинный и был учтен - часть текста соответствует стандартным запросам-инъекциям и может быть заблокирована или изменена сканером.
Мой SOUL.md стал специфичным для проекта
Перенесите инструкцию по проекту в AGENTS.md, а SOUL.md оставьте комплексным на идентичность и стиль.