ИИ-агент для ревью кода: правила проверки

Собери правила для агента, который проверяет код в наших задачах.

Что за код: [КОД: Python, бэкенд на FastAPI, пишут четверо]
Что болит: [БОЛЬ: ревью занимает часы, а половина замечаний — про форматирование, которое и так чинит линтер]
Чего хочу: [ЦЕЛЬ: агент смотрит первым и оставляет только то, что линтер не ловит]
Где запускается: [ГДЕ: по событию из репозитория, через n8n]

Что нужно:

1. Список того, что агент проверяет, — не больше шести пунктов. Каждый должен быть тем, чего линтер и типизация не поймают: поведение при пустом входе, запросы в цикле, проглоченные исключения, ветка без возврата значения, обращение к внешнему сервису без таймаута.
2. Список того, что агент НЕ комментирует никогда: длина строк, порядок импортов, кавычки, имена переменных, если они читаемы. Без этого списка любой такой агент скатывается в спор о запятых, и люди перестают его читать.
3. Формат замечания: строка с местом, одна фраза о последствии и предложение правки. Без «рекомендуется рассмотреть возможность» и прочей ваты.
4. Когда агент обязан промолчать. Опиши это явно: если в диффе нечего сказать по первому списку, он пишет одну строку «замечаний нет». Модель по умолчанию считает, что от неё ждут находок, и выдумывает их.
5. Что делать с уверенностью: как отличить «точно сломается» от «выглядит подозрительно» и в какой форме показывать второе, чтобы человек не проверял всё подряд.

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

Проверка перед выдачей: возьми свой же список из первого пункта и проверь, что ни один пункт не ловится линтером. Если ловится — выкинь его и скажи, какой выкинул.

Собрать под себя — поля заполнены рабочими значениями, меняйте их и промпт выше обновится сам