Гайд · TNWS AI

Как запросить Copilot Code Review при создании PR через gh CLI

Copilot

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

Создание pull request с GitHub Copilot reviewer через gh pr create --reviewer @copilot: подготовка ветки, шаблон PR, проверка reviewer и работа с комментариями.

Конкретная задача и применимость

Этот гайд помогает создать pull request из терминала и сразу назначить Copilot reviewer одной проверяемой командой. Он подходит для команд с GitHub CLI, которые хотят включить машинный review в стандартный PR workflow без ручного выбора в браузере. Результатом считается не сообщение модели об успехе, а состояние, которое можно проверить независимо: активный login, список reviewer, комментарий в IDE, URL pull request или отсутствие изменений в рабочем дереве.

Названия команд, меню, приоритеты credentials и доступность функций проверены 13 сентября 2026 года по официальной документации GitHub. Цены, квоты и номера версий здесь не приводятся: для сценария они не нужны, быстро меняются и должны проверяться отдельно. Организационная политика может отключать функцию даже при корректной локальной настройке.

Что подтверждено официально

Официальная команда для нового PR — gh pr create --reviewer @copilot. GitHub также позволяет выбрать Copilot в интерактивном searchable reviewer prompt. Формулировка важна: похожая команда или кнопка может запускать другой workflow. Если ваш интерфейс отличается, не угадывайте — откройте первоисточник в конце статьи и найдите актуальный раздел.

Подготовка безопасной проверки

Перед началом зафиксируйте ожидаемый аккаунт, hostname, repository и допустимый тип действия. Для локального review очистите рабочую область от несвязанных правок. Для GitHub CLI сначала проверьте gh auth status, текущий remote и номер pull request. Для авторизации не выводите tokens и одноразовые коды в общий log.

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

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

Скопируйте заготовку и замените только понятные placeholders:

gh pr create --reviewer @copilot --title "fix: idempotent webhook" --body-file pr-body.md

Не помещайте в шаблон настоящее значение token, cookie, device code или внутренний URL. Для CI подставляйте secret из защищённого store на уровне process environment. Для pull request храните body в отдельном Markdown-файле, чтобы до внешнего действия проверить diff и содержание.

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

Выполните git status и убедитесь, что нужные commits отправлены в отдельную branch. Copilot review анализирует PR, а не незакоммиченные локальные файлы.
Подготовьте pr-body.md: цель, границы, риск, тесты, откат. Не включайте secrets и внутренние токены.
Проверьте gh auth status и текущий repository через gh repo view. Ошибка owner/repo создаст PR не там, где ожидается.
Запустите команду из шаблона, заменив title. Ключевой аргумент — --reviewer @copilot.
Откройте URL, который вернул gh, и проверьте title, base/head branch и наличие Copilot в Reviewers.
Дождитесь review. Проверяйте каждый комментарий по diff и тестам; severity не заменяет доказательство.
После исправлений push выполните повторный review через интерфейс или настройку Review new pushes; исходная create-команда не гарантирует re-review каждого push.

На каждом шаге задавайте вопрос: что изменилось и где это видно? Успешный exit code полезен, но недостаточен. Внешнее состояние подтверждают страница GitHub и reviewer list; локальное — /user, comments panel, IDE diff, git status и тесты.

Готовый промпт для копирования

Цель: исключить двойную обработку webhook. Границы: handler и idempotency storage. Риск: гонка двух доставок. Проверки: unit duplicate, integration parallel. Публичный API не меняется.

Хороший prompt содержит объект, границы и критерий остановки. Запрет на запись не заменяет системные permissions, зато делает неожиданное write-действие заметным. Для review добавляйте инварианты и негативные сценарии: общая просьба «проверь код» даёт менее проверяемый результат.

Реалистичный пример

Вход: Branch fix/webhook-idempotency опубликована, файл pr-body.md содержит риски и тесты.

Ожидаемый результат: gh pr create возвращает один URL, PR содержит Copilot в Reviewers, а review comments привязаны к опубликованному diff.

После ответа не соглашайтесь автоматически. Сопоставьте login и hostname, откройте URL, прочитайте аргументы команды или воспроизведите сценарий тестом. Если результат невозможно проверить без доверия к тексту Copilot, процедура ещё не завершена.

Как проверить результат без модели

Для CLI-аутентификации используйте /user, повторный запуск процесса и отсутствие неожиданных environment overrides. Для GitHub CLI откройте pull request через gh pr view --web и посмотрите Reviewers. Для IDE-review перечитайте изменённые строки, Comments/Problems и итоговый diff.

Проверяйте также отрицательный результат. После logout защищённая операция должна требовать вход. После отказа от suggestion файл не должен измениться. После назначения одного reviewer остальные поля PR должны остаться прежними. Отрицательная проверка ловит частичные и ложноположительные успехи.

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

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

Команда из default branch без опубликованных commits не создаст осмысленный PR.
@copilot должен передаваться как reviewer именно аргументу --reviewer.
Нельзя считать назначение reviewer доказательством завершённого review: откройте PR и дождитесь комментариев.

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

Безопасность и эксплуатация в команде

Используйте минимальную область доступа. OAuth выдавайте нужному аккаунту и нужным организациям; PAT ограничивайте repository access и сроком; reviewers назначайте только правильному PR. Не передавайте credentials аргументом командной строки: они могут попасть в history и список процессов.

Сохраняйте процесс, а не секрет. В командной документации полезны точные команды, ожидаемые признаки успеха и процедура отзыва. Значения tokens, одноразовые коды и персональные данные должны оставаться в secret store или интерактивном защищённом flow.

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

Использованы точные команды и пункты меню из официального источника, проверенного 13 сентября 2026 года.
Подтверждены правильные login, hostname, OWNER/REPO и номер PR.
В prompt, shell history, Markdown и логах нет token или device code.
Выполнена ровно одна целевая операция без повторов и дублей.
Результат проверен через /user, GitHub UI, IDE comments или git diff.
Все принятые code suggestions перепроверены тестами.
Неожиданные env credentials исключены или документированы.
Для logout/инцидента проверены также server-side revoke и отдельные PAT.

FAQ

Какая минимальная команда?

gh pr create --reviewer @copilot. Остальные поля можно заполнить интерактивно.

Можно ли выбрать Copilot в prompt?

Да, официальный gh workflow показывает searchable reviewer prompt с Copilot.

Повторится ли review после push?

Не автоматически по факту create. Для этого нужен re-request или настройка Review new pushes.

Заменяет ли Copilot человека?

Нет. Комментарии нужно проверять, а правила approval и branch protection остаются отдельными.

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

GitHub Docs: официальная инструкция

Источник и изменяемые детали проверены 13 сентября 2026 года. Перед повторением после обновления Copilot CLI, GitHub CLI, VS Code или JetBrains IDE снова откройте документацию и сравните точные имена команд и элементов интерфейса.