РелизКод / SDK · В работуHabr AI→ оригинал

Команда Документерры поручила Claude писать автотесты за пять часов

Команда Документерры использует Claude для подготовки тест-кейсов и автотестов по документации продукта. По словам технического директора, на одну функцию уходит час подготовки запросов и пять часов работы модели, но сравнения с ручной работой нет. Агент читает документацию через MCP, составляет сценарии и пишет код проверок. Люди проверяют исходное описание и тест-кейсы: иначе ошибка в документации перекочует в тесты.

AI-обработка оригинала Habr AI; редакция Hamidun News
Команда Документерры поручила Claude писать автотесты за пять часов
Источник: Habr AI. Коллаж: Hamidun News.
Слушать статью
Паспорт материала и цифры
ПараметрДанные
ПервоисточникHabr AI ↗
Главный редактор
Ключевой факт #1Документацию и тест-кейсы проверяют люди на двух обязательных этапах.
Ключевой факт #2В примере со сбросом пароля Claude добавил проверку пустого поля.
Ключевой факт #3Команда пока не проверяла, использует ли агент сведения со скриншотов.

После выпуска функции приходится заново описывать её поведение для тестировщика, а затем переносить сценарии в автотесты. В Документерре попробовали использовать для этого документацию продукта: Claude читает её, составляет тест-кейсы и пишет проверки. На примере восстановления пароля видно, что именно получается на выходе и где человеку приходится проверять предположения модели.

По словам технического директора компании, на подготовку запросов для одной функции уходит час, затем Claude работает ещё пять часов. Это оценка из рассказа команды. В материале нет сравнения с ручной разработкой тестов, стоимости запусков или статистики ошибок, поэтому посчитать выигрыш пока нельзя.

От инструкции до двух тестов

В примере агент получает инструкцию по восстановлению пароля: открыть страницу входа, перейти по ссылке восстановления, ввести логин или почту и запросить письмо. Документацию он читает через MCP — подключение, которое позволяет обращаться к инструментам поиска и чтения страниц.

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

У второго сценария есть существенная деталь: исходная инструкция ничего не говорит о пустом поле. Модель сама предложила ожидаемое поведение. Для тестировщика это полезная заготовка, но её нужно сверить с требованиями продукта. Правдоподобное предположение ещё не становится правилом только потому, что агент оформил его в тест.

Показанный код также опирается на существующие фикстуры и объект страницы ForgotPasswordPage. Поэтому пример не демонстрирует создание всей тестовой инфраструктуры с нуля. Кроме того, эти две проверки не охватывают полный путь восстановления пароля: получение письма, переход по ссылке и установку нового пароля.

Два ревью остаются за людьми

Команда описывает два обязательных ручных этапа. Сначала человек проверяет документацию, затем — составленные моделью тест-кейсы. После этого контролирует создание автотестов.

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

Второе ревью нужно для проверки покрытия. Специалист, знакомый с пользователями, может заметить пропущенные условия, роли или исключения. В примере восстановления пароля отдельно стоит спросить, какие сценарии нужны для истёкшей ссылки и повторного запроса письма. Это возможные дополнения к плану проверки; материал не показывает, что команда их реализовала.

Сам автор предупреждает: MCP-сервер используют недавно, результаты ранние. Работа со сведениями на скриншотах тоже не проверена. Сервер возвращает Markdown со ссылками на изображения, но команда пока не выяснила, извлекает ли агент из них нужную информацию.

Что можно перенести в свою команду

Практический смысл кейса — в устройстве процесса. Агент получает описание функции, задачу, PR и существующие тест-кейсы, сам ищет документацию, затем предлагает тест-план. Так у тестировщика появляется материал для предметного ревью.

Для такого процесса особенно полезны точные ограничения. Фраза о поддержке загрузки файлов почти не задаёт ожидаемых результатов. Указание предельного размера и конкретной ошибки уже позволяет составить проверки границы. Если правило допускает несколько трактовок, сначала нужно согласовать поведение, затем закреплять его тестом.

MCP в этом кейсе даёт доступ к текущим страницам, включая закрытые материалы при наличии прав. Из рассказа, однако, не следует, что без него подход невозможен: для небольшого эксперимента можно передать агенту выбранный фрагмент документации. Само подключение также не гарантирует, что текст актуален и верен.

Начать можно с одной функции: проверить её описание, получить сценарии, согласовать ожидаемые результаты и только затем запускать генерацию кода. Чтобы оценить пользу, стоит измерить время подготовки и ревью, число исправлений и устойчивость тестов при следующих изменениях. Кейс Документерры даёт воспроизводимую схему такого эксперимента, но пока не доказывает экономию для любой команды.

Сюжет

Вопросы и ответы по материалу

Что известно по теме: от инструкции до двух тестов?

В примере агент получает инструкцию по восстановлению пароля: открыть страницу входа, перейти по ссылке восстановления, ввести логин или почту и запросить письмо. Документацию он читает через MCP — подключение, которое позволяет обращаться к инструментам поиска и чтения страниц. Из инструкции Claude составляет два сценария. Первый проверяет, что ссылка со страницы входа открывает форму восстановления. Второй — что пустой логин вызывает ошибку валидации и пользователь остаётся на той же странице.

Что известно по теме: два ревью остаются за людьми?

Команда описывает два обязательных ручных этапа. Сначала человек проверяет документацию, затем — составленные моделью тест-кейсы. После этого контролирует создание автотестов. Первое ревью защищает от устаревших требований. Если инструкция описывает поведение, которое продукт уже изменил, агент может аккуратно воспроизвести ошибку в сценариях. Зелёный прогон в таком случае покажет соответствие неверному ожиданию. Второе ревью нужно для проверки покрытия.

Что известно по теме: что можно перенести в свою команду?

Практический смысл кейса — в устройстве процесса. Агент получает описание функции, задачу, PR и существующие тест-кейсы, сам ищет документацию, затем предлагает тест-план. Так у тестировщика появляется материал для предметного ревью. Для такого процесса особенно полезны точные ограничения. Фраза о поддержке загрузки файлов почти не задаёт ожидаемых результатов. Указание предельного размера и конкретной ошибки уже позволяет составить проверки границы.

ЖХ
Жемал Хамидун — CPO Alpina Digital, продакт-менеджер AlpinaGPT. Делает AI-продукты с 2019 года. Hamidun News — pet project, который вырос в production-агрегатор с 6000+ читателей.
✦ Практика · Hamidun Academy

Соберите рабочего ИИ-агента или сервис своими руками без ручного кода

В Академии Жемала Хамидуна (academy.hamidun.com) открыт бесплатный 72-часовой тест-драйв: интерактивные скетч-уроки по Claude Code и Cursor, живой Tech Radar и готовые шаблоны агентов.

Открыть 72ч бесплатный доступ →Интенсив по Вайб-кодингу
Что вы думаете?
Загружаем комментарии…