Термин

Спецификация задачи (spec)

Точное письменное описание того, что должна делать программа или ИИ-агент: сценарии, ограничения, ожидаемый результат — составленное до того, как начинается генерация кода. Чем подробнее спецификация, тем меньше сюрпризов в готовом результате.

Что это

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

Как это применяется на практике

В агентной разработке спецификацию часто составляют вместе с самим ИИ: вы формулируете задачу, агент уточняющими вопросами восстанавливает недостающие детали, и только после этого начинает генерировать код. Готовую спецификацию потом удобно сверять с результатом при ревью — вы проверяете не «код в целом», а конкретные пункты, которые заказывали.

Почему это важно вам

Вам не обязательно знать технические термины, чтобы написать хорошую спецификацию, — достаточно объяснить задачу так подробно, как объяснили бы новому сотруднику в первый рабочий день: кто пользователь, что именно должно произойти на каждом шаге, что точно нельзя допускать (например, что форма не должна отправляться без согласия на обработку данных). Расплывчатая формулировка задачи в подавляющем большинстве случаев даёт расплывчатый или неверный результат — и не важно, насколько «умная» модель его собирает.