20.10.2025 06:27
sound_right 0 1800 Источник

В этой статье я покажу, как всего за 30 минут встроить в ваш CI/CD-пайплайн полноценного AI-ревьюера и ассистента — без платных API-ключей, без интеграции с OpenAI и без лишней инфраструктуры. Всё, что нам понадобится, — это AI Review и OpenRouter — универсальный шлюз к десяткам LLM, от GPT-4o до Claude и Mistral, доступный бесплатно.

Мы настроим систему так, чтобы она автоматически запускалась при каждом Pull или Merge Request и не только оставляла комментарии к коду — от точечных inline-замечаний до краткого summary-обзора, — но и выступала в роли AI-ассистента, способного отвечать на ваши комментарии и выполнять указания прямо внутри обсуждения.

В примере я покажу запуск через GitHub Actions, но тот же подход одинаково хорошо работает и в GitLab, Bitbucket и Gitea. При этом у вас нет никаких ограничений: AI Review поддерживает Gemini, OpenAI, Claude, Ollama, OpenRouter и работает с любыми популярными VCS — GitHub, GitLab, Gitea, Bitbucket.

Что такое OpenRouter?

OpenRouter — это универсальный шлюз к десяткам современных LLM (Large Language Models): GPT-4o, Claude, Gemini, Mistral и другим. Один API и один ключ дают доступ ко всем моделям сразу — вы просто выбираете нужную и переключаетесь между ними без изменения кода.

AI Review поддерживает OpenRouter «из коробки», поэтому остаётся только получить токен и указать его в конфигурации.

Как получить токен OpenRouter

  1. Перейдите на openrouter.ai и авторизуйтесь (через GitHub или Google).

  2. В личном кабинете откройте раздел Keys и нажмите Create Key.

  3. Дайте ключу понятное имя и скопируйте его.

  4. Рекомендуется создать отдельный ключ для CI/CD, чтобы его можно было отозвать отдельно.

Как добавить токен в GitHub Actions

Чтобы использовать токен в пайплайне, добавьте его в Secrets репозитория:

  • Settings → Secrets and variables → Actions → New repository secret

  • В поле Name: OPENROUTER_API_TOKEN

  • В поле Value: вставьте скопированный токен

Теперь ключ будет доступен как secrets.OPENROUTER_API_TOKEN и его можно безопасно использовать в workflow.

Аналогично переменные задаются и в GitLab, Bitbucket или Jenkins — имя переменной остаётся тем же.

Создаём конфиг AI Review

Первое, что нужно сделать, — это описать настройки инструмента AI Review. Он управляется через конфигурационный файл .ai-review.yaml, который располагается в корне проекта. Минимального конфига достаточно, чтобы сразу запустить AI-ревью в CI/CD:

llm:
  provider: OPENROUTER              # Используем OpenRouter как LLM-провайдера

  meta:
    model: mistralai/mistral-7b-instruct:free  # Бесплатная модель через OpenRouter
    max_tokens: 15000              # Максимальное количество токенов в ответе
    temperature: 0.3               # Чем ниже значение, тем строже ответы

  http_client:
    timeout: 120
    api_url: https://openrouter.ai/api/v1      # Базовый URL API

vcs:
  provider: GITHUB                # Используем GitHub как систему контроля версий

  http_client:
    timeout: 120
    api_url: https://api.github.com            # API GitHub

И всё — AI Review подключится к модели через OpenRouter и начнёт анализировать изменения в вашем Pull Request.

Тот же конфиг легко адаптируется под GitLab, Bitbucket или Gitea — достаточно поменять vcs.provider и api_url. Если нужно добавить собственные промпты, изменить стиль комментариев, ограничить количество замечаний или исключить файлы из анализа — всё это настраивается в расширенном конфиге. Примеры можно найти в документации AI Review.

Создаём workflow GitHub Actions

Теперь добавим пайплайн, который будет запускать AI Review автоматически при каждом Pull Request. Всё просто: создаём файл .github/workflows/ai-review.yml и используем готовый action из GitHub Marketplace.

name: ? AI Review

on:
  # Ручной запуск пайплайна из вкладки Actions (можно заменить на on: pull_request)
  workflow_dispatch:
    inputs:
      review-command:
        type: choice
        default: "run"
        options: [ run, run-inline, run-context, run-summary, run-inline-reply, run-summary-reply ]
        required: true
        description: "AI Review command"

      pull-request-number:
        type: string
        required: true
        description: "Pull request number"

