re:re:actable
Урок 013 минуты чтения

Что такое user story и acceptance criteria

На этой странице
Кратко

User story описывает небольшую потребность пользователя и ее ценность, а acceptance criteria, или критерии приемки, уточняют проверяемое поведение конкретной задачи. История — повод для обсуждения, а не замена всем требованиям. Для frontend важно согласовать успешный сценарий, ошибки, состояния и ограничения. User stories удобны, но не обязательны в Scrum: технические задачи и исследования можно описывать напрямую.

Вопрос

Как написать хорошую user story? Чем критерии приемки отличаются от технических подзадач и Definition of Done?

История, задача и подзадача

ПонятиеНазначениеПример
EpicКрупная область работы, требующая декомпозицииУправление подпиской
User storyНебольшая пользовательская потребностьПользователь видит дату следующего списания
TaskКонкретная работа; значение зависит от командыОбновить клиент платежного API
SubtaskЧасть реализации выбранной работыДобавить обработку ошибки запроса

Epic, story и task — распространенные термины инструментов и практик, а не обязательная иерархия Scrum.

Шаблон user story

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

Шаблон помогает обсудить для кого, что и зачем. Если всем понятнее короткое обычное описание, строгая формула не нужна.

Плохой вариант: «Как пользователь, я хочу React-компонент, чтобы использовать React». Здесь технический способ реализации выдается за потребность.

Признаки хорошей истории: INVEST

БукваСмыслПроверочный вопрос
I — IndependentПо возможности независимаяМожно ли выполнить ее без длинной цепочки других историй?
N — NegotiableДопускает обсуждениеМожно ли вместе выбрать способ решения?
V — ValuableИмеет ценностьКому и в чем станет лучше?
E — EstimableПоддается оценкеДостаточно ли понимания, чтобы обсудить размер?
S — SmallНебольшаяРеально ли закончить в рабочем цикле команды?
T — TestableПроверяемаяКак убедиться, что ожидаемое поведение работает?

Полная независимость не всегда достижима. Важно обнаруживать зависимости, а не скрывать их ради формального соответствия шаблону.

Критерии приемки

Для истории о подписке команда может согласовать:

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

Последний пункт требует проверки серверной авторизации: скрыть элемент на клиенте недостаточно.

Given / When / Then

Критерий удобно записать через условия, действие и результат:

Given: у пользователя активная подписка, запрос статуса завершился ошибкой
When: пользователь нажимает «Повторить»
Then: выполняется новый запрос, а после успеха отображаются данные подписки

Это один из способов формулировки. Не каждый критерий обязательно превращать в отдельный E2E-тест: уровень автоматизации выбирают по риску и стоимости проверки.

Критерии приемки и DoD

Acceptance criteria описывают особенности конкретной работы: какие данные и поведение нужны в сценарии подписки.

Definition of Done задает общую планку качества результата: например, изменения проверены, интегрированы и прошли обязательные тесты.

Выполнить все критерии истории, но пропустить обязательное ревью — недостаточно для Done. Пройти линтер, но показывать неверную дату списания — недостаточно для приемки истории.

Частые ошибки

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

Мини-шпаргалка

Story: кто → потребность → ценность. Критерии: наблюдаемое поведение и границы. INVEST помогает проверить размер и понятность. Acceptance criteria относятся к задаче, DoD — к общему качеству инкремента.

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

Agile Alliance: User Stories, Bill Wake: INVEST.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам