# Промпт для исправления бага: от симптома до регрессионного теста

> Промпт для исправления бага должен содержать воспроизводимый шаг, фактический и ожидаемый результат, среду, доступные доказательства и границу изменений. Сначала ИИ подтверждает причину, затем делает минимальную правку и добавляет регрессионную проверку. Просьба «почини всё» без воспроизведения заставляет модель угадывать и часто маскирует симптом.

Как поставить ИИ задачу на исправление бага: воспроизведение, ожидаемое поведение, границы, диагностика причины, тест и доказательство исправления.

- Формат: статья
- Темы: Effort, Промпт, Исправление бага, Разработка
- Автор: Редакция Нейроквалификатора
- Опубликовано: 2026-09-06
- Обновлено: 2026-09-06
- Время чтения: 3 мин.
- Редакционная проверка: Текст сверён с рабочим кабинетом, границами коробочного продукта и указанными первичными источниками

## Редакционные иллюстрации

[Симптом бага проходит через воспроизведение, причину, минимальный патч и регрессионный тест](<https://xn--80aaelradiehqoisk4a4a.xn--p1ai/article-assets/wave-5/prompt-dlya-ispravleniya-baga.webp>) - Хороший запрос ведёт от наблюдаемого дефекта к доказанному исправлению, а не к косметической маскировке.

## 1. Дайте минимальное воспроизведение

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

Не вставляйте только скриншот результата. Лог, URL, test case или запрос к API помогают повторить путь.

## 2. Разделите фактическое и ожидаемое поведение

Фактическое: PENDING заказ показывает кнопку выдачи. Ожидаемое: выдача доступна только после подтверждённого статуса оплаты.

Так агент видит нарушенный контракт и не исправляет проблему скрытием кнопки без защиты API.

## 3. Приложите доказательства без секретов

Дайте stack trace, сокращённый лог, failing test, схему данных или screenshot. Удалите токены, персональные данные и лишние большие бинарные файлы.

Если ошибка появилась после изменения, укажите commit или diff, но не утверждайте причину без проверки.

## 4. Попросите найти корневую причину

Задайте read-only диагностику до правки: проследить путь данных, найти первое неверное состояние и объяснить, почему текущий тест не ловит его.

При нескольких гипотезах агент должен проверить их наблюдением, а не выбрать самую удобную.

## 5. Ограничьте исправление

Перечислите соседние системы, которые нельзя менять, и запретите отключать проверку ради зелёного CI. Попросите сохранить обратную совместимость, если она является требованием.

Минимальная правка означает минимальный риск, а не минимальное число строк любой ценой.

## 6. Потребуйте регрессионный тест

Тест сначала воспроизводит дефект на старой логике, затем проходит после исправления. Добавьте отрицательный сценарий для соседней границы.

Для визуального бага нужен browser smoke на точном viewport; для состояния базы - integration и restart.

## Готовый каркас запроса

«В [среде] при [действиях] получаю [факт], ожидаю [результат]. Доказательства: [лог/test/URL]. Сначала воспроизведи и найди первое неверное состояние. Исправь только [scope], не меняй [границы]. Добавь регрессионный тест [сценарии] и покажи команды проверки. При отсутствии воспроизведения остановись с точным blocker».

Effort помогает заполнить этот каркас, но не воспроизводит ошибку и не подтверждает исправление.

## Экран продукта

**Настоящий экран Effort.** Effort помогает сделать контекст, ограничения и критерии результата явными до передачи задачи ИИ.

[Настоящий экран Effort с исходной мыслью и структурированной постановкой задачи](<https://xn--80aaelradiehqoisk4a4a.xn--p1ai/article-assets/product-screens/effort-translator.png>)

## Источники

- [Codex documentation](<https://developers.openai.com/codex/>) — OpenAI Developers; проверено 2026-09-06. Сверены рабочий цикл Codex, роль инструкций проекта, локальных проверок и ограниченной области изменений.
- [Claude Code best practices](<https://code.claude.com/docs/en/best-practices>) — Anthropic; проверено 2026-09-06. Сверены рекомендации исследовать контекст, планировать сложную работу, давать модели способы проверки и вести постоянные инструкции проекта.
- [Prompt engineering](<https://developers.openai.com/api/docs/guides/prompt-engineering>) — OpenAI Developers; проверено 2026-09-06. Сверены рекомендации о ясных инструкциях, релевантном контексте, примерах и проверяемом формате результата.
- [Effort Translator: рабочий интерфейс](<https://effort.xn--80aaelradiehqoisk4a4a.xn--p1ai/>) — Нейроквалификатор; проверено 2026-09-06. Сверена граница продукта: перевод исходной мысли в структурированную постановку без подмены цели и без гарантии результата.

## Сделайте постановку задачи проверяемой

Effort помогает структурировать исходную мысль. Он не заменяет модель, не знает скрытый контекст и не гарантирует качество результата.

[Подготовить запрос в Effort](<https://effort.xn--80aaelradiehqoisk4a4a.xn--p1ai/>)

## Связанный материал

[Критерии приёмки для ИИ](<https://xn--80aaelradiehqoisk4a4a.xn--p1ai/articles/kriterii-priemki-v-zadache-dlya-ii/index.md>) — Сделайте исправление наблюдаемым на правильном слое.

### Версии и навигация

- [Каноническая HTML-версия](<https://xn--80aaelradiehqoisk4a4a.xn--p1ai/articles/prompt-dlya-ispravleniya-baga/>)
- [Карта сайта для ИИ-инструментов](<https://xn--80aaelradiehqoisk4a4a.xn--p1ai/llms.txt>)
- [Каталог статей и видео](<https://xn--80aaelradiehqoisk4a4a.xn--p1ai/articles/>)
