777genius 1490da10f9 docs(guide): improve clarity and completeness of Workflows section (EN+RU)

Add task lifecycle diagram, review states, auth configuration blocks,
common member states, CLI auth diagnostic, and safe-cleanup guidance.
Synchronize EN and RU pages for runtime-setup, agent-workflow,
code-review, and troubleshooting.

2026-05-09 11:01:39 +03:00

5.5 KiB

Raw Blame History

Работа агентов

Agent Teams делает работу агентов видимой через task state, messages, logs и reviewable code changes.

Режимы

Режим	Описание
Solo	Один teammate с самоуправляемыми задачами
Team	Несколько teammates, работающих параллельно и ревьюящих друг друга

В обоих режимах используются одни и те же канбан, task logs и surface для код-ревью.

Жизненный цикл задачи

Этап	Что происходит	Владелец
Provisioning	Приложение запускает runtime, проверяет, что процесс жив, и ждёт подтверждения bootstrap	App
Planning	Lead создаёт задачи, опционально назначает teammates и ставит зависимости	Lead или пользователь
In progress	Агенты работают параллельно и обновляют статус задач через board MCP tools	Teammates
Review	Изменения проверяют агенты или вы перед финальным принятием	Lead или пользователь
Done	Принятая работа остаётся связанной с историей задачи и доступна для просмотра	Пользователь

Planning → In progress

Когда teammate начинает задачу, статус на доске меняется на in_progress. Агент создаёт task comment с планом и продолжает работу. Все native tool actions (read, bash, edit, write) попадают в task log.

In progress → Review

Когда агент завершает работу, он публикует result comment и помечает задачу как completed. Lead может принять задачу сразу или перевести её в review.

Review → Done

Если изменения в review выглядят корректно, одобрите review. Задача финализируется и связывается с diff.

::: warning Review с правками Если во время review агенту запрошены изменения, он должен оставить follow-up comment с исправлениями, после чего lead может одобрить задачу. :::

Канбан-доска

Доска - основной рабочий экран. Через неё удобно:

Смотреть открытые, заблокированные и на ревью задачи
Открывать task detail и читать runtime logs
Ревьюить changes без ручного чтения session files
Назначать или переназначать владельцев

::: tip Используйте quick action buttons на карточках для старта, завершения или запроса ревью без открытия detail panel. :::

Сообщения и комментарии

Канал	Когда использовать
Direct message	Перенаправить агента, задать быстрый вопрос
Task comment	Заметки, относящиеся к конкретной задаче

Комментарии сохраняют контекст для review и появляются в таймлайне задачи.

::: tip Предпочитайте task comments Если замечание относится к конкретной задаче, добавьте его как комментарий к задаче, а не direct message. Это сохраняет историю, привязанную к работе. :::

Task logs

Task-specific logs изолируют runtime output, actions и messages по одному assignment. Они помогают понять:

Что агент запускал?
Почему он изменил этот файл?
Просил ли он помощи у teammate?
Какая задача породила diff?

Параллельная работа

Teammates могут работать над независимыми задачами одновременно. Вы также можете создавать зависимости (blocked-by), чтобы одна задача ждала завершения другой. Следите за заблокированными колонками на доске и переназначайте владельцев, если один teammate простаивает, а другой перегружен.

Live processes

Live process section показывает URLs и running processes, когда агенты поднимают локальные servers или tools. Открывайте URL прямо из приложения. Процессы остаются зарегистрированными до явной остановки или выхода runtime.

Межкомандное взаимодействие

Агенты могут отправлять сообщения в другие команды, если команды связаны. Используйте это для handoffs, shared libraries или status checks между командами.

5.5 KiB Raw Blame History Unescape Escape