Критерии приёмки задачи, которые можно превратить в тесты

Цель

Сделать понятие «готово» для отдельной задачи определимым ещё до начала работы, чтобы разработчик, ревьюер и заказчик задачи согласовали одни и те же примеры.

Предварительные условия

Задача с обозначенной целью (кому, что и зачем нужно), возможность обратиться к человеку, отвечающему на вопросы предметной области, и место для критериев рядом с самой задачей.

Шаги

1. Сформулируйте правило одним предложением, затем приведите примеры. Справочник Gherkin описывает такую структуру: исходный контекст (Given), событие (When) и ожидаемый результат (Then). Он рекомендует 3–5 шагов на пример, чтобы тот оставался читаемой спецификацией.
2. Охватите основной случай, каждую границу и пути отказа. Набор критериев для «ограничить загрузку файлов размером 10 MB» должен включать как минимум следующее: ровно 10 MB принимается, 10 MB плюс один байт отклоняется с заданным сообщением, после отклонения не остаётся частичного файла.
3. Используйте конкретные значения, а не оценочные слова: «баланс показывает £430», а не «баланс верен». В примерах самого Gherkin сопоставляются «на моём счёте есть деньги» и «баланс моего счёта составляет £430».
4. Не включайте взаимодействие пользователя в Given, а детали реализации — ни в одну часть: критерии описывают поведение, наблюдаемое на границе, доступной пользователю или клиенту.
5. Прочитайте каждый критерий и спросите: сможет ли тестировщик, никогда не видевший код, решить только по этому тексту, пройден тест или нет? Если нет, перепишите.
6. Отметьте, что намеренно не входит в объём этой задачи, чтобы ответ на «вы забыли X» содержался в задаче, а не зависел от памяти.
7. До реализации разработчик предлагает недостающие примеры, а заказчик подтверждает их. Разногласия на этом этапе обходятся дешевле, чем на ревью.
8. Превратите примеры в автоматические тесты там, где граница это позволяет (API, предметная логика), и в ручной контрольный список там, где не позволяет (визуальная компоновка). Добавьте в задачу ссылку на тест или список.

Ожидаемый результат

Ревью и приёмка становятся сравнением с перечисленными примерами; расширение объёма работ проявляется как новый пример, который нужно согласовать, а не считать само собой разумеющимся.

Ограничения и основания метода

Примеры не могут перечислить всё; нефункциональным требованиям (задержка, доступность) нужна измеримая цель, а не сценарий. Инструменты Gherkin необязательны: дисциплина заключается в примерах, а не в средстве их выполнения. Метод обобщает указанный справочник и распространённую практику; влияние на частоту дефектов не заявляется.