Создание сессий и совместная работа в Git
Два функциональных элемента, работающих в паре: создание подзадач в отдельных дочерних сессиях с помощью
vspawn(по желанию в изолированных git worktree) и графическое объединение для слияния параллельных веток. Вместе они превращают сценарий «несколько агентов, работающих параллельно над одним репозиторием», в обычный рабочий процесс.
1. Что такое создание сессий
Из любой сессии можно отделить подзадачу: VelaTerm создает новую дочернюю сессию ** под ** текущим узлом (дерево становится иерархическим: родитель → дочерний → внуковый), по желанию предоставляет изолированный git worktree и передаёт описание задачи в качестве первого сообщения новой сессии — новый агент начинает работу сразу после запуска, без необходимости повторного объяснения.
Результатом становится настоящая сессия в дереве — с собственным процессом, полностью интерактивная и способная к возобновлению — которую можно наблюдать или войти в неё в любой момент. Это не скрытая фоновая задача.
2. Четыре точки входа
| Вход | Кто им пользуется | Worktree |
|---|---|---|
Команда терминала vspawn "task" | Вы, в любой сессии | По умолчанию выключено; --worktree включает |
Команда терминала vspawn-tree "task" | То же самое | Всегда включено |
/vspawn task в разговоре с Claude | Claude создаёт её (и расширяет задачу до полноценного самодостаточного запроса) | По умолчанию выключено |
/vspawn-tree task в разговоре с Claude | То же самое | Всегда включено |
Обе команды терминала автоматически встраиваются в PATH каждой сессии — без необходимости установки.
Предусловие для навыков
/: прежде чем Claude сможет использовать/vspawnили/vspawn-tree(или создавать подсессии самостоятельно), включите Vela Skills в разделе «Настройки» ▸ «Общие». Это установит навыки/vspawn,/vspawn-treeи/vopenв виде пакета в~/.claude/skills/; они автоматически обновляются при обновлении приложения. После включения запустите новую сессию Claude (или перезапустите существующую), чтобы агент загрузил эти навыки. Без этого Claude просто не знает этих команд — работают только команды, введённые в терминале,vspawn/vspawn-tree.
3. Подтверждение перед созданием
По умолчанию при каждом создании сначала отображается карточка подтверждения (в верхнем правом углу, немодальная, не отвлекает внимание):

- Три поля для редактирования: запрос (многорядочный), тип агента (по умолчанию — тот же, что у родителя) и отдельный git worktree.
- Кнопка «Запустить» начинает работу дочерней сессии; «Отмена» отклоняет запрос. Когда агент создаёт несколько сессий одновременно, карточки обрабатываются по одной (остаточное количество отображается на карточке).
- Если вы хотите полностью пропустить подтверждение, отключите опцию «Подтверждение перед созданием» в разделе «Настройки» ▸ «Поведение».
4. Worktree: параллельная работа без взаимных помех
При включённой опции worktree дочерняя сессия работает над новой веткой в своём собственном рабочем каталоге — изолированно от основного рабочего пространства и от других дочерних сессий. Это идеальная структура для многоагентного параллелизма. Управление осуществляется через контекстное меню сессии в разделе «Worktree ▸»: просмотр изменений, копирование/открытие папки worktree, удаление worktree (с возможностью принудительного удаления незакоммитированных изменений).
Создание сессий из каталога, не являющегося git-репозиторием, тоже возможно; в этом случае используется каталог родителя без worktree.
5. Объединение: графическое Gitобъединение
Когда работа завершена, её нужно объединить с основным репозиторием. В любой сессии, рабочий каталог которой является git-репозиторием (с worktree или без него): щелчок правой кнопкой → «Git ▸ Объединить…», что откроет диалоговое окно объединения:
- **Вы выбираете и источниковую, и целевую ветки **, а также можете поменять направление — объединить ветку дочерней сессии обратно в основную или привести основную ветку в дочернюю для обновления её базовой версии, всё это из одного и того же диалогового окна.
- Объединение выполняется в рабочем каталоге, где проверена целевая ветка; если в источниковом каталоге есть незакоммитированные изменения, они сначала коммитируются, чтобы ничего не было потеряно.
- При конфликте сцена остаётся без изменений, чтобы вы (или агент) могли решить проблему в терминале и продолжить работу.
Объединение не удаляет worktree автоматически — уберите его позже через «Worktree ▸ Удалить worktree…», когда будете уверены.
6. Типичный рабочий процесс
- В основной сессии попросите Claude проанализировать задачу, затем
/vspawn-tree refactor the checkout moduleдля её создания (требуется Vela Skills — см. §2). - Просмотрите запрос на карточке подтверждения и нажмите «Запустить» — дочерняя сессия начинает работу в своём worktree, видимую в боковой панели рядом с родителем, точка становится зелёной.
- Вы продолжаете работать в основной сессии; когда дочерняя сессия задаёт вопрос или завершает работу, её точка становится жёлтой и появляется уведомление.
- Войдите в сессию для проверки, затем щелкните правой кнопкой → «Git ▸ Объединить…», чтобы объединить её ветку обратно в основную.
- «Worktree ▸ Удалить worktree…» для очистки, затем архивируйте дочернюю сессию для сохранения записи.