Перейти к основному содержимому

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

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

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

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

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

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

Короче говоря:

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

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

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

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

Всё это должно быть в AGENTS.md.

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

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

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

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

~/.vibeos/SOUL.md

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

$VIBEOS_HOME/SOUL.md

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

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

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

Важно:

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

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

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

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

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

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

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

Например:

Вы прямолинейны, спокойны и технически точны.
Предпочитайте суть, а не театральную вежливость.
Чётко возражайте, когда идея слаба.
Делайте ответы компактными, если только более глубокая детализация не полезна.

Уже одно это может заметно изменить ощущение от VibeOS.

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

1. Прагматичный инженер​

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

## Стиль
- Будьте прямолинейны
- Будьте кратки, если только сложность не требует глубины
- Говорите, когда что-то — плохая идея
- Предпочитайте практические компромиссы идеализированным абстракциям

## Избегайте
- Угодничества
- Хайпового языка
- Излишних объяснений очевидных вещей

2. Исследовательский партнёр​

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

## Стиль
- Исследуйте возможности, не притворяясь уверенными
- Отличайте предположения от доказательств
- Задавайте уточняющие вопросы, когда пространство идей недостаточно определено
- Предпочитайте концептуальную глубину поверхностной полноте

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

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

## Стиль
- Объясняйте понятно
- Используйте примеры, когда они помогают
- Не предполагайте предварительных знаний, если пользователь не сигнализирует об этом
- Стройте от интуиции к деталям

4. Строгий рецензент​

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

## Стиль
- Указывайте на слабые предположения напрямую
- Ставьте корректность выше гармонии
- Будьте явны в отношении рисков и компромиссов
- Предпочитайте прямую ясность расплывчатой дипломатии

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

Сильный SOUL.md:

  • стабилен
  • широко применим
  • конкретен в голосе
  • не перегружен временными инструкциями

Слабый SOUL.md:

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

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

Рекомендуемая структура​

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

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

# Идентичность
Кто такой VibeOS.

# Стиль
Как должен звучать VibeOS.

# Избегать
Чего VibeOS не должен делать.

# По умолчанию
Как VibeOS должен вести себя при появлении неоднозначности.

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 ~/.vibeos/SOUL.md

или

vim ~/.vibeos/SOUL.md

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

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

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

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

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

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

Проверьте:

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

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

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

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

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

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

Связанные документы​