Маршрутизация и одобрение PR

Маршрутизация и одобрение PR направляет pull request нужным ревьюерам и может одобрять изменения с низким риском.

Настройте Маршрутизацию и одобрение PR в разделе Автоматизации.

Как это работает

Маршрутизация и одобрение PR обрабатывает ваши pull request. Функция назначает ревьюеров на основе владения кодом и истории коммитов, а также может одобрять PR с низким риском при соблюдении заданных вами критериев.

Она не заменяет полноценное ревью кода. Функция использует оценку риска, файлы политик для одобрения, результаты ревью ИИ-Agent и вашу конфигурацию, чтобы решить, направить PR на ревью или одобрить его.

Основные возможности

Назнач��ние ревьюеров

Маршрутизация и одобрение PR позволяет назначать ревьюеров для pull request на основе владения кодом и истории коммитов.

Используйте назначение ревьюеров, чтобы указать, когда Agent должен запрашивать ревью. Agent также учитывает применимые файлы политик, параметры риска, результаты ИИ-ревьюера и текущее состояние ревью.

Одобрение с учётом рисков

Маршрутизация и одобрение PR может одобрять pull request с низким риском при соблюдении критериев одобрения.

Используйте критерии одобрения, чтобы задать условия, которым должен соответствовать PR, прежде чем Agent одобрит его. Agent также учитывает применимые файлы политик, параметры риска, результаты ИИ-ревьюера и состояние ревью.

Основные функции

Учёт результатов ИИ-ревьюеров

Маршрутизация и одобрение PR может использовать результаты других систем ревью Cursor:

• Контекст ревью Bugbot использует результаты Bugbot при принятии решения об одобрении.
• Контекст Security Review использует результаты Security Agent при принятии решения об одобрении.

Когда эти контексты включены, Agent ждёт завершения соответствующих проверок ИИ-ревьюеров и использует их результаты как сигналы для одобрения.

Если Bugbot или Security Agents сообщают о результатах, требующих ревью человеком, Маршрутизация и одобрение PR не одобрит PR.

Оценка риска

Маршрутизация и одобрение PR позволяет классифицировать PR по уровню риска и устанавливать максимальный порог одобрения.

• Использовать оценку риска включает классификацию рисков, которую можно дополнительно настроить с помощью промптов.
• Максимальный порог риска задаёт наивысший уровень риска, который Agent может одобрить.

Если уровень риска PR превышает заданный порог, Agent не одобрит его.

Файлы политик для одобрения

PR Routing & Approval может находить файлы политик в репозитории и применять их перед принятием решения об одобрении.

Для каждого изменённого файла Agent проверяет каталог, в котором находится файл, и все родительские каталоги на наличие файла с точно таким именем:

APPROVAL_POLICY.md

Доверенными считаются только файлы с точным совпадением базового имени. Такие файлы, как POLICY.md, approval_policy.md, APPROVAL_POLICY.md.bak и team_APPROVAL_POLICY.md, игнорируются при поиске политик в каталогах.

Для файлов в каталоге наивысший приоритет имеет ближайший применимый APPROVAL_POLICY.md. Политики из родительских каталогов также применяются, если не конфликтуют с более конкретной политикой.

Политики маршрутизации

PR Routing & Approval также проверяет наличие файла маршрутизации в корне проекта:

.cursor/approval-policies/ROUTING.md

ROUTING.md — это YAML-список записей о продуктах. Каждая запись содержит:

• product: название продукта или области.
• boundary: семантическую границу либо явный путь или glob относительно репозитория.
• policies: ссылки на промпты политик — явные пути к файлам или семантические описания.

Если ROUTING.md отсутствует, поиск APPROVAL_POLICY.md по каталогам всё равно выполняется. Отсутствие маршрутизации не влияет на поиск политик.

Приоритет политик

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

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

Если PR изменяет политику одобрения, файл маршрутизации, файл маршрутизируемой политики или файл политики для конкретного ревьюера, Agent не использует изменённое содержимое, чтобы ослабить требования к ревью для этого же PR. Он использует версию из base-ветки, если она доступна, или требует ревью человеком, если определить версию из base-ветки невозможно.

Настройка

Откройте раздел «Маршрутизация и одобрение PR» в «Автоматизациях», чтобы настроить его.

Включение маршрутизации и одобрения

Включите нужные возможности:

• Включить маршрутизацию PR и запросы на ревью назначает ревьюеров с учётом владения кодом и истории коммитов.
• Автоматически одобрять PR одобряет PR с низким риском после настройки критериев одобрения.

Выберите организации и репозитории, в которых должен работать Agent.

Настройка триггеров

Триггеры определяют, когда запускается Agent. Маршрутизация и одобрение PR поддерживает следующие события pull request:

• PR открыт запускает Agent при создании pull request.
• PR отправлен / обновлён запускает Agent при отправке новых коммитов в существующий PR.
• PR прокомментирован запускает Agent, когда в существующем PR публикуется комментарий, соответствующий регулярному выражению.

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

Настройте сигналы ревью

В разделе Конфигурация выберите, какие сигналы должен использовать Agent:

• Использовать контекст ревью Bugbot
• Использовать контекст Security Review
• Использовать оценку риска
• Максимальный риск для одобрения

На основе этих сигналов Agent решает, учитывать ли результаты ИИ-ревьюера, выводы проверки безопасности и пороги риска перед одобрением.

Настройка правил одобрения

Используйте пользовательский промпт, чтобы задать критерии одобрения для команды. В нём можно описать принятые требования к ревью, привести примеры PR, которые можно безопасно одобрять, или указать случаи, требующие ревью человеком.

Для соответствующих файлов приоритет по-прежнему имеют файлы политик, а не пользовательский промпт.

Если пользовательский промпт не задан, Agent будет использовать критерии Cursor managed по умолчанию.

Настройка инструментов и MCP

Для Agent должно быть включено хотя бы одно из основных действий:

• Запросить ревью
• Одобрить PR

Дополнительно можно подключить:

• Уведомления Slack.
• Уведомления Microsoft Teams.
• MCP‑серверы для доступа к дополнительным инструментам.

Используйте пользовательский промпт, чтобы задать, как Agent должен использовать инструменты MCP.

Сохранение и включение

После настройки сохраните агента. Существующих агентов можно включать или отключать на странице сведений.

Участники команды без прав администратора могут просматривать раздел «Маршрутизация и одобрение PR», но не могут его редактировать.