
🤖 AI-агент для Code Review: как автоматизировать ревью Pull Request в GitHub
Коротко: AI-агент подключается к GitHub через MCP, анализирует дифф каждого Pull Request, проверяет код на баги, утечки памяти, безопасность и оформление — и оставляет структурированный комментарий прямо в PR. Работает 24/7, не пропускает типовые ошибки, экономит часы ревью каждую неделю.
Проблема: code review — узкое горлышко разработки
Каждый разработчик знает это чувство:
- 👉 PR висит 3 дня, потому что старший разработчик занят
- 👉 В код попала уязвимость, потому что человек устал и пропустил
- 👉 Однотипные замечания: «нет валидации», «не обработан edge case», «забыл комментарий»
- 👉 После каждой code review — список правок на час
Согласно исследованию SmartBear, разработчик тратит до 6 часов в неделю на code review. А качество ревью падает после 60 минут непрерывной проверки. AI не устаёт и не пропускает детали.
Решение: AI-агент, который делает первичный code review автоматически — быстрее, объективнее и без пропусков.
Реальный пример: как AI-агент сделал ревью сложного PR
Платформа AgentsWorks позволяет создавать AI-агентов, которые подключаются к GitHub через MCP-протокол и делают полноценный code review. Вот как это выглядит на реальном PR.
🎯 PR #47641 — остановка retry при долгом ожидании от провайдера
Задача: Исправить ситуацию, когда провайдер (например, OpenAI) возвращает retry-after: 86400 (сутки) — сессия зависала в retry на часы. Нужно останавливать retry после 5 минут ожидания.
Этот пример требует от AI-агента понимания внутренней архитектуры проекта: ему пришлось проверить логику в нескольких взаимосвязанных файлах, проанализировать побочные эффекты и сверить изменения с основной веткой dev.
▶️ Что сделал AI-агент
| Действие | Результат |
|---|---|
| ✅ Прочитал описание PR + issue | Понял бизнес-логику: проблема зависания сессии |
| ✅ Проверил CI на head-коммите | Зелёный (compliance/standards) |
| ✅ Проанализировал дифф | retry.ts — новое условие RETRY_MAX_WAIT |
✅ Сравнил изменения с основной веткой dev | Сверил, как потребляется policy() — убедился, что механика корректна и не ломает существующие сценарии |
| ✅ Проверил точность условия | Убедился, что wait > RETRY_MAX_WAIT не задевает стандартный бэкoff (429/5xx) |
| ✅ Проанализировал тесты | Покрывают обе стороны границы; регрессия зафиксирована |
| ✅ Нашёл неочевидные баги | 3 замечания (см. ниже) |
| ✅ Опубликовал ревью на GitHub | Ссылка на ревью |
🔍 Что конкретно нашёл AI
| # | Приоритет | Замечание | Тип проблемы |
|---|---|---|---|
| 1 | 🟡 Medium | Гонка UI/логики: next: now + wait публикуется до решения об остановке — пользователь на мгновение видит «следующая попытка через 12ч» (которая никогда не случится) | Побочный эффект (side effect) |
| 2 | 🟡 Medium | Продуктовое решение: порог 5 минут — провайдер, легитимно просящий подождать 6+ минут, получит фейл вместо паузы. Условие корректно, но шире, чем буквальная задача из issue | Архитектура / Product |
| 3 | 🔵 Low | Нит: RETRY_MAX_DELAY (24.8 дня) и RETRY_MAX_WAIT (5 мин) легко перепутать — нужен перекрёстный комментарий в коде | Поддерживаемость (maintainability) |
| 4 | 🔵 Info | CI-джобы проходят за ~6 секунд — возможно, не выполняют race-тесты (автор ссылается на локальный прогон) | CI-процесс |
Итоговая оценка AI: «Код корректен и готов к мержу после уточнения UI-гонки. Отличная работа! 👍»
🚀 Как создать AI-агента для Code Review на AgentsWorks
На платформе AgentsWorks это настраивается за 15 минут без единой строки кода.
Шаг 1. Подключите GitHub MCP к агенту
В конструкторе агента нажмите «Добавить инструменты» → выберите GitHub из списка MCP-серверов.
Укажите:
- Personal Access Token (GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens)
- Разрешите доступ к нужным репозиториям
- Выберите методы: чтение PR, комментирование, чтение файлов, проверка CI
Подробнее о настройке подключений читайте в статье «Skills vs MCP».
Шаг 2. Создайте агента (2 варианта)
Вариант A — Быстрый старт: Используйте готового GitHub-ассистента — он уже умеет анализировать код и делать code review.
Вариант B — Свой промпт: Воспользуйтесь ИИ-ассистентом и опишите задачу:
«Создай агента для code review. Он подключается к GitHub, анализирует Pull Request: проверяет дифф, тесты, edge cases, безопасность, стиль кода, архитектурные последствия. Сравнивает изменения с основной веткой. Оставляет структурированный комментарий в PR: что хорошо, что плохо, что нужно исправить до мержа.»
Шаг 3. Настройте системный промпт (copy-paste)
Вот готовый промпт, который можно скопировать в настройки агента:
Ты — AI-ревьюер кода. Твоя задача — анализировать Pull Request в GitHub
и давать объективную, структурированную обратную связь.
### АЛГОРИТМ РАБОТЫ
1. Получи ссылку на PR от пользователя
2. Через GitHub MCP получи:
- Описание PR и связанные issue
- Список изменённых файлов
- Дифф каждого файла (diff)
- Статус CI-проверок
3. Проанализируй:
- Общий scope изменений
- Качество кода: читаемость, структура, naming
- Безопасность: path traversal, injection, утечки, тайминги
- Edge cases: пустые значения, null, граничные условия, гонки
- Архитектурные последствия: не затронуты ли другие модули?
- Обратную совместимость
- Тестовое покрытие (оба берега границы)
- Соответствие code style проекта
4. Сформируй структурированный ответ
### ФОРМАТ ОТВЕТА
## Code Review: #{номер} — {тема}
**Author:** @{автор}
**Base:** {base} ← {head}
---
### 📌 Обзор изменений
{краткое описание}
### ✅ Что сделано хорошо
- {пункт 1}
- {пункт 2}
### 🔍 Замечания и вопросы
#### 1. {тема замечания} [HIGH/MEDIUM/LOW]
{описание}
*Почему это важно:* {объяснение}
*Рекомендация:* {что сделать}
#### 2. ... (до 10 замечаний)
### 💡 Рекомендации
| # | Приоритет | Что сделать |
|---|-----------|-------------|
| 1 | 🔴 High | ... |
| 2 | 🟡 Medium | ... |
### 📊 Итоговая оценка
**Качество кода:** [Отличное/Хорошее/Среднее/Требует доработки]
**Тесты:** [Отличное/Достаточное/Недостаточное]
**Обратная совместимость:** [Сохранена/Нарушена]
**Готовность к мержу:** [Да/После исправлений/Нет]
### ПРАВИЛА
- Будь конкретным — указывай строки кода и примеры
- Если нужно — сравнивай с основной веткой (dev/main)
- Не будь токсичным — конструктивная критика
- Разделяй критическое и опциональное
- Если PR отличный — похвали автора
Шаг 4. Используйте агента
Просто отправьте агенту ссылку на PR:
«Проверь PR https://github.com/owner/repo/pull/47641»
Через 1–2 минуты агент оставит структурированный комментарий прямо в GitHub — так же, как в примере выше.
⚡ Автоматизация: AI на каждый новый PR
Чтобы агент проверял каждый новый Pull Request автоматически:
Вариант 1: Запуск по расписанию (на AgentsWorks)
В Менеджере расписаний настройте:
| Параметр | Значение |
|---|---|
| Интервал | 300 секунд (каждые 5 минут) |
| Сообщение | «Проверь новые открытые PR в репозитории » |
| Канал уведомлений | Telegram / Email |
Агент будет каждые 5 минут проверять свежие PR и оставлять ревью.
Вариант 2: Через GitHub Actions + API AgentsWorks
Добавьте в .github/workflows/review.yml:
name: AI Code Review
on: [pull_request]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/github-script@v7
with:
script: |
const response = await fetch('https://agentsworks.ru/api/agents/v1/chat/completions', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.AGENT_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'YOUR_AGENT_ID',
messages: [{role: 'user', content: `Проверь PR #${context.issue.number}`}],
agent_id: 'YOUR_AGENT_ID',
stream: false
})
});Как получить API-ключ — читайте в статье «Как вызвать агента через API».
📊 Сравнение: до и после внедрения AI code review
| Метрика | Без AI | С AI-агентом |
|---|---|---|
| ⏱ Время на 1 PR | 20–60 минут | 1–2 минуты (AI) + 5 минут (человек финализирует) |
| 🔍 Пропущенные баги | 15–30% | меньше 5% |
| 🔄 Время ожидания ревью | 2–48 часов | меньше 5 минут |
| 📋 Глубина замечаний | 3–5 поверхностных | 8–15 детальных (безопасность, edge cases, архитектура) |
| 🧠 Усталость ревьюера | Высокая после 60 мин | Нулевая |
| 🕐 Доступность | Только в рабочее время | 24/7 |
🎯 Кому подходит
| Роль | Как использует |
|---|---|
| Tech Lead / Senior Developer | Делегирует первичное ревью AI — проверяет только спорные моменты |
| Team Lead | Видит качество всех PR в команде без погружения в каждый |
| C++ / Python / JS разработчик | Получает ревью по code style и лучшим практикам |
| Open Source мейнтейнер | Обрабатывает десятки PR от сообщества без выгорания |
| DevOps | Проверяет конфиги, CI/CD changes, IaC код |
| CTO / Архитектор | Масштабирует культуру code review без найма новых сеньоров |
🚀 Попробуйте прямо сейчас
Создайте AI-агента для code review на AgentsWorks — бесплатно, без кода, без VPN:
- 🔗 Создать агента через ассистента →
- Опишите задачу: «Создай агента для code review…»
- Подключите GitHub MCP
- Дайте ссылку на PR — получите ревью через 1 минуту
Что вы получите:
- ✅ AI-ревьюера, который работает 24/7
- ✅ Структурированные комментарии в каждом PR
- ✅ Проверку тестов, безопасности, edge cases, архитектуры
- ✅ Экономию 10–20 часов в неделю на code review
- ✅ Доступ к 400+ AI-моделям (Claude, GPT, Gemini, DeepSeek и др.)
- ✅ 50 ₽ на баланс при регистрации — для первых тестов
Полезные ссылки: