AI code review на кожен PR

AI code review запускається автоматично при кожному pull request і дає первинний зворотний зв'язок раніше за людину. Агент перевіряє код за чек-листом команди, залишає коментарі прямо в PR і позначає місця, які потребують уваги сеньйора.

Мета — зняти механічний шар перевірок і залишити людині архітектурні рішення.

Що відбувається при відкритті PR

1. Тригер. Hook у Git-репозиторії ловить подію pull_request: opened або synchronize і передає diff AI-агенту.
2. Статичний аналіз. Агент проганяє diff через критерії перевірки: стиль, патерни безпеки, обробка помилок, тестове покриття змінених файлів.
3. Семантичний розбір. AI-агент на AI-моделі читає diff у контексті проекту — розуміє, що саме змінилося і навіщо, а не тільки як.
4. Коментарі. Агент залишає inline-коментарі в PR: зауваження по рядках, пропозиції рефакторингу, посилання на гайдлайни команди.
5. Зведений звіт. В опис PR додається зведення: ризики, задіяні модулі, рекомендація (готово до перевірки людиною / потребує виправлень автора).
6. Ескалація. Якщо агент знаходить критичне зауваження (безпека, breaking change, архітектурний ризик) — ставить label і тегає відповідального сеньйора.
7. Цикл реагування. При пуші нових комітів агент переоновлює ревʼю: відзначає виправлені зауваження, фокусується на diff від попередньої версії.

Що автоматизація НЕ робить

• Не замінює фінальної перевірки людиною. Merge вимагає підтвердження людини. Агент знімає механічний шар, але архітектурні рішення залишаються за командою.
• Не вирішує проблему неясних вимог. Якщо завдання поставлено некоректно, агент це не виправить — він оцінює код, а не продуктову логіку або відповідність тікету.
• Не гарантує відсутність багів. Зниження помилок на розробника на 20% — це верхня межа з референсних кейсів. Агент ловить типові патерни, але граничні випадки та інтеграційні проблеми залишаються зоною тестів і QA.

Побічний ефект — розмір PR падає на 82%. Розробники бачать швидкий автоматичний зворотний зв'язок і переключаються на дрібніші, інкрементальні коміти. Це спрощує процес злиття, скорочує час до ревʼю і знижує ризик регресій при відкаті.

AI code review збирається як набір пов'язаних сервісів навколо Git-провайдера. Центральний компонент — AI-агент, який отримує diff і повертає структуровані коментарі з прив'язкою до рядків.

Технічний процес

Ланцюжок запускається вебхуком від Git-провайдера (GitHub, GitLab, Bitbucket, self-hosted Gitea). Вебхук потрапляє до обробника, який виконує такі кроки:

1. Завантажує контекст PR: diff, метадані, пов'язані файли, попередні коментарі агента.
2. Формує промпт із критеріями оцінки команди та передає його AI-агенту на мовній моделі.
3. Отримує структурований JSON-відповідь: список inline-коментарів, зведення, рівень ризику.
4. Публікує коментарі через API Git-провайдера.
5. Оновлює перевірку статусу PR: ai-review: passed / ai-review: needs-attention.

Кроки впровадження

1. Інвентаризація критеріїв перевірки. Знімаємо з команди правила, які вже застосовуються при ручному ревью: код-стиль, вимоги до безпеки, паттерни обробки помилок, вимоги до тестів. Це вхідний документ для агента.
2. Вибір стека. AI-модель — дефолт для семантичного аналізу коду. Для окремих перевірок (лінтинг, security scan) використовуються спеціалізовані інструменти, AI-агент агрегує їхні результати.
3. Підключення вебхука. Налаштовується pull_request вебхук у Git-провайдері з фільтрацією за подіями (opened, synchronize, ready_for_review).
4. Пілот на одній команді. Вмикаємо агента на одному репозиторії або одній команді на 2 тижні. Збираємо зворотний зв'язок від сеньйорів: де агент допомагає, де шумить.
5. Калібрування критеріїв перевірки. За результатами пілота правимо промпт і правила ескалації — прибираємо хибні спрацювання, додаємо відсутні перевірки.
6. Розгортання. Після пілота підключаються решта репозиторіїв. Додається дашборд: пропускна здатність PR, запити на зміни, час до першого коментаря.

Компоненти рішення

Як агент працює з критеріями оцінки

Критерії перевірки передаються агенту як системний промпт: набір правил із прикладами хорошого та поганого коду. Кожне правило має пріоритет (blocker / warning / suggestion). Агент повертає відповіді у структурованому JSON — inline-коментарі прив'язані до рядків, зведення описує загальні ризики.

При оновленні PR агент повторно проганяє diff, але враховує попередні коментарі: не дублює зауваження, позначає виправлені проблеми, фокусується на нових змінах.

Що отримує команда

Метрики з референсних кейсів: пропускна здатність PR +110% (з 11.4 до 23.9 PR на розробника), запити на зміни -39%, помилок на розробника -20%, середній розмір PR -82%. Час до першого коментаря на PR скорочується з годин до хвилин — розробник не чекає сеньйора, щоб зрозуміти, що код готовий до злиття.

Базовий набір — Git-провайдер з API та вебхуками, формалізовані правила рев'ю, готовність команди адаптувати процес.

Дані та доступ

• Git-репозиторій з API. GitHub, GitLab, Bitbucket або self-hosted Gitea — будь-який провайдер з pull/merge request API та вебхуки.
• Токен з правами на коментування PR та встановлення перевірок статусу.
• Наявні критерії перевірки або гайдлайни код-стилю. Якщо немає — їх потрібно зібрати до старту, це 1-2 дні роботи з техлідом.
• CI/CD pipeline (опційно). Якщо агент має читати результати тестів і покриття — потрібен доступ до CI-артефактів.

Готовність команди

• Техлід або сеньор відповідає за критерії перевірки та калібрування агента на пілоті.
• Розробники згодні на новий крок у PR-флоу. AI-коментарі — підказки, а не блокер; фінальне рішення залишається за людиною.
• SLA на реакцію на AI-коментар. Без процесного правила агент перетворюється на шум, який ігнорують.

Таймлайн

Складність — вихідні (базова конфігурація). Реалістичний термін впровадження — 2-4 тижні:

1. Тиждень 1: інвентаризація критеріїв оцінки, вибір стеку, підключення вебхука.
2. Тиждень 2: налаштування AI-агента, тести на одному репозиторії.
3. Тижні 3-4: пілот на одній команді, калібрування, розкатка.

Для команд зі складною монорепою або специфічними вимогами (відповідність вимогам, закриті правила безпеки) термін зростає до 6-8 тижнів.