Гайд · TNWS AI
Как задать Review effort level для организации GitHub
Настройка Lite или Balanced для Copilot Code Review в организации: критерии выбора, пилот и проверка результата.
Задача и применимость
Этот гайд решает конкретную задачу: выбрать единый уровень усилий Copilot Code Review для организации и проверить его на репрезентативных pull request. Он подходит владельцам организации, которым важно согласовать глубину автоматического review с типом изменений и внутренней политикой ресурсов. Итогом должна стать не просто включённая опция, а воспроизводимая настройка с тестовым pull request, наблюдаемым результатом и понятным откатом.
Важно отделять три слоя. Copilot Code Review анализирует изменения и формирует замечания или решение review. Ruleset и branch protection определяют, что блокирует merge. Люди, тесты и владельцы компонентов отвечают за принятие риска. Изменение одного слоя не отменяет остальные. Поэтому ниже предусмотрены позитивный и негативный тесты, а ожидаемый результат описан через видимые элементы интерфейса, без выдуманных процентов точности.
Что подтверждено в официальной документации
Проверено 13 сентября 2026 года. В Organization Settings → Copilot → Code review настройка Review effort level предлагает Lite и Balanced. Официальная документация описывает Balanced как более глубокий анализ сложных, security-sensitive и cross-service изменений; он использует больше AI credits и может немного увеличить GitHub Actions minutes.
Основные первоисточники: использование Copilot Code Review, настройка Copilot Code Review и MCP для Copilot в репозитории. Для этого материала использованы только названия функций и поведение, прямо описанные GitHub. Тарифы и цены не приводятся: они не нужны для выполнения процедуры и могут меняться.
Перед началом убедитесь, что у вас есть административные права для нужного уровня — репозитория или организации. Сделайте снимок текущей конфигурации: запишите значение переключателей, имя ruleset, его targets и обязательные checks. Такой baseline позволяет отличить эффект новой настройки от уже существующей политики и быстро вернуть рабочее состояние.
Пошаговая настройка
- Соберите три безопасных PR для пилота: локальное изменение, изменение границы сервиса и security-sensitive тестовый сценарий.
- Откройте аватар GitHub → Organizations → нужная организация → Settings.
- В боковой панели выберите Copilot, затем Code review.
- Найдите Review effort level и зафиксируйте исходное значение.
- Выберите Lite для более лёгкого общего анализа либо Balanced для более глубокого анализа сложных изменений. Не обещайте конкретное количество комментариев.
- Запросите Copilot review на одинаково подготовленной серии PR и сохраняйте только проверяемые наблюдения: завершение review, найденные категории проблем, атрибуции и расход, доступный в интерфейсе вашей организации.
- Оцените полезность вместе с владельцами сервисов. Количество комментариев само по себе не является качеством.
- Закрепите решение, дату проверки и условие пересмотра; при неподходящем результате верните исходный уровень.
После сохранения не переходите сразу к массовому включению. Откройте страницу ruleset или Code review повторно и убедитесь, что значение сохранилось. Затем проверяйте поведение на отдельной ветке и безопасном PR. В описании PR укажите цель теста, ожидаемый эффект и человека, который подтвердит результат. Это превращает разовую настройку в проверяемую процедуру.
Готовый шаблон для копирования
Скопируйте карточку в issue, change request или описание тестового PR и заполните угловые скобки. Она одновременно служит планом работы и журналом проверки.
Пилот Review effort level
Текущее значение: <Lite/Balanced>
Тестовые PR: <3 URL>
Категории: локальный / cross-service / security-sensitive
Фиксируем: завершение review, релевантность замечаний, пропуски, доступный usage
Не используем как метрику: сырое число комментариев
Решение: <уровень>
Основание: <проверенные наблюдения>
Дата пересмотра: <дата>
Дата проверки продукта: 13.09.2026
Ссылка на официальную документацию: https://docs.github.com/en/copilot/how-tos/copilot-on-github/set-up-copilot/configure-code-review
Если команда использует внутреннего ассистента для подготовки change request, можно дать ему следующий промпт. Он не просит модель менять настройки и поэтому оставляет действие администратору:
Подготовь план изменения GitHub Copilot Code Review по карточке ниже.
Не придумывай текущие значения, права, тарифы или результат проверки.
Раздели ответ на: предпосылки, точный путь в интерфейсе, позитивный тест,
негативный тест, наблюдаемые критерии успеха, риски и откат.
Если в карточке нет факта, пометь его как «нужно проверить».
<вставьте заполненную карточку>
Реалистичный пример входа и результата
Вход. Один PR меняет текст ошибки, второй — контракт API между billing и orders, третий — проверку авторизации. Команда тестирует Balanced после исходного Lite.
Ожидаемый результат. Настройка применяется на уровне организации. Команда получает сравнимые review для трёх классов изменений и принимает решение по релевантности, не приписывая режиму неподтверждённые проценты точности.
Результат считается подтверждённым только по интерфейсу GitHub и, где применимо, по timeline, merge box, атрибуциям или session log. Фраза модели, предположение администратора или отсутствие комментариев не являются достаточным доказательством. Сохраните URL тестового PR и краткую запись того, что наблюдалось до и после изменения.
Как провести позитивный и негативный тест
Позитивный тест должен попадать точно в разрешённую область: выбранный репозиторий, целевая ветка, подходящие пути и завершённые обязательные checks. До запуска запишите ожидаемое событие — например, автоматическое назначение Copilot, появление approval, видимый комментарий или MCP tool call.
Негативный тест меняет ровно одно условие. Это может быть исключённый репозиторий, файл вне glob, отсутствующий внешний идентификатор или выключенный переключатель. Если одновременно изменить несколько условий, невозможно понять причину результата. Для обоих тестов используйте безопасные изменения, которые можно закрыть без merge.
После теста сравните наблюдения с карточкой. Если результат неоднозначен, не расширяйте охват. Верните исходную конфигурацию, проверьте права, порядок rulesets, target branches и состояние PR, затем повторите тест с одним контролируемым изменением.
Типичные ошибки
- Выбирать режим по числу комментариев.
- Утверждать фиксированный расход без данных организации.
- Менять уровень без сохранения исходного состояния.
- Тестировать только простой PR и экстраполировать на весь портфель.
Есть и общая ошибка: путать «Copilot завершил review» с «изменение можно сливать». Автоматический review — дополнительный сигнал. Обязательные тесты, секрет-сканирование, review владельца кода и внутренние процедуры сохраняют силу. Если Copilot предлагает исправление, просмотрите diff, запустите тесты и только потом принимайте изменение.
Чек-лист финальной проверки
- Открыт правильный owner, repository или organization.
- Исходная конфигурация сохранена для отката.
- Названия пунктов интерфейса сверены с документацией на 13.09.2026.
- Настройка сохранена и повторно открыта для проверки.
- Позитивный тест выполнен на безопасном pull request.
- Негативный тест меняет только одно условие.
- Проверены реальные ruleset, target branches, required reviews и checks.
- Автоматический результат сверён с diff и тестами человеком.
- Ссылки на тестовый PR и наблюдения записаны.
- План отката понятен ответственному администратору.
FAQ
Какой режим глубже?
GitHub описывает Balanced как более глубокий для сложных, security-sensitive и cross-service изменений.
Можно ли обещать конкретное улучшение качества?
Нет. Официальная документация не даёт универсальной метрики для вашего кода; нужен собственный пилот.
Влияет ли Balanced на расход?
Документация говорит о большем использовании AI credits и возможном небольшом росте Actions minutes; проверяйте фактические данные своей организации.
Когда пересматривать выбор?
После изменения типов репозиториев, политики риска или доступного бюджета, а также при заметном изменении продукта.
Итог
Настройка готова к эксплуатации, когда команда может повторить её по карточке, показать подтверждение в GitHub и объяснить, какое условие должно сработать в позитивном и негативном сценариях. Если подтверждения нет, оставьте пилот ограниченным и не меняйте требования merge для остальных репозиториев. Перед следующим массовым изменением снова откройте официальные источники: возможности Copilot и элементы интерфейса изменяются со временем.
Читайте также
Как разрешить Copilot автоматически одобрять pull request
Практическая настройка Allow Copilot to approve pull requests: включение, безопасный пилот, проверка решения и откат.
Как включить Copilot Code Review для репозиториев организации
Организационный branch ruleset для автоматического Copilot Code Review: охват репозиториев, ветвей, включение и проверка.
Как ограничить Copilot approvals путями файлов
Настройка File paths для Copilot approvals: glob-шаблоны, позитивные и негативные тесты, ожидаемое поведение и откат.
Комментарии
Пока тихо. Скажите первое слово