Open Code Review: проверка кода с помощью AI
Обычному AI-агенту можно поручить проверить diff, но на большом изменении он способен пропустить файл или указать неверную строку. Open Code Review от Alibaba разделяет работу: код отбирает файлы и привязывает замечания к строкам, языковая модель ищет проблемы в контексте проекта.
Как устроена проверка
Инструмент читает изменения Git. Детерминированная часть выбирает нужные файлы, объединяет связанные изменения и подбирает правила проверки. Затем агент изучает код: может открыть полный файл, поискать связанные места в репозитории и сформулировать замечание. Авторы называют это гибридной архитектурой.
На сайте проекта есть собственный бенчмарк. В нём Open Code Review показал более высокие precision и F1 при меньшем расходе токенов, чем агент общего назначения с той же моделью. Но recall ниже: часть реальных проблем инструмент может пропустить. Поэтому результат стоит рассматривать как помощь ревьюеру, а не как разрешение автоматически сливать pull request.
Какие задачи поддерживает
Команда ocr review проверяет рабочую папку, включая подготовленные, неподготовленные и новые файлы. Есть проверка одного коммита и диапазона веток. Команда ocr scan смотрит целые файлы без необходимости строить diff. Это удобно, когда знакомитесь с чужим репозиторием.
В проекте есть правила для типичных ошибок, среди них обращения к null, проблемы потокобезопасности, XSS и SQL-инъекции. Правила можно привязать к файлам. Для Codex, Claude Code, Cursor и некоторых других агентов документация предлагает интеграции. Отдельный режим делегирования оставляет выбор файлов и правил Open Code Review, а анализ выполняет модель уже запущенного кодового агента.
Первый запуск
По README нужен Git 2.41 или новее. Установите CLI из npm:
npm install -g @alibaba-group/open-code-reviewВ обычном режиме до проверки надо выбрать провайдера и модель. Это две команды, запускайте их по очереди:
ocr config provider
ocr config modelПерейдите в папку своего проекта и выполните:
ocr reviewДля проверки различий между ветками README приводит ocr review --from main --to feature-branch. Для полного сканирования конкретной папки: ocr scan --path internal/agent. Результат можно записать в JSON через ocr review --format json --output result.json.
Что проверить в команде
В обычном режиме код отправляется выбранному LLM-провайдеру. Прежде чем проверять закрытый репозиторий, согласуйте, какие файлы допустимо передавать внешнему сервису, и настройте хранение API-ключей. В режиме делегирования отдельный ключ Open Code Review не нужен, но условия работы модели вашего агента всё равно имеют значение.
Документация на официальном сайте описывает настройку правил и интеграцию с CI. Начните с небольшого pull request и сравните замечания инструмента с ручным ревью. Если в вашей команде важнее не пропустить ни один потенциальный дефект, дополняйте AI-проверку тестами и статическим анализом.