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

Как формулировать задачи для LLM на каждом этапе разработки — от ТЗ до дебага, и что меняется, когда за вас кодит агент.

Дата составления: 2026-07-27
Статус: 💡 Актуально

Суть

Любую недосказанность в описании задачи нейросеть восполняет самостоятельно — в соответствии со своим представлением о том, что вы имеете в виду. Это представление может не совпасть с вашим. Именно здесь и возникает большинство проблем.

Глобальное решение — разбивка работы на этапы (см. Организация работы): чем меньше задача, чем подробнее она расписана, тем меньше пространства для додумывания. Но и каждый отдельный этап нужно формулировать так, чтобы модель понимала вас правильно.

Промптинг на каждом этапе

Составление ТЗ

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

Что включать в промпт:

  • Контекст: кто будет пользоваться программой и зачем.

  • Что программа принимает на входе и что выдает на выходе.

  • Как выглядит желаемый интерфейс (веб-страница, десктоп-приложение, скрипт в командной строке) — приложите референсы, если они у вас есть.

  • Что точно НЕ нужно от программы — ограничения часто важнее пожеланий.

Пример:

«Я хочу программу для первичного анализа договоров. Пользователи — юристы без технического бэкграунда. Программа принимает .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'

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

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

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

Промптинг с агентами

Когда вы кодите с агентом, промптинг смещается: рутину (запуск, тесты, дебаг) агент закрывает сам, а ваш главный вклад — по-прежнему на этапе ТЗ.

  • Можно промптить «лениво». Опишите видение в двух словах — в режиме планирования агент сам расспросит и составит план, прежде чем писать код. Но чем выше ставки проекта, тем внимательнее стоит проработать ТЗ: именно на нем вы влияете на результат сильнее всего.

  • Просите агента объяснять и перепроверять себя. «Прежде чем менять код, покажи план и дождись подтверждения»; «перепроверь свою работу свежим взглядом, найди слабые места». Полезно отделять того, кто пишет, от того, кто проверяет.

  • Тесты поручите агенту. Попросите написать тесты — с этим агент справляется сам. Но откройте пару тестов и проверьте, что именно они проверяют: агент иногда пишет тесты, которые проходят тривиально.

  • Роли и правила выносите в файлы. Устойчивые требования удобно держать в CLAUDE.md или отдельном скилле, а не повторять в каждом промпте (см. Кодинг с агентами).

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

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