Вторые глаза

Тот, кто делал работу, не ставит себе оценку. Ревьюер в свежем контексте видит только дифф и критерии, но не рассуждения, которые к этому диффу привели, — и поэтому ловит другой класс ошибок: не «не запустил тест», а «запустил не то».

Локальное ревью: /code-review

Команда работает без установки чего-либо в GitHub. По умолчанию она смотрит коммиты вашей ветки поверх её upstream плюс незакоммиченные изменения — то есть ей нужна работа в ветке или в рабочем дереве, иначе смотреть нечего. Целью можно передать путь к файлу, номер PR, имя ветки или диапазон вида main...my-feature.

Флаги:

• --fix — применить находки к рабочему дереву после ревью;
• --comment — опубликовать находки как инлайн-комментарии в PR;
• --post — при облачном ultra-ревью пул-реквеста на github.com предвыбрать публикацию результата.

Ревью выполняется фоновым форкнутым субагентом со своим окном, поэтому ваш котёл оно не заполняет: находки приходят в разговор, когда прогон закончился (Тени).

Важный побочный эффект: правки фонового --fix лежат вне чекпойнтов сессии, и /rewind их не отменит — только git (Долгая сессия и точки возврата).

Ручка глубины

Уровень усилия здесь работает как регулятор компромисса. На low и medium ревью сообщает только то, в чём уверено — меньше ложных срабатываний. От high и выше охват шире, но появляются находки, в которых ревью сомневается.

Если уровень не написан, используется тот, что вы набирали в прошлый раз — даже в другой сессии, и об этом печатается уведомление. Чтобы изменить запомненный уровень, наберите его явно: /code-review high (Ручка усилия).

Что читает локальное ревью

Оно следует вашему CLAUDE.md, как любая сессия, но не читает REVIEW.md — этот файл понимает только управляемый сервис на стороне GitHub. Проверьте, что ждёте от нужного механизма.

Ревью можно запускать и не вручную: агент способен начать его сам по просьбе «посмотри мои изменения», и запланированная задача с /code-review в качестве промпта тоже сработает. Если это лишнее, оставьте команду только для себя записью в настройках:

{ "skillOverrides": { "code-review": "user-invocable-only" } }

Управляемый сервис на пул-реквестах

На планах Team и Enterprise существует отдельный продукт: ревью запускается на открытие PR, на каждый пуш или по требованию — в зависимости от настройки репозитория. Комментарии приходят инлайн, на конкретные строки, с маркерами серьёзности:

Проверка (check run) всегда завершается нейтрально и никогда не блокирует слияние. Ручной запуск — комментарий @claude review (разово) или @claude review always (плюс подписка на последующие пуши). Пул-реквест из форка ревьюится только по такому комментарию.

Настраивается сервис двумя файлами. CLAUDE.md он читает как контекст проекта и считает нарушения мелочами. REVIEW.md — инструкции только для ревью: чем полезен, что считать важным, сколько мелочей публиковать за раз, какие пути пропускать, какая планка доказательности. Длина имеет цену: длинный REVIEW.md размывает правила, которые вам действительно нужны.

Куда ревью встраивается

Ревью — не отдельный ритуал, а последний слой замкнутого цикла: сначала машина проверяет фактами (тесты, сборка), потом второй агент проверяет смысл (Замкнутый цикл). В командном контуре тот же шаг переезжает в PR-поток — своим воркфлоу или управляемым сервисом (Контур гильдии).

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