106 lines
7.4 KiB
Markdown
106 lines
7.4 KiB
Markdown
---
|
||
title: Создание команды – Документация Agent Teams
|
||
description: Определить роли, назначить провайдеры и модели, написать brief команды и настроить worktree isolation и уровни autonomy.
|
||
lang: ru-RU
|
||
---
|
||
|
||
# Создание команды
|
||
|
||
Команда — это группа агентов с ролями, lead-агентом, целевым проектом и coordination prompt.
|
||
|
||
## Первая команда
|
||
|
||
Начните с малого:
|
||
|
||
| Роль | Задача |
|
||
| -------- | ---------------------------------------------------- |
|
||
| Lead | Делит работу, создаёт задачи, координирует teammates |
|
||
| Builder | Реализует scoped tasks |
|
||
| Reviewer | Проверяет результат, ловит регрессии, просит fixes |
|
||
|
||
Такая форма даёт достаточно координации, но не создаёт лишний шум на первом запуске.
|
||
|
||
::: tip
|
||
Команду можно расширить позже. Начните с малого, проверьте workflow, затем масштабируйте.
|
||
:::
|
||
|
||
## Назначение провайдеров и моделей
|
||
|
||
Каждый участник команды работает через провайдер-бэкенд. В редакторе команды выберите провайдер (Claude, Codex или OpenCode) и модель для каждого участника. Приложение показывает только провайдеров, которые вы уже авторизовали.
|
||
|
||
Микс провайдеров в одной команде поддерживается — например, Claude lead с OpenCode builder-ами.
|
||
|
||
::: info
|
||
Gemini — поддерживаемый провайдер. Варианты auth смотрите в разделе [Провайдеры и рантаймы](/ru/reference/providers-runtimes).
|
||
:::
|
||
|
||
## Хороший team brief
|
||
|
||
В brief стоит указать:
|
||
|
||
- нужный outcome
|
||
- важные files или feature areas
|
||
- границы риска, например «не refactor unrelated modules»
|
||
- ожидания по review
|
||
- verification commands, если они известны
|
||
|
||
Пример:
|
||
|
||
```text
|
||
Улучши download flow. Держи изменения внутри landing app, если shared helper явно не нужен. Создай задачи до реализации, проверь diff каждой задачи и запусти landing lint/build checks.
|
||
```
|
||
|
||
## Изоляция через worktree
|
||
|
||
Участники на OpenCode могут использовать **изоляцию через worktree** — работать в отдельном Git worktree вместо основного рабочего каталога. Это предотвращает конфликты файлов, когда несколько агентов редактируют один проект.
|
||
|
||
::: warning
|
||
Изоляция через worktree требует Git-репозиторий и пока доступна только для участников на OpenCode.
|
||
:::
|
||
|
||
Чтобы включить, переключите опцию **Worktree isolation** при добавлении или редактировании участника на OpenCode.
|
||
|
||
## Уровень автономности
|
||
|
||
Agent Teams поддерживает разные уровни контроля. Больше автономности подходит для рутинных изменений, меньше — для рискованных областей: provider auth, IPC, персистентность, Git-операции и release tooling.
|
||
|
||
### Уровень усилия (effort)
|
||
|
||
У каждого участника есть настройка **effort** — она определяет, сколько reasoning провайдер вкладывает перед ответом. Выше effort — тщательнее результат, но больше времени и токенов.
|
||
|
||
| Уровень | Когда использовать |
|
||
| ------- | ------------------------------------------------------------------------- |
|
||
| Low | Быстрые запросы, мелкие правки форматирования, рутинные изменения |
|
||
| Medium | По умолчанию для большинства задач по реализации |
|
||
| High | Сложные рефакторинги, кросс-модульные изменения, рискованные участки кода |
|
||
|
||
Приложение предлагает дополнительные уровни (minimal, xhigh, max) для провайдеров, которые их поддерживают. Если модель не поддерживает настройку effort, селектор отключён и используется значение по умолчанию провайдера.
|
||
|
||
### Быстрый режим (Fast mode)
|
||
|
||
Переключите **Fast mode** для отдельного участника, чтобы приоритизировать скорость над глубиной. Это использует нативный быстрый режим провайдера, когда он доступен. Установите **On** для рутинных задач, **Off** для аккуратной работы или **Inherit**, чтобы следовать командному значению по умолчанию.
|
||
|
||
### Ограничение контекста (Limit context)
|
||
|
||
Включите **Limit context**, чтобы уменьшить контекстное окно для участника. Это полезно для моделей Claude с расширенным контекстом (например, 1M токенов) — ограничение контекста избегает лишних токенов и улучшает задержку для задач, не требующих большого контекста.
|
||
|
||
## Контекст
|
||
|
||
Прикладывайте файлы, screenshots или заметки, если они реально меняют задачу. Task descriptions, comments и attachments становятся устойчивым контекстом.
|
||
|
||
## Качество задач
|
||
|
||
Хорошие задачи:
|
||
|
||
- конкретны для review
|
||
- достаточно малы для завершения
|
||
- связаны с видимым результатом
|
||
- имеют verification path
|
||
|
||
Если lead создаёт размытые задачи, напишите ему direct message и попросите сделать задачи меньше и проверяемее.
|
||
|
||
## Дальше
|
||
|
||
- [Настройка рантайма](/ru/guide/runtime-setup) — авторизация провайдеров и выбор моделей
|
||
- [Код-ревью](/ru/guide/code-review) — принять, отклонить или прокомментировать изменения агентов
|
||
- [Диагностика](/ru/guide/troubleshooting) — частые проблемы и решения
|