AI-агент закончил задачу. Что я проверяю перед приёмкой
Допустим, я поручил агенту сравнить две версии API-контракта. В отчёте выделена строка «Поле customer_id стало обязательным». Разработчик может прочитать это как указание поменять все запросы. Если правило действует только для одной операции, команда изменит больше, чем нужно.
Приёмку я начинаю с решения, которое кто-то примет по отчёту. Здесь команда решает, какие запросы и тесты менять. Значит, мне нужны версия контракта, точное место в схеме и пример, по которому видна граница правила.
Дайте проверяющему способ опровергнуть вывод
В учебном контракте новая версия требует customer_id при создании платёжной заявки. Для запроса статуса ранее созданной заявки достаточно её идентификатора. Если агент написал «поле обязательно для API», я попрошу показать такое требование для операции проверки статуса. Дальше сверю два сценария.
| Сценарий | Что ожидаем по новой версии |
|---|---|
Создать заявку без customer_id | Запрос отклонён. Ответ указывает, какое поле отсутствует |
Запросить статус по идентификатору заявки без customer_id | Запрос принят при прочих корректных параметрах |
Для сравнения контрактов проверьте, что таблица точно отражает обе схемы. Если задача включает проверку реализации, зафиксируйте фактические результаты обоих запросов в тестовой среде. В записи о приёмке я указываю, какую проверку провёл. Тогда следующему человеку ясно, можно ли использовать вывод для постановки или для решения о выпуске.
Что делать, если источники расходятся
Представим, что в новой схеме поле обязательное, а в руководстве по миграции его можно пропустить ещё месяц. Сохраняю обе ссылки и уточняю у владельца API, описывает ли руководство исключение для старых клиентов и кто в него входит. До ответа оставляю переходное правило открытым.
Утверждение —
customer_idобязателен при создании заявки по контракту v2.
Проверка — сверены схемы создания и чтения статуса. Руководство по миграции описывает исключение.
Решение — стандартное правило подтверждено. Владелец API уточняет список клиентов до приёмки реализации.
В AnalystCraft я применил эту логику к подготовке требований. Подмастерье помогает связать утверждение с источником и сохранить разногласие в черновике. Человек проверяет оба документа и видит, какое решение ещё предстоит принять.