agent-ecosystem/landing/product-docs/ru/guide/review-and-approve.md
2026-05-28 17:49:17 +03:00

4.1 KiB
Raw Blame History

title description lang
Проверить и approve - Документация Agent Teams Понятный workflow ревью: task detail, execution logs, code changes, hunk decisions, approvals и fix requests. ru-RU

Проверить и approve

Не считайте работу агента завершённой, пока не проверили результат задачи, logs и changes. Review удерживает качество и scope.

1. Откройте задачу

Начните с задачи в Review или Done. Сначала прочитайте title, owner, status и description.

Проверьте:

  • понятная ли цель задачи
  • совпадают ли файлы с ожидаемым scope
  • есть ли final comment от teammate
  • есть ли verification command и result

2. Проверьте execution evidence

Execution Logs отвечают на базовые вопросы доверия:

Вопрос Что искать
Агент реально работал над этой задачей? Tool calls, comments и status changes внутри task timeline.
Он запускал verification? Build, test, lint или docs commands с результатом.
Он координировался с другими? Messages или comments с handoffs и blockers.
Он трогал неожиданные файлы? Changes, которые не совпадают с task description.

Если logs и final comment расходятся, попросите уточнение до approval.

3. Проверьте diff

Откройте Changes и просмотрите каждый changed file.

Порядок:

  1. Прочитать file list.
  2. Открыть каждый changed file.
  3. Проверить, что изменения совпадают с задачей.
  4. Keep для правильных hunks.
  5. Undo или reject для рискованных hunks.
  6. Approve только после проверки важных files.

4. Просите fixes конкретно

Если что-то не так, не ограничивайтесь reject. Оставьте конкретный fix request:

Please keep the copy improvements, but revert the unrelated runtime wording in the provider table. Add the `pnpm --dir landing docs:build` result before resubmitting.

Хороший fix request называет:

  • что оставить
  • что изменить
  • чего избегать
  • какая verification обязательна

5. Approve только полный результат

Approve уместен, когда:

  • task scope закрыт
  • diff совпадает с задачей
  • verification прошёл или отсутствие verification объяснено
  • нет unrelated changes
  • comments объясняют важные решения

Если task менял docs или UI, перед approval откройте соответствующую страницу или экран приложения.

6. Финальный checklist

Перед закрытием review:

  • изменённые files ожидаемые
  • есть final result comment
  • есть verification result
  • risky hunks проверены отдельно
  • lead или reviewer поставил approved

Если что-то непонятно, request changes лучше, чем approve.