Цифровые продукты ·
Одна ошибка должна остаться одной задачей
После нескольких запросов ИИ форма может начать отправляться, но перестать сохранять данные. Отладка с ИИ требует границы: какую ошибку мы исправляем, чем подтверждаем причину и как узнаём, что соседнее действие осталось рабочим. Начать можно с одного короткого сценария.
Сначала добейтесь повторения
Возьмём учебный пример: в тестовом приложении кнопка «Сохранить» иногда ничего не меняет. Фраза «почини сохранение» оставляет слишком много неизвестного. Запишите исходное состояние, вводимые данные, последовательность нажатий, ожидаемый результат и то, что произошло. Это условный пример, а не история клиентского проекта.
Повторите действия в той же версии приложения. Если ошибка исчезла, сравните условия: новый или существующий объект, роль пользователя, обязательные поля, соединение. Не начинайте массовую переделку по одному неясному наблюдению. Первый результат отладки — сценарий, который позволяет другому человеку увидеть ту же проблему.
Найдите место, где ожидание расходится с фактом
У сохранения есть цепочка: нажатие, проверка формы, запрос, ответ, запись данных и обновление экрана. Узнайте, какой шаг действительно случился. Если запрос не отправился, разбор базы данных преждевременен. Если запись появилась, а экран её не показывает, задача отличается от отказа сохранения.
В документации VS Code по отладке описаны точки останова и просмотр состояния программы. Их можно использовать, чтобы остановиться на нужном шаге и проверить значения. Инструмент выбирают под проект; наблюдение должно ответить на конкретный вопрос, а не просто добавить ещё один журнал.
Передайте модели небольшой пакет доказательств
Для запроса достаточно сценария, текста ошибки, связанного фрагмента кода и наблюдения о том, где остановилась цепочка. Укажите, какая версия работает и что уже проверено. Удалите токены, пароли, личные данные и содержимое чужих документов. Если нужен пример ответа сервера, замените значения вымышленными, сохранив структуру.
Запрос можно сформулировать так: «После заполнения обязательных полей запрос сохранения не появляется. Вот обработчик и ошибка. Назови вероятную причину и проверку, которая её подтвердит. Пока не меняй код». Это задание на исследование. Оно позволяет оценить гипотезу до того, как появится большой набор правок.
Одна гипотеза требует одной проверки
Допустим, модель предполагает, что форма считает необязательное поле обязательным. Проверьте состояние этого поля и результат валидации. Если наблюдение не совпадает с предположением, вернитесь к доказательствам. Уверенное объяснение не становится причиной ошибки, пока его не подтверждает поведение программы.
Когда причина понятна, попросите минимальную правку и объяснение её границы. Сохраните исходную рабочую версию доступным в проекте способом. Не поручайте вместе с исправлением смену библиотеки, оформление формы и перестройку хранилища: несколько независимых изменений затруднят оценку того, что именно помогло.
Исправление заканчивается повторной проверкой
Пройдите исходный сценарий с теми же данными. Затем проверьте ближайшее соседнее действие: неверное обязательное поле должно по-прежнему давать отказ, существующий объект — обновляться, повторное нажатие — вести к согласованному результату. Проверка зависит от причины; универсального набора из трёх кнопок здесь нет.
Если в проекте есть автоматические проверки, запустите подходящие к изменению. Для важного повторяемого дефекта полезно сохранить тест, который воспроизводил ошибку до правки. Зелёная сборка сама по себе не подтверждает сохранение: она отвечает на другой вопрос. Проверяйте реальное поведение в тестовом окружении.
Оставьте короткую запись для следующего раза
Запишите симптом, подтверждённую причину, изменённое место и проверенный результат. Отдельно перечислите то, что ещё неизвестно. Если исправление не прошло проверку, вернитесь к сохранённой версии или ограничьте дальнейшую работу; не считайте длинный ответ ИИ свидетельством успеха.
Это упражнение можно выполнить после первого шага в вайбкодинге и до публикации первого сайта. Продолжение практики я собираю в авторском Telegram-канале о вайбкодинге. Если за ошибкой обнаруживаются неясные правила продукта или связанная цепочка систем, разбор разработки поможет определить задачу до новых правок.
От идеи к цифровому продукту
Если задача требует сервиса или внутреннего инструмента, определим первый законченный сценарий и путь к работающей версии.