4.8 KiB
4.8 KiB
| title | description | lang |
|---|---|---|
| Запустить и отслеживать работу - Документация Agent Teams | Как дать lead понятный brief, читать task board, использовать messages и comments, открывать task detail и удерживать работу в движении. | ru-RU |
Запустить и отслеживать работу
После запуска команды ваша задача - держать работу видимой, ограниченной и готовой к review. Главная поверхность - board.
1. Дайте lead понятный brief
Lead нужна цель, которую можно разбить на задачи. Укажите:
- outcome
- разрешённые файлы или область продукта
- что не трогать
- verification commands
- когда просить review
Хороший brief:
Create a beginner docs path. Keep edits inside landing/product-docs. Add screenshots where they clarify actions. Do not touch runtime code. Run `pnpm --dir landing docs:build` before marking tasks complete.
Слабый brief:
Improve docs.
Слабый brief даёт lead слишком много свободы и усложняет review.
2. Читайте board по колонкам
| Колонка | Что значит | Что делать |
|---|---|---|
| Todo | Задачи есть, но ещё не активны. | Проверить, достаточно ли конкретные titles. |
| In Progress | Teammate активно работает. | Смотреть updates и не назначать duplicate work. |
| Review | Работу нужно проверить. | Открыть task и review changes. |
| Done | Работа завершена, но может требовать review flow. | Проверить review state перед доверием результату. |
| Approved | Review прошёл. | Считать результат завершённым. |
3. Используйте messages и comments осознанно
Task comments подходят для контекста конкретной задачи:
Please keep this task scoped to the quickstart page. Do not change runtime setup wording in this pass.
Direct messages подходят для координации:
Lead, pause new task creation until the current review queue is cleared.
Если возможно, предпочитайте task comments. Они остаются привязанными к работе.
4. Открывайте task detail, когда карточке нужно внимание
Открывайте task detail, если:
- title слишком размытый
- задача слишком долго in progress
- задача готова к review
- output упоминает неожиданные файлы
- нужно проверить attachments, changes или logs
5. Разблокируйте работу
Если teammate заблокирован, попросите минимальный следующий шаг:
Post the blocker, the file or command involved, and the next action you need from the lead or user.
Если задача слишком большая, попросите lead разделить её:
Split this into separate tasks for copy edits, screenshot assets, and navigation updates. Keep each task independently reviewable.
6. Когда остановить команду
Остановите или поставьте на паузу, если:
- review queue больше, чем вы можете проверить
- lead повторно создаёт размытые задачи
- runtime errors появляются в нескольких задачах
- агенты начали менять unrelated files
- completed work не содержит verification
Команду можно перезапустить после уточнения brief.
Дальше: Проверить и approve.