Гайд · TNWS AI

Как выбрать Review effort level для Copilot Code Review

Copilot

13 сентября 2026 6 мин—

Настройка глубины Copilot Code Review в GitHub: Settings → Copilot → Code review, Lite и Balanced, тестовый PR, критерии выбора и контроль затрат.

Задача и применимость

Цель — задать default глубину автоматических Copilot reviews в конкретном репозитории и проверить выбор на репрезентативном PR. Руководство рассчитано на repository administrators, которым нужно согласовать тщательность review с критичностью кода. Успех здесь означает наблюдаемое состояние: сработавший ruleset, корректный scope веток, прочитанная инструкция, использованное окружение или comments в ожидаемой группе изменений. Текст модели без внешней проверки успехом не считается.

Интерфейс, команды, названия файлов и доступность сверены 13 сентября 2026 года по официальной документации GitHub. Цены и универсальные лимиты не приводятся. Любая доступность зависит от плана, policy и прав пользователя; если пункт отсутствует, не имитируйте его альтернативным write-действием.

Подтверждённая механика

Путь настройки: repository Settings → sidebar Copilot → Code review → Review effort level. GitHub описывает Lite как standard review, а Balanced — как более глубокий анализ сложной логики, security-sensitive code и cross-service changes. Balanced использует больше AI credits и может расходовать немного больше GitHub Actions minutes; проверено на указанную дату.

Точные имена важны: Review new pushes отвечает за повторные циклы, Review draft pull requests — за статус PR, а Review effort level — за глубину. Аналогично, .github/copilot-instructions.md, path-specific instructions и AGENTS.md имеют разные scopes.

Что подготовить до настройки

Запишите OWNER/REPO, target branch, текущий status настройки и критерий отката. Создайте test branch, где нет секретов и production-изменений. Для инструкции подготовьте одно безопасное нарушение правила, которое потом удалите; для окружения — workflow, проверяемый вручную через Actions.

До любого сохранения сделайте screenshot или текстовую запись исходного значения. Это особенно важно для ruleset: ошибка target может распространить review на большее число PR, а дублирующее правило создаст шум. Проверяйте не только включённый checkbox, но и scope.

Готовый шаблон

Review effort level: Balanced
Контрольный PR: изменение auth + два сервиса
Критерий: замечания по границам доверия и интеграции

Шаблон — стартовая точка. Замените repository, ветки и инварианты на реальные. Не вставляйте tokens, private URLs и персональные данные. Конфигурационные Markdown/YAML-файлы являются управляющим кодом: их нужно читать в diff и проводить через review.

Пошаговые действия

Выберите репрезентативный репозиторий и зафиксируйте текущий effort level.
Откройте repository Settings.
В sidebar под Code, planning, and automation нажмите Copilot, затем Code review.
Рядом с Review effort level выберите нужное значение. Для обычных изменений используйте Lite; для сложной или security-sensitive интеграции рассмотрите Balanced.
Не обещайте экономию или стоимость в числах без отдельной проверки биллинга. Официально подтверждён только относительный расход.
Создайте test PR с реальным cross-service сценарием и одинаковым описанием рисков.
Оцените полезность комментариев: конкретный сценарий отказа, затронутый trust boundary, тест. Не используйте количество комментариев как метрику качества.
Сохраните выбранный уровень в инженерном регламенте и пересматривайте при изменении профиля репозитория.

После каждого шага фиксируйте независимый признак: ruleset Active, target branch совпадает, workflow зелёный, comment привязан к ожидаемому файлу. Если признак отсутствует, остановитесь до следующего write-действия.

Готовый промпт

Проверь cross-service изменение авторизации. Ищи потерю tenant boundary, повторное использование token и несовместимый rollback. Для каждого риска укажи трассу запроса и тест.

Промпт должен усиливать конфигурацию, а не заменять её. Укажите scope, инварианты и формат доказательства. Просите сценарий отказа и тест, а не абстрактное «улучшить качество». Для draft или частичного diff явно перечисляйте незавершённые части.

Реалистичный пример входа и результата

Вход: PR меняет gateway и auth service, затрагивает передачу tenant ID.

Ожидаемый результат: Balanced review анализирует связь сервисов и security-sensitive логику; команда оценивает точность сценариев, а не просто объём текста.

Проверяйте результат по GitHub UI, timeline, Actions log, session attribution, Reviewed Changes или локальному diff. Количество комментариев не является метрикой качества. Полезное замечание указывает конкретный код, воспроизводимый риск и проверку.

Контрольный эксперимент

Хорошая настройка проверяется двумя примерами. Положительный должен попасть в scope и запустить нужное поведение. Отрицательный — не должен: другая branch, несовпадающий path, unstaged файл или PR без нового push. Такая пара обнаруживает слишком широкий glob и неверный target.

Не создавайте искусственную уязвимость в production-коде. Используйте изолированный test fixture или безопасный логический дефект, который сразу удаляется. Результат эксперимента зафиксируйте в PR description, затем очистите временный код до merge.

Сохраните короткий протокол эксперимента: дата, commit SHA, выбранный scope, ожидаемое и фактическое поведение. Он помогает отличить случайный успешный запуск от воспроизводимой настройки и упрощает повторную проверку после обновления GitHub. Не включайте в протокол содержимое закрытых комментариев, секреты или данные пользователей.

Как оценить качество review

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

После принятой suggestion перечитайте полный diff: локальная кнопка или web suggestion может внести корректный фрагмент, но не проверить соседний код. Запустите обязательные tests, lint и build из репозитория. Copilot review — дополнительный слой, не замена CI и человеческому approval.

Типовые ошибки

Balanced не гарантирует отсутствие дефектов и не заменяет security review.
Сравнение по числу комментариев вводит в заблуждение: важна воспроизводимость.
Изменяемые расходы нужно проверять на дату решения, а не копировать из старого гайда.

Если настройка не сработала, сначала проверяйте scope, branch, head/base, enforcement status и права. Не переключайте сразу несколько флагов: иначе невозможно понять причину. Меняйте одну переменную и повторяйте контрольный experiment.

Безопасность и поддержка

Rulesets и instructions могут влиять на всю команду, поэтому используйте принцип минимального scope. Workflow получает только нужные permissions. В инструкции нельзя включать секреты или предлагать чтение приватных данных. MCP context и внешние tools требуют отдельной оценки доверия.

Раз в квартал или после крупного обновления повторяйте test PR: UI и поведение меняются. В самом документе команды храните дату проверки и ссылку на официальный источник, а не неподтверждённые скриншоты.

Чек-лист финальной проверки

Названия меню, файлов и опций сверены 13 сентября 2026 года.
OWNER/REPO, target branch и scope указаны явно.
Ruleset имеет ожидаемый Enforcement Status.
Положительный test case запустил нужный review.
Отрицательный test case не попал в scope.
В YAML/Markdown нет секретов и внутренних credentials.
Suggestions проверены полным diff и тестами.
Human approvals и branch protection не ослаблены случайно.
Есть понятный способ отката настройки.

FAQ

Какие уровни описаны в документации?

Lite и Balanced на дату проверки.

Чем отличается Balanced?

Более глубоким анализом сложной логики, чувствительного к безопасности кода и cross-service changes.

Где меняется default?

Repository Settings → Copilot → Code review → Review effort level.

Есть ли влияние на расход?

GitHub указывает больше AI credits и возможный небольшой рост Actions minutes, без универсального числа для всех PR.

Официальный первоисточник

GitHub Docs

Источник и изменяемые детали проверены 13 сентября 2026 года. Перед повторением после обновления GitHub или IDE снова откройте ссылку и сравните точные имена пунктов.