Документация

Если задача зависла или завершилась ошибкой

Анализ ошибки и выбор варианта: повторить, доработать, приостановить или отменить.

Задачи могут завершаться неудачей. В большинстве случаев причинами являются проблемы с конфигурацией или спецификациями, а не что-то загадочное; такие ситуации сводятся к нескольким типичным сценариям.

Сначала определите место остановки процесса.

В отчете указана стадия, на которой произошел сбой. Этот факт помогает точнее определить причину, чем что-либо другое:

Сбой произошел на этапеПочти всегда это означает
До написания любого кодаКоманда сборки или установки указана неверно для чистой рабочей области.
В процессе внесения измененийСложная задача или отсутствие необходимой зависимости.
Запуск тестовКоманда запуска тестов указана неверно, либо для их выполнения требуется соответствующий сервис.
ПроверкаБлокирующее условие; проверьте раздел «Результаты».
РецензированиеРезультаты, которые не удалось исправить автоматически.

Ошибки, возникающие до написания кода, связаны с конфигурацией. Ознакомьтесь с разделом Настройки сборки и тестирования.

Процесс не завис, он просто находится в очереди.

Задача в статусе PENDING не зависла. Она ожидает освобождения слота агента. Проверьте загруженность — это самая распространенная ложная тревога.

Система запрашивает у вас решение.

NEEDS_HUMAN_REVIEW означает, что задача столкнулась с решением, которое может принять только вы. Это не ошибка. Ответьте на вопрос, и процесс продолжится с того места, где остановился.

Отвечайте предельно точно. Неточный ответ приведет к новой попытке угадать и новой паузе.

Выполнение занимает гораздо больше времени, чем ожидалось.

Две основные причины:

Медленный или зависший набор тестов. Coroid запускает ваш набор тестов; если он зависнет в чистой рабочей области, задача будет ждать. Чтобы воспроизвести ситуацию, запустите набор тестов на новом клоне проекта.

Спецификация сформулирована слишком широко, из-за чего агент продолжает находить новые этапы работы. Признаком этого является увеличивающийся список файлов. Отмените задачу, уточните область работы с помощью явной строки «вне области применения» и запустите задачу снова. Ознакомьтесь с разделом Спецификации.

Выбор действия

В порядке возрастания затрат:

  • Ответить — для NEEDS_HUMAN_REVIEW. Самый экономичный вариант, сохраняет весь контекст.
  • Доработать — работа выполнена верно, но не полностью. Задача возвращается к агенту-разработчику с вашими замечаниями и сохраненным контекстом.
  • Приостановить — вам нужно сначала что-то проверить. Это освобождает слот; задачу можно возобновить.
  • Повторить — только для действительно временных сбоев. Повторная попытка при проблемах с конфигурацией лишь приведет к тому же результату.
  • Отменить и уточнить спецификацию — подход или область задачи были выбраны неверно. Самый дорогой вариант, но зачастую и правильный.

Ошибки, повторяющиеся в разных задачах

Одна и та же ошибка на одной и той же стадии в несвязанных задачах указывает на проблему с конфигурацией проекта, а не с самими задачами. Прекратите запускать задачи повторно и исправьте конфигурацию.