> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Навык: Первичная настройка

> Пошаговое знакомство с пользователем и безопасная настройка профиля, памяти, личности агента и общих правил рабочей области.

# Навык: Первичная настройка

`onboarding` помогает неопытному пользователю настроить Велес без самостоятельного редактирования
служебных файлов. Агент задаёт короткие вопросы, предлагает понятные варианты, объясняет последствия
выбора и только после согласования сохраняет результат.

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

## Какие файлы заполняются

Сведения разделяются по назначению, а не складываются в один общий текст:

| Файл | Назначение |
| - | - |
| `USER.md` | Устойчивые сведения о пользователе и предпочтения общения, общие для всех личностей |
| `memory/MEMORY.md` | Отобранные цели, решения и меняющийся рабочий контекст для будущих диалогов |
| `SOUL.md` или `personalities/<id>/SOUL.md` | Идентичность, характер, способ рассуждения и границы выбранной личности |
| `AGENTS.md` | Общие правила рабочей области, источники истины, проверки и границы подтверждения действий |

Файла `AGENT.md` в этом договоре нет. Велес использует `AGENTS.md` во множественном числе. Профиль
пользователя также не следует переносить в долгосрочную память целиком: для него предназначен
`USER.md`.

## Как проходит знакомство

В начале Велес читает уже существующие файлы и не принимает примеры или незаполненные поля за
реальные сведения. Затем предлагает один из двух вариантов:

1. **Основная настройка** — рекомендуемый первый проход: язык, обращение, рабочий контекст, формат
   ответов, роль и тон помощника, граница самостоятельных действий и одна текущая цель.
2. **Подробная настройка** — дополнительно охватывает предметные области, требования к оформлению,
   правила рабочей области, терминологию и долговременный контекст.

За один раз задаётся не более трёх близких по смыслу вопросов. У каждого вопроса есть несколько
вариантов, рекомендуемый выбор с объяснением и возможность пропустить вопрос или ответить своими
словами. Уже известные непротиворечивые сведения повторно не запрашиваются.

После беседы Велес показывает точный проект изменений отдельно для каждого файла, объясняет, почему
каждая запись находится именно там, и отмечает последствия выбора. Разрешение пройти опрос ещё не
считается разрешением изменить файлы: запись начинается только после явного подтверждения проекта.

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

## Что навык не принимает на веру

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

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

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

## Сохранение существующих настроек

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

Если настраивается дополнительная личность, меняется её файл
`personalities/<id>/SOUL.md`. `USER.md`, `memory/MEMORY.md` и корневой `AGENTS.md` остаются общими для
рабочей области.

## Доступность и цена постоянной загрузки

Навык поставляется в `veles/skills/onboarding` без внешних программ и секретов и помечен как
постоянно доступный. Чтобы не расходовать контекст каждого запроса на длинную анкету, Велес всегда
загружает только короткие правила запуска и безопасности. Полный сценарий вопросов читается лишь
после начала первичной настройки.

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

## Связанные страницы

* [Память Велеса: простое объяснение](/basics/memory_ru)
* [Личности Велеса](/basics/personalities_ru)
* [Навыки Велеса: простое объяснение](/skills/index_ru)
* [Навыки Велеса: подробный справочник](/skills/reference_ru)