Формулировка задачи для разработчика или AI‑инструмента (включая vibe coding)
Научиться чётко формулировать задачу для тех, кто будет создавать автоматизацию – будь то программист или AI-инструмент. Также познакомимся с понятием «vibe coding» – когда мы описываем задачу человеческими словами, а ИИ помогает писать код.
Из чего состоит понятная постановка задачи
Когда вы решили, что хотите автоматизировать и каким способом, наступает время формулирования технического задания. Хорошее ТЗ содержит три элемента: что поступает на вход, что должно быть на выходе и как вы поймёте, что задача решена.
Хорошая задача описывает вход, ожидаемый выход, ограничения и проверяемый критерий готовности.
Если работаете с разработчиком, пишите понятно и по делу: опишите сценарий, ограничения и критерии приёмки. Не нужно накидывать кучу технических деталей, которые могут запутать. Например: «Нам нужен скрипт, который по Excel-файлу с заказами формирует PDF-счёт по существующему шаблону и отправляет его клиенту». Здесь ясно: вход – Excel с колонками, выход – PDF по шаблону, и результатом считается отправка письма.
Для готовых AI-сервисов или генераторов («vibe coding») тоже важно описать задачу словами или примерами. Vibe coding – это когда вы говорите ИИ, чего хотите (на естественном языке или голосом), и он генерирует код или настройки. Например, можно дать Promt: «Создай веб-сайт с формой обратной связи и картой офисов» – и сервис создаст проект. Но даже в этом случае надо проверять результат и указывать ограничения (язык, дизайн, интеграции).
По словам специалистов, ключевое – четкость. Формулируйте задачу без фраз типа «сделайте с этим что-нибудь». Опишите формат данных, пример входа и пример желаемого выхода. Избегайте лишнего жаргона и многословности. Также сразу согласуйте критерии качества: как будет понятно, что задача выполнена успешно. Например: «клиенту должно прийти письмо с прикреплённым счётом» или «в базе не должно появляться ни одной новой ошибки».
Вы хотите ускорить составление коммерческих предложений. Можно написать: «Скрипту на вход поступают цены и список услуг; на выходе нужен документ КП по фирменному шаблону, в который автоматически подставляются эти данные и подсчитывается общая стоимость». Для AI-инструмента это может превращаться в подробный prompt: «Построй график по данным из файла, наложи стиль нашей компании». Без чёткого описания результатов ни разработчик, ни алгоритм не поймут задачу.
Зачастую формулируют задачу «впопыхах» или слишком абстрактно. Например, пишут «устраните проблемы с отчётами» – понятно, что это не ТЗ. Другой край: лезут в детали кода (определённые API, переменные, названия файлов), которых исполнитель может ещё не знать – это мешает восприятию основных задач. Ещё ошибка – не обговорить критерии приёмки. Нужно заранее решить: что конкретно мы измерим или проверим. Если это бот, то «100% ответов должны быть корректными» – и как это проверять? Лучше договориться: «пока бот отвечает в параллель с людьми, и его ответы вручную сверяют хотя бы по выборке».
Попробуйте сейчас
Составьте короткое техническое задание для одной из ваших задач. Опишите, какие именно данные будут на входе, что нужно получить на выходе и как проверить результат. Например: «На вход поступают письма клиентов – нужно, чтобы ИИ-классифицировал тему письма и автоматически создавал задачу в системе учёта». Такая чёткая формулировка сразу даст понять, что нужно сделать. Это может быть список требований или пример prompt’а для AI.
Что важно запомнить
- Опишите входные данные, ожидаемый выход и критерий приёмки.
- Добавьте сценарий, ограничения и примеры форматов.
- Не заменяйте бизнес-задачу лишними техническими деталями.
- Результат AI и vibe coding также нужно проверять по заранее заданным критериям.
Урок пройден
10 000 ₽ · 60 минут · онлайн