Как проверить код с помощью ИИ: практическое ревью

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

Удалите токены, пароли, данные клиентов и конфиденциальные фрагменты. Для проверки логики используйте обезличенный пример. Не предоставляйте доступ к production только ради ревью. Если в проекте есть правила по передаче исходников внешним сервисам, соблюдайте их.

Готовая инструкция: «Проведи ревью этой функции. Раздели замечания на ошибки поведения, риски и необязательные улучшения. Для каждой ошибки покажи вход, ожидаемый результат и фактический результат. Предложи минимальное исправление и тест. Не меняй интерфейс функции без объяснения». Такой запрос подходит для CodeGenius и специализированного промпта Code Review Senior.

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

Рассмотрим выражение JavaScript: const retries = options.retries || 3. Требование: если число повторов не задано, использовать 3; если пользователь явно передал 0, не повторять действие. При options.retries равном 0 выражение возвращает 3, поскольку оператор || выбирает правую часть при ложном значении слева.

Если по договорённости отсутствие значения представлено только null или undefined, минимальная правка — const retries = options.retries ?? 3. Она сохраняет 0. При этом сама правка не проверяет отрицательные числа, строки и другие недопустимые входы. Их обработка зависит от контракта функции и должна быть рассмотрена отдельно.

Тест должен воспроизводить требование и обнаруживать исходную ошибку. Для нашего примера особенно важен вход 0: он отличает корректную обработку от старого выражения. Проверка только значения 2 не обнаружила бы дефект. Запустите тест сначала на исходной версии, затем на исправленной и убедитесь, что результат изменился по нужной причине.

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

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

Для Python-задач можно перейти к PyBot, а для ревью нескольких языков — к CodeGenius. Ответ помощника остаётся предложением до проверки в вашей среде. Если выполненный тест не подтверждает замечание, добавьте результат в диалог и уточните анализ.