Руководство пользователя

Создание сессий и совместная работа в Git

Два функциональных элемента, работающих в паре: создание подзадач в отдельных дочерних сессиях с помощью vspawn (по желанию в изолированных git worktree) и графическое объединение для слияния параллельных веток. Вместе они превращают сценарий «несколько агентов, работающих параллельно над одним репозиторием», в обычный рабочий процесс.

1. Что такое создание сессий

Из любой сессии можно отделить подзадачу: VelaTerm создает новую дочернюю сессию ** под ** текущим узлом (дерево становится иерархическим: родитель → дочерний → внуковый), по желанию предоставляет изолированный git worktree и передаёт описание задачи в качестве первого сообщения новой сессии — новый агент начинает работу сразу после запуска, без необходимости повторного объяснения.

Результатом становится настоящая сессия в дереве — с собственным процессом, полностью интерактивная и способная к возобновлению — которую можно наблюдать или войти в неё в любой момент. Это не скрытая фоновая задача.

2. Четыре точки входа

ВходКто им пользуетсяWorktree
Команда терминала vspawn "task"Вы, в любой сессииПо умолчанию выключено; --worktree включает
Команда терминала vspawn-tree "task"То же самоеВсегда включено
/vspawn task в разговоре с ClaudeClaude создаёт её (и расширяет задачу до полноценного самодостаточного запроса)По умолчанию выключено
/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. Типичный рабочий процесс

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