Инженерная задача для агента
Devin от Cognition помогает работать с программными проектами: изучать исходники, выполнять команды, готовить код и проверять изменения. Агент использует рабочее окружение и может участвовать в процессе подготовки запроса на слияние. Подход полезен для ограниченной задачи, где известно ожидаемое поведение и можно проверить результат.
Например, приложение экспортирует отчёт с неверной датой для пользователя в другом часовом поясе. Здесь нужен разбор источника даты, преобразования и окончательного файла. Задание должно описывать конкретный пример, который воспроизводится на разрешённых тестовых данных. Общая просьба улучшить экспорт оставляет агенту слишком широкую область работы.
Окружение до начала изменения
Укажите репозиторий и ветку, способ установки зависимостей и команду запуска. Для проверки экспорта может понадобиться отдельный сервис или тестовая база. Если доступ отсутствует, агенту нужно сообщить это до работы. Иначе техническая невозможность запустить приложение будет выглядеть как неизвестная ошибка проекта.
Подготовьте минимальную запись с вымышленными сведениями и зафиксируйте ожидаемую дату. Уточните, что именно хранится в базе: календарный день или момент времени. Это разные данные, и автоматический перевод часового пояса подходит им по-разному. Правило должно происходить из задачи продукта, а не из предположения агента.
Исправь дату в экспорте отчёта. Для указанной тестовой записи ожидается тот же календарный день, который видит пользователь на странице. Найди место преобразования, предложи объяснение и минимальную правку. Не меняй формат столбцов. Проверь интерфейс и выгруженный файл, сохрани пример исходного сбоя.
Передайте план действий вместе с критериями готовности. Если изменение требует пересмотра схемы хранения, попросите отдельно объяснить причину. В такой ситуации маленькая правка форматирования может лишь скрыть более глубокую несогласованность. Решение о миграции данных следует принимать как самостоятельную работу.
Как наблюдать за выполнением
Читайте промежуточные выводы и сопоставляйте их с найденными файлами. Агент может правильно заметить сдвиг даты, но выбрать не тот слой для исправления. Изменение общего преобразователя способно повлиять на другие отчёты. Попросите показать вызывающие места и границы выбранного решения.
Проверяйте предлагаемые операции с окружением. Запуск теста и изменение рабочей базы имеют разные последствия. Для первого задания достаточно доступов, нужных для репозитория и тестового запуска. Публикацию или изменение внешней системы включайте в задачу явно, с понятным условием выполнения.
Если агент останавливается на неизвестной команде или отсутствии сервиса, помогите уточнить окружение. Не просите продолжать любой ценой. Для результата полезно отделять написанную правку от проверенного поведения. Ограничение запуска должно оставаться видимым при передаче работы коллеге.
Проверка кода и экспорта
Откройте подготовленный diff и посмотрите, где меняется дата. Проверьте добавленные зависимости и удалённые условия. Условная подстановка одного дня не подходит, если причина связана с различием типов данных. В тесте ожидаемый результат должен быть рассчитан независимо от исправляемой функции.
Выполните сценарий с настройками часового пояса, относящимися к продукту. Затем проверьте обычный отчёт, где сбой не наблюдался. Сравните страницу и полученный файл в отдельном просмотрщике. Это помогает заметить, что код изменил лишь подпись в интерфейсе, а экспорт остался прежним.
Посмотрите сообщения команд и итоговое состояние ветки. Если агент подготовил запись проверки в браузере, убедитесь, что она относится к текущей версии приложения. Проверка одного примера не охватывает все варианты данных. Для важных отчётов дополнительно используйте действующие проверки команды.
Для ошибки календарного дня сохраните входное значение до преобразования и настройку окружения, в котором выполнялась проверка. Вызов общего преобразователя даты полезно проверить на другом отчёте. Если результат зависит от настроек сервера, укажите это в задаче: иначе локальное исправление может вести себя иначе после развёртывания.
Передача результата в разработку
Запрос на слияние должен объяснять причину дефекта и новое поведение. Добавьте подтверждённые проверки и места, которые остались непроверенными. Не переносите в описание предположение о запуске команды, если её выполнение не завершилось. Читателю нужна возможность воспроизвести сценарий на тех же исходных условиях.
Для повторяющихся задач поддерживайте инструкции окружения и актуальные примеры. Когда зависимости меняются, старый способ запуска может перестать работать. Сравнить работу агента внутри редактора можно в обзоре Cline, а другой редакторный подход описан у Cursor. Смежные инструменты находятся в категории ассистентов для кода.
