Промптинг для кодинга

Как формулировать задачи для 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'

Вот код функции: [код]. Диагностируй проблему и предложи исправление».

Трейсбэк содержит всю нужную информацию — строку, файл, тип ошибки.

Если несколько итераций дебага не дают результата: откатитесь к последнему рабочему коммиту и объясните нейросети, что именно сломалось при предыдущей попытке исправления. Или попробуйте другую модель.


Что учесть

  • Нейросеть не «помнит» предыдущие чаты. При каждом новом сеансе давайте контекст заново.

  • Длинный диалог снижает качество ответов. При признаках «деградации» начинайте новый чат с брифингом.

  • Если код работает, но нейросеть уверяет, что он неправильный — доверяйте работающему коду. Попросите объяснить, что конкретно не так.


Связанные статьи


Теги: #инструкция #средний #вайб-кодинг #промптинг