Промпты: отладка

Готовые формулировки под конкретные задачи: собрать проект, найти баг, отрефакторить, написать тесты. Копируйте целиком — они рассчитаны на агентные режимы Cursor, Claude Code и Windsurf. У каждого промпта написано, зачем в нём та или иная строка.

Найти причину бага

Любой агент
Вот ошибка: {текст ошибки}.
Сначала объясни причину словами, не правь код.
Потом предложи минимальную правку и скажи,
какие ещё места в проекте она затронет.

Главный отладочный промпт. Запрет сразу править код резко повышает шанс, что найдут настоящую причину.

Баг без сообщения об ошибке

Любой агент
Ожидаю: {что должно происходить}.
Получаю: {что происходит на самом деле}.
Ошибок в консоли нет.
Перечисли пять возможных причин по убыванию
вероятности и скажи, как проверить каждую.
Код не правь.

Для случаев, когда ничего не падает, но работает не так.

Разобрать чужой стектрейс

Любой агент
Вот стектрейс: {вставить}.
Объясни по-русски: что произошло, в какой строке
настоящая причина, а какие строки — просто
передача ошибки выше.
Правку предложи отдельно, после объяснения.

Экономит время на длинных трейсах, где настоящая причина в середине.

Баг воспроизводится не всегда

Любой агент
Баг: {описание}. Воспроизводится примерно
в {доля} случаев.
Предположи, что может быть источником
недетерминированности: время, гонки, кэш,
внешние сервисы, порядок данных.
Предложи, как поймать это в логах.

Плавающие баги: направляет агента в сторону типовых причин вместо угадывания.

После правки сломалось другое

Любой агент
После правки {что меняли} перестало работать
{что сломалось}.
Найди связь между этими местами.
Объясни её словами. Верни рабочее поведение,
не откатывая исходную правку целиком.

Частая ситуация после агентных правок: помогает не откатывать всё подряд.

Медленно работает

Любой агент
Это место работает медленно: {файл или функция}.
Найди, что именно занимает время: запросы в базу,
циклы, обращения по сети, лишние пересчёты.
Сначала покажи анализ и цифры, потом правку.
Не оптимизируй то, что не является узким местом.

Запрет на преждевременную оптимизацию: без него агент переписывает всё подряд.

Как пользоваться промптами

Фигурные скобки — это места, куда нужно подставить своё: {стек}, {файл}, {текст ошибки}. Промпт без подстановки работать будет, но хуже: агент начнёт угадывать.

Второе правило — не склеивать несколько промптов в один запрос. Каждый рассчитан на одну задачу, и вместе они дают три посредственных результата вместо одного хорошего.

Что работает лучше промптов

Файл правил проекта в корне репозитория. То, что вы иначе повторяли бы в каждом сообщении — стек, запреты, порядок работы, — пишется один раз и действует во всех сессиях у всей команды.

Как его составить, разобрано в гайде «Правила проекта для агента».