Запрос, проблема пользователя, желаемое поведение, ограничения, макеты и принятые решения.
Текст задачи с контекстом, критериями приёмки, исключениями, ссылками и необходимыми подзадачами.
Кому пригодится
Продуктовым менеджерам, аналитикам и командам разработки.
Требования и ограничения
Подготовить задачу Jira, понятную без пересказа встречи
Jira Ticket Writer превращает запрос или рабочие заметки в описание задачи с контекстом, критериями приёмки и границами работы. Он полезен, когда разработчикам и тестировщикам нужно одинаково понять ожидаемое поведение.
На выходе получается текст для переноса в Jira. Настройка самого трекера и выбор задач на спринт в область скилла не входят. Сначала он уточняет результат, затем критерии и пограничные случаи, после этого обсуждает размер задачи.
Что передать для подготовки
- Конкретную роль пользователя и проблему, которую нужно решить.
- Причину появления задачи и ссылку на запрос, обсуждение или инцидент.
- Желаемое поведение продукта.
- Известные пустые состояния, ошибки и ограничения прав.
- Макеты, API-контракты и ранее принятые решения.
- Явно согласованные исключения из объёма работ.
Как описать результат
Для продуктовой задачи скилл связывает роль, нужную возможность и её пользу. Если пользу трудно сформулировать, это повод уточнить запрос. Техническую работу, например миграцию, можно описать прямым указанием результата без искусственной пользовательской истории.
Неизвестные детали отмечают как предположения. В описании сохраняют контекст и ссылки, чтобы спустя время команда могла восстановить причину изменения.
Как составить критерии приёмки
Каждый критерий задаёт начальные условия, действие и наблюдаемый итог. Наряду с основным сценарием рассматривают отсутствие данных, ошибки и права доступа. Для выгрузки это могут быть состав столбцов, пустой файл с заголовками и понятное сообщение при сбое.
Фразы «работает быстро» или «удобно использовать» требуют уточнения условий и результата. Числовые пределы берут из требований проекта. Примеры скорости или объёма в исходнике служат иллюстрацией и не задают требования к любому продукту.
Как решить вопрос с размером и оценкой
Скилл проходит критерии INVEST: независимость, возможность обсуждать реализацию, польза, возможность оценки, небольшой объём и ясные условия проверки. Зависимости записывают; существенные неизвестные могут потребовать отдельного исследования.
Подзадачи предлагают, когда работа затрагивает несколько исполнителей или направлений. Оценку в баллах связывают с общей шкалой команды, сложностью и неопределённостью. Сильное расхождение оценок служит поводом уточнить содержание. Авторские пороги для разделения задач не гарантируют конкретный срок реализации.
Что проверить перед добавлением в план
Итоговый текст содержит название, контекст, критерии, исключения, ссылки, необходимые подзадачи и предложение по оценке. Разработчик должен понимать работу без участия в исходной встрече, а тестировщик — воспроизвести условия приёмки. Неясные требования остаются открытыми вопросами до согласования.
Автор и источник
Оригинальное название: jira-ticket-writer
Автор или репозиторий: SkillMedev/skills
Лицензия: MIT
Открыть первоисточник