jobs:
  ai-review:
    name: Run AI Review
    runs-on: ubuntu-latest
    steps:
      # 1️⃣ Клонируем репозиторий и получаем diff изменений
      - name: ? Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      # 2️⃣ Запускаем AI Review
      - name: ? Run AI Review
        uses: Nikita-Filonov/ai-review@v0.36.0
        env:
          # ? Токен GitHub для доступа к Pull Request и публикации комментариев
          VCS__HTTP_CLIENT__API_TOKEN: ${{ secrets.GITHUB_TOKEN }}

          # ? Контекст PR — владелец, репозиторий и номер запроса
          VCS__PIPELINE__OWNER: ${{ github.repository_owner }}
          VCS__PIPELINE__REPO: ${{ github.event.repository.name }}
          VCS__PIPELINE__PULL_NUMBER: ${{ inputs.pull-request-number }}

          # ? Токен OpenRouter для доступа к LLM
          LLM__HTTP_CLIENT__API_TOKEN: ${{ secrets.OPENROUTER_API_TOKEN }}

        with:
          # ? Команда ревью: полный анализ, только inline, только summary и т.д.
          review-command: ${{ inputs.review-command }}

Всё — после коммита этого файла можно запускать пайплайн прямо из вкладки Actions и получать AI-ревью кода без дополнительной настройки.

Если вы используете GitLab, Bitbucket или Jenkins, структура остаётся такой же: установите ai-review через pip install xai-review или запустите готовый Docker-образ, а затем вызовите CLI-команду ai-review run с нужными переменными окружения. Примеры конфигураций для других CI доступны в документации.

Результат

Перед запуском убедитесь, что ваш токен GitHub (GITHUB_TOKEN) имеет права read + write для Pull Requests — иначе AI Review не сможет публиковать комментарии. Это настраивается в разделе Settings → Actions → General → Workflow permissions → Read and write permissions.

Далее всё просто:

  1. Перейдите на вкладку Actions в вашем репозитории.

  2. Выберите workflow ? AI Review.

  3. Нажмите Run workflow, укажите номер Pull Request и команду ревью (например, run-inline или run-summary).

После запуска workflow AI Review автоматически подключится к модели, проанализирует diff и начнёт публиковать результаты прямо в интерфейсе PR. Вот как это выглядит на практике

Inline Review: построчные комментарии

В этом режиме AI Review анализирует каждую изменённую строку и оставляет точечные комментарии в диффе. Это основной формат ревью, который помогает быстро находить ошибки и потенциальные улучшения прямо в коде.

Summary Review: общий обзор

Здесь AI формирует одно большое сообщение под Pull Request, описывающее сильные и слабые стороны изменений, архитектурные замечания и общие рекомендации.

AI-ассистент: ответы и помощь

AI Review умеет не только анализировать код, но и выступать в роли интерактивного помощника: он может отвечать на комментарии, объяснять свою логику или выполнять дополнительные задачи по вашему запросу.

Чтобы активировать ответ ассистента, достаточно добавить в сообщение специальный тег:

  • #ai-review-inline-reply — если хотите получить ответ на конкретный inline-комментарий

  • #ai-review-summary-reply — если нужен ответ в summary-обсуждении

Эти теги можно изменить или переопределить в конфигурации, если вы хотите использовать собственный стиль запросов.

Ассистент: объяснение комментария

Мы попросим AI объяснить, почему он оставил конкретное inline-замечание в src/calculator.py. Ассистент анализирует контекст и формулирует развёрнутый ответ, который можно использовать прямо в обсуждении PR.

Ассистент: генерация тестов

В summary-обсуждении можно попросить AI написать тесты для любого компонента. Например, мы попросим его сгенерировать тесты для класса Calculator из файла src/calculator.py. Результат — готовый пример тестового файла, который можно сразу добавить в проект.

Всё это работает без дополнительного кода и настройки — ассистент активируется теми же командами (run-inline-reply и run-summary-reply) и использует тот же LLM, что и основное ревью.

Заключение

Важно понимать: сам AI Review не “оценивает качество” кода — он лишь автоматизирует процесс ревью и обеспечивает удобную интеграцию в CI/CD. Итоговый результат напрямую зависит от того, какую модель вы выберете. Хотите максимально точные и глубокие комментарии — используйте, например, gpt-4o или claude-3.5. Нужны быстрые и лёгкие проверки — подойдут mistral или phi.

В этом примере мы использовали OpenRouter и бесплатную модель, но на практике никаких ограничений нет: AI Review одинаково хорошо работает с OpenAI, Claude, Gemini, Ollama и OpenRouter, а также поддерживает все популярные системы контроля версий — GitHub, GitLab, Gitea и Bitbucket.

За 30 минут вы можете встроить в CI/CD полноценного AI-ревьюера и ассистента — без платных подписок, без внешней инфраструктуры и с полным контролем над кодом. А дальше всё зависит только от выбранной модели и ваших задач.

Полезные ссылки и демо

Чтобы не тратить время на поиски — вот всё, что нужно для повторения примера и вдохновения:

Если статья оказалась полезной — поставьте звёздочку репозиторию AI Review на GitHub. Это поможет проекту развиваться и оставаться полностью бесплатным и опенсорсным.

Комментарии (0)