Промптинг для кодинга
Как формулировать задачи для LLM на каждом этапе разработки — от ТЗ до дебага.
Дата составления: 2026-03-30
Статус: ✅ Актуально
Суть
Любую недосказанность в описании задачи нейросеть восполняет самостоятельно — в соответствии со своим представлением о том, что вы имеете в виду. Это представление может не совпасть с вашим. Именно здесь и возникает большинство проблем.
Глобальное решение — разбивка работы на этапы (см. Организация работы): чем меньше задача, чем подробнее она расписана, тем меньше пространства для додумывания. Но и каждый отдельный этап нужно формулировать так, чтобы модель понимала вас правильно.
Промптинг на каждом этапе
Составление ТЗ
На этом этапе ваша задача — не описать готовое решение, а совместно с нейросетью разобраться, что именно нужно сделать. Нейросеть здесь выступает бизнес-аналитиком, помогая оформить нечетко сформулированные пожелания и идею в подробное функциональное описание. Просите ее задавать уточняющие вопросы — это основной инструмент на данном этапе.
Что включать в промпт:
Контекст: кто будет пользоваться программой и зачем.
Что программа принимает на входе и что выдает на выходе.
Как выглядит желаемый интерфейс (веб-страница, десктоп-приложение, скрипт в командной строке) — приложите референсы, если они у вас есть.
Что точно НЕ нужно от программы — ограничения часто важнее пожеланий.
Пример:
«Я хочу программу для первичного анализа договоров. Пользователи — юристы без технического бэкграунда. Программа принимает .docx-файл, ищет в нем условия об ответственности и выводит их списком. Сложных интерфейсов не нужно — достаточно чтобы можно было запустить через браузер. Задавай уточняющие вопросы».
Проектирование архитектуры
После того как ТЗ сформулировано, попросите нейросеть предложить структуру проекта. Ключевое требование — простота: для нашего уровня задач перегруженные архитектуры не нужны.
Что включать в промпт:
Приложить ТЗ (или его финальную версию из предыдущего этапа)
Явно просить простое решение: «выбирай наиболее простые технологические решения».
Просить описать функционал каждого файла из предлагаемой структуры файлов.
Уточнить платформу, если она важна: «должно работать на Windows без установки Python» или «деплой на российский хостинг».
На этом этапе также полезно попросить LLM разработать «дорожную карту» с описанием оптимальной последовательности действий по разработке.
Итеративная разработка
Один этап дорожной карты = один чат = одна задача. Дробить нужно агрессивно.
Что включать в промпт:
Контекст проекта: ТЗ + архитектура + текущая файловая структура.
Конкретная задача этого шага — один файл целевой файловой структуры или один блок логики.
Используемый стек: версии языка и библиотек.
Ограничения: «не трогай уже написанный код в
parser.py», «используй только указанные в описании архитектуры библиотеки».
Пример:
«Проект: Python-скрипт для анализа договоров. Стек: Python 3.11, python-docx. Текущие файлы: main.py, extractor.py (уже написан). Задача: написать analysis.py в соответствии с требованиями, описанными в файле с архитектурой проекта».
Дебаг
При ошибках полнота информации важнее краткости. Нейросеть не может исправить то, чего не видит.
Что включать в промпт:
Полный трейсбэк из терминала — целиком, не пересказывая своими словами.
Описание: что делали перед тем, как появилась ошибка.
Код проблемного файла (а лучше все файлы проекта)
Скриншот — если ошибка визуальная.
Пример:
«Программа падает при запуске. Вот трейсбэк:
Traceback (most recent call last): File "main.py", line 12, in <module> df = pd.read_excel(path) FileNotFoundError: [Errno 2] No such file or directory: 'data.xlsx'
Вот код функции: [код]. Диагностируй проблему и предложи исправление».
Трейсбэк содержит всю нужную информацию — строку, файл, тип ошибки.
Если несколько итераций дебага не дают результата: откатитесь к последнему рабочему коммиту и объясните нейросети, что именно сломалось при предыдущей попытке исправления. Или попробуйте другую модель.
Что учесть
Нейросеть не «помнит» предыдущие чаты. При каждом новом сеансе давайте контекст заново.
Длинный диалог снижает качество ответов. При признаках «деградации» начинайте новый чат с брифингом.
Если код работает, но нейросеть уверяет, что он неправильный — доверяйте работающему коду. Попросите объяснить, что конкретно не так.
Связанные статьи
Организация работы — жизненный цикл проекта от ТЗ до дебага
Глоссарий — трейсбэк, контекстное окно, дебаг
Основы промптинга — общая теория: структура промпта, виды, температура
Теги: #инструкция #средний #вайб-кодинг #промптинг