Pull request и code review с Claude Code

Pull request должен объяснять не только что изменено, но и почему изменение безопасно принять. Claude Code может собрать описание по фактическому diff, помочь проверить код и…

Краткий ответ

Pull request должен объяснять не только что изменено, но и почему изменение безопасно принять. Claude Code может собрать описание по фактическому diff, помочь проверить код и работать с GitHub-интеграцией, однако финальное решение о merge остаётся за командой.

Подготовка PR начинается до push

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

Хорошая структура: проблема, принятое решение, границы изменения, способ проверки, риски и план отката.

Review как поиск сценариев сбоя

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

Попросите reviewer попытаться опровергнуть находку: воспроизвести её тестом или показать путь выполнения. Это снижает число ложных срабатываний.

CLAUDE.md и REVIEW.md

Управляемый сервис Claude Code Review может учитывать проектные критерии из CLAUDE.md или REVIEW.md. Туда полезно записать специфичные инварианты: правила авторизации, требования к миграциям, запрещённые зависимости и обязательные проверки.

Не превращайте файл review в длинный общий учебник — приоритет имеют проверяемые риски именно вашего проекта.

GitHub-интеграция

Официальная команда /install-github-app проводит через установку Claude GitHub App и настройку GitHub Actions для поддерживаемого варианта авторизации. Установка требует прав администратора репозитория и выдаёт приложению заявленные разрешения к contents, issues и pull requests. Перед подключением согласуйте эти права.

Упражнение: два прохода review

Проведите два независимых запроса:

1. «Найди только корректностные ошибки и непротестированные edge cases; ничего не редактируй». 2. «Попытайся опровергнуть каждое найденное замечание по коду и тестам; оставь только подтверждённые».

Затем попросите составить PR-описание исключительно по фактам итогового diff и выполненным командам.

Частые вопросы

Автоматический review одобряет pull request?

Официальный Claude Code Review публикует замечания, но не заменяет правила защиты ветки и решение ответственных reviewers.

Нужно ли запускать review после каждого push?

Это зависит от риска, стоимости и политики команды. Документация поддерживает автоматические и ручные режимы запуска.

Можно ли доверять описанию PR, созданному агентом?

Его нужно сверить с diff и журналом проверок. Агент может сформулировать текст, но автор отвечает за точность утверждений.

Что важно запомнить

PR рассказывает о проблеме, решении, проверке и риске.
Замечание review ценно только вместе со сценарием сбоя.
Независимая верификация отфильтровывает ложные находки.
Права GitHub App и публикация должны быть осознанными.

https://yadro-code.ru/lessons/without-university/claude-code-workflows/claude-code-14