Как создать copilot-instructions.md командой copilot init

Проверено 13 сентября 2026 года. Команда copilot init и интерактивная команда /init анализируют кодовую базу и создают либо обновляют .github/copilot-instructions.md. Обычно файл описывает команды build/test/lint, архитектуру и соглашения проекта. Если файл уже существует, CLI предлагает улучшения, которые можно принять или отклонить.

Первоисточник — GitHub Copilot CLI command reference. Для MCP-сценария дополнительно используйте официальную настройку MCP servers. Цены, квоты и список доступных моделей здесь не приводятся: они не нужны для процедуры и могут меняться. Названия команд и параметров взяты из текущей официальной справки.

У CLI есть три разных уровня результата: команда может быть синтаксически принята, фактически выполнена и дать ожидаемый эффект. Проверяйте все три. Нулевой exit code без проверки файла или интерфейса недостаточен; красивый текст ответа при ненулевом exit code тоже нельзя считать успехом.

Перед тестом запишите точную гипотезу в одном предложении: «после команды появится такой-то файл, источник, запрет или набор подсказок». Затем определите независимый способ проверки, который не опирается на объяснение самого ассистента. Для файла это просмотр содержимого и diff, для разрешения — намеренно безопасная попытка запрещённого действия, для списка — сравнение структурированного вывода. Такой подход помогает обнаружить ситуацию, когда команда отработала, но не в том каталоге, не для того пользователя или не в той конфигурации.

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

Для первого запуска используйте тестовый репозиторий, временный каталог или read-only задачу. Сохраните baseline: существующие файлы конфигурации, список источников, текущий completion или разрешения. Если команда пишет файл, заранее определите точный путь и сделайте резервную копию только этого файла. Если команда предоставляет доступ, перечислите разрешённые и контрольные запрещённые объекты.

Не используйте глобальные разрешения ради удобства, когда задачу решает точный флаг. В CI разделяйте stdout, stderr и exit code. В интерактивной сессии читайте запросы разрешений и не подтверждайте действие только потому, что его предложил Copilot. Любой сгенерированный код или конфигурацию просматривайте как обычный внешний patch.

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

1. Перейдите в корень нужного Git-репозитория и выполните git status --short, чтобы не смешать результат и чужие изменения.
2. Запустите copilot init. В интерактивной сессии эквивалентная команда — /init.
3. Просмотрите предлагаемый diff .github/copilot-instructions.md; не принимайте команды сборки, которых нет в проекте.
4. Сверьте каждую команду с package.json, Makefile, CI workflow или документацией репозитория.
5. Удалите секреты, локальные пути и указания, позволяющие публикацию либо деплой без подтверждения.
6. Запустите указанные build, test и lint команды вручную в безопасной ветке.
7. Сохраните файл в отдельном commit и откройте PR, чтобы владельцы компонентов проверили архитектурные утверждения.
8. Начните новую CLI-сессию и дайте небольшую задачу, проверяя, соблюдены ли правила файла.

После выполнения повторите диагностическую команду или откройте новую shell/CLI-сессию, если эффект должен пережить перезапуск. Сравните результат с baseline. Если изменилось больше файлов или источников, чем ожидалось, остановитесь, сохраните diff и выполните откат до продолжения.

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

Заполните эту карточку перед изменением. Её можно вставить в issue или change request:

Цель: подготовить .github/copilot-instructions.md
Репозиторий: OWNER/REPO
Проверенные команды:
- build: <команда>
- test: <команда>
- lint: <команда>
Архитектурные границы: <модули>
Запрещённые действия: deploy, push, изменение секретов без подтверждения
Ревьюеры файла: <команда>
Дата проверки документации: 13.09.2026
Официальный источник: https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference

Для подготовки проверки можно скопировать prompt ниже. Он не разрешает ассистенту придумывать состояние окружения:

Составь план безопасной проверки команды GitHub Copilot CLI по карточке ниже.
Не выполняй запись, сетевую публикацию и изменение прав.
Не придумывай версию, файлы, exit code или успешный результат.
Верни: предпосылки, точную команду, позитивный тест, негативный тест,
наблюдаемые критерии успеха, откат и данные, которые нельзя логировать.

<вставьте заполненную карточку>

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

Входные условия. В Node.js-монорепозитории реально существуют npm run lint, npm test и workspace apps/api; команда запускается из корня.

Ожидаемый результат. CLI предлагает .github/copilot-instructions.md с фактическими командами и обзором структуры. Разработчик исправляет неточности, тестирует команды и отправляет отдельный PR; будущая сессия использует проверенные инструкции.

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