Лучшие практики для GitHub Copilot CLI

Введение

GitHub Copilot CLI — это ассистент по программированию ИИ, нативный для терминала, который напрямую переносит агентные возможности в командную строку. Copilot CLI Может работать как чат-бот, отвечая на ваши вопросы, но его настоящая сила заключается в способности работать автономно как ваш партнёр по программированию, позволяя вам делегировать задачи и контролировать их работу.

В этой статье приведены советы по максимальной эффективности Copilot CLI— от эффективного использования различных команд CLI до управления доступом CLI к файлам. Рассматривайте эти советы как отправную точку, а затем экспериментируйте, чтобы понять, что лучше всего подходит для ваших рабочих процессов.

Примечание.

GitHub Copilot CLI постоянно развивается. Используйте /help команду, чтобы видеть самую актуальную информацию.

1. Настройте окружение

Используйте пользовательские инструкции

Copilot CLI автоматически объединяет применимые инструкции на уровне пользователя, репозитория и пути. Используйте инструкции репозитория для соглашений о проектах и инструкций на уровне пользователя для настроек, которые должны применяться в проектах.

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

Лучшие практики

Избегайте конфликтующих инструкций. Например, это простой .github/copilot-instructions.md файл.

## Build Commands
- `npm run build` - Build the project
- `npm run test` - Run all tests
- `npm run lint:fix` - Fix linting issues

## Code Style
- Use TypeScript strict mode
- Prefer functional components over class components
- Always add JSDoc comments for public APIs

## Workflow
- Run `npm run lint:fix && npm test` after making changes
- Commit messages follow conventional commits format
- Create feature branches from `main`

Совет

Держите инструкции краткими и практичными. Длинные инструкции могут снизить эффективность.

Дополнительные сведения см. в разделе Пользовательские инструкции для GitHub Copilot.

Настройка разрешённых инструментов

Управление средствами Copilot , которые могут использоваться без запроса разрешения. В режиме утверждения вручную запросы, которые еще не разрешены, запрашивают утверждение. Они могут включать выполнение команд, редактирование файлов или доступ к URL-адресам. При появлении запроса обычно можно разрешить действие только один раз или разрешить это средство для остальной части сеанса. Используйте /permissions show для проверки режима или /permissions manual выбора утверждения вручную.

Чтобы сбросить ранее одобренные инструменты, используйте следующее:

/reset-allowed-tools

Вы также можете заранее настроить разрешённые инструменты через флаги CLI:

copilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'

Распространённые шаблоны разрешений:

shell(git:*) — Разрешить все команды Git
shell(npm run:*) — Разрешить все npm-скрипты
shell(npm run test:*) — Разрешить команды тестирования npm
write — Разрешить запись файлов

Дополнительные сведения о разрешении и запрете разрешений для определенных средств см. в разделе Разрешение и отказ в использовании инструментов.

Выберите предпочитаемую модель

Используйте /model выбор из доступных моделей в зависимости от сложности вашей задачи:

Модель	Лучше всего для	Компромиссы
Copilot Fusion	Предлагает несколько уровней усилий, чтобы позволить вам определить приоритеты качества, стоимости и возможностей, которые система определяет для каждого запроса.	См. раздел AUTOTITLE
Claude Opus 5	Сложная архитектура, сложность отладки, тонкий рефакторинг	Самый способный, но дороже
Claude Sonnet 5	Ежедневное программирование, большинство рутинных задач	Быстрый, экономичный, хорошо справляется с большинством работ
GPT-5.3-Codex	Генерация кода, обзор кода, простые реализации	Отлично подходит для обзора кода, созданного другими моделями

Recommendations:

Copilot Fusion — это расширенный маршрутизатор модели среды выполнения и оркестратор. Он выбирает модели и шаблоны выполнения для задачи, а затем возвращает один ответ.
Claude Opus 5 идеально подходит для задач, требующих глубокого анализа, сложной системы проектирования, тонкого исследования ошибок или расширенного понимания контекста.
Переключение на Claude Sonnet 5 для повседневных задач, в которых скорость и экономичность имеют значение , она эффективно обрабатывает большинство повседневных кодов.
Использование GPT-5.3-Codex для создания большого объема кода и в качестве второго мнения для просмотра кода, созданного другими моделями.

Вы можете менять модель во время сессии /model по мере изменения сложности задачи.

Если ваша организация или предприятие настроили пользовательские модели, используя собственные API-ключи LLM-провайдера, эти модели также отображаются /model внизу списка.

Используйте своего собственного поставщика моделей

Вы можете настроить Copilot CLI использование собственного провайдера моделей вместо GitHub-hosted моделей. Запустите copilot help providers полные инструкции по настройке.

Основные рекомендации:

Ваша модель должна поддерживать вызов инструментов (вызов функций) и потоковую передачу. Copilot CLI возвращает ошибку, если отсутствует одна из возможностей.
Для наилучших результатов используйте модель с контекстным окном не менее 128 тысяч токенов.
Встроенные субагенты (/review, /task, explore, /fleet) автоматически наследуют конфигурацию вашего провайдера.
Оценки стоимости скрыты при использовании собственного провайдера. Использование токенов (вход, вывод и количество кэша) всё ещё отображается.
/delegate Работает только если вы также вошли в GitHub. Он переносит сессию на GitHubсерверную Copilotсторону, а не на провайдера.

См. Использование собственного поставщика модели.

Установите AI credit лимиты сессий

Можно ограничить AI creditsCopilot расходы на одну сессию, чтобы долгие или сложные задачи не потребляли больше ресурсов, чем вы ожидаете. См . раздел AUTOTITLE.

Для получения дополнительной информации о том, как оптимизировать использование AI credits в целом, смотрите Оптимизация использования ИИ для максимизации эффективности и снижения затрат.

2. Планируй, прежде чем кодировать

Режим планирования

Модели достигают более высоких показателей успеха, если им предоставляется конкретный план. В режиме планирования Copilot будет создан структурированный план реализации до написания кода.

Нажмите вкладку Shift+, чтобы переключиться между нормальным режимом и режимом планирования. В режиме плана все вводные подсказки запускают рабочий процесс плана.

В качестве альтернативы можно использовать /plan команду в обычном режиме, чтобы добиться того же эффекта.

Пример запроса (из обычного режима):

/plan Add OAuth2 authentication with Google and GitHub providers

Что происходит:

Copilot Анализирует ваш запрос и кодовую базу.
Задаёт уточняющие вопросы , чтобы согласовать требования и подход.
Создает структурированный план реализации с галочками.
Сохраняет план в plan.md папке сессии.
Ждёт вашего одобрения , прежде чем внедрять.

Вы можете нажать Ctrl+y , чтобы просмотреть и отредактировать план в вашем стандартном редакторе файлов Markdown.

Пример вывода плана:

# Implementation Plan: OAuth2 Authentication

## Overview
Add social authentication using OAuth2 with Google and GitHub providers.

## Tasks
- [ ] Install dependencies (passport, passport-google-oauth20, passport-github2)
- [ ] Create authentication routes in `/api/auth`
- [ ] Implement passport strategies for each provider
- [ ] Add session management middleware
- [ ] Create login/logout UI components
- [ ] Add environment variables for OAuth credentials
- [ ] Write integration tests

## Detailed Steps
1. **Dependencies**: Add to package.json...
2. **Routes**: Create `/api/auth/google` and `/api/auth/github`...

Когда использовать режим плана

Scenario	Использовать режим плана?
Сложные многофайловые изменения
Рефакторинг с множеством точек соприкосновения
Новая реализация функций
Быстрые исправления ошибок
Изменения в одиночном порядке

План исследовать → → код → коммит

Для наилучших результатов при сложных задачах:

Исследуйте:

Read the authentication files but don't write code yet
План:

/plan Implement password reset flow
Проверка.

Проверьте план, предложите модификации
Реализация:

Proceed with the plan
Проверьте:

Run the tests and fix any failures
Коммит:

Commit these changes with a descriptive message

3. Используйте бесконечные сессии

Автоматическое управление контекстным окном

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

Место хранения сессий:

~/.copilot/session-state/{session-id}/
├── events.jsonl      # Full session history
├── workspace.yaml    # Metadata
├── plan.md           # Implementation plan (if created)
├── checkpoints/      # Compaction history
└── files/            # Persistent artifacts

Примечание.

Если когда-нибудь нужно вручную активировать уплотнение, используйте /compact. Это редко необходимо, так как система обрабатывает это автоматически.

Команды управления сессиями

Чтобы ознакомиться с информацией о текущей сессии CLI, введите:

/session

Чтобы просмотреть список любых контрольных точек сессий, введите:

/session checkpoints

Примечание.

Контрольная точка создаётся при сжатии контекста сессии и позволяет просматривать сводный контекст.Copilot

Чтобы увидеть детали конкретного контрольного пункта, введите:

/session checkpoints NUMBER

где NUMBER указывает контрольную точку, которую вы хотите отобразить.

Чтобы просмотреть любые временные файлы, созданные во время текущей сессии — например, артефакты, созданные Copilot ими, которые не должны сохраняться в репозитории — введите:

/session files

Чтобы увидеть текущий план (если Copilot он был сгенерирован), введите:

/session plan

Лучшая практика: Сосредоточьтесь на сессиях

В то время как бесконечные сессии позволяют работать длительно, сфокусированные занятия дают лучшие результаты:

Используйте /clear или /new между другими задачами.
Это сбрасывает контекст и улучшает качество отклика.
Представьте это как начало нового разговора с коллегой.

Команда `/context`

Визуализируйте текущее использование контекста с помощью /context. На ней показана разбивка:

Системные/инструментальные токены
Токены истории сообщений
Свободное место
Распределение буферов

4. Эффективно делегировать работу

Команда `/delegate`

Перегрузите работу для запуска в облаке с помощью Copilot cloud agent. Это особенно мощно для:

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

Пример запроса:

/delegate Add dark mode support to the settings page

Что происходит:

Ваш запрос отправляется по адресу Copilot cloud agent.
Агент создаёт pull request с этими изменениями.
Вы можете продолжать работать локально, пока облачный агент работает.

Когда следует использовать `/delegate`

Используйте `/delegate`	Локальная работа
Косвенные задачи	Основные полнометражные работы
обновление документации.	Отладка
Рефакторинг отдельных модулей	Интерактивное исследование

5. Общие рабочие процессы

Кодовая адаптация

Используйте Copilot CLI их в качестве партнёра по программированию при вступлении в новый проект. Например, вы можете спросить Copilot:

How is logging configured in this project?
What's the pattern for adding a new API endpoint?
Explain the authentication flow
Where are the database migrations?

Разработка на основе тестов

Объединяйте их Copilot CLI для разработки тестов.

Write failing tests for the user registration flow
Проверьте и одобрите тесты.
Now implement code to make all tests pass
Ознакомьтесь с реализацией.
Commit with message "feat: add user registration"

Помощь при повторении кода

/security-review Review my current local changes for security issues. Prioritize high-severity findings and suggest remediations I can apply before opening a pull request.
/review Use Claude Opus 5 and GPT-5.3-Codex to review the changes in my current branch against `main`. Focus on potential bugs and security issues.
Сначала проверите исправления, а затем продолжайте работу с обычным рабочим процессом проверки запроса на вытягивание.

Операции Git

Copilot Отлично справляется с рабочими процессами в Git:

What changes went into version `2.3.0`?
Create a PR for this branch with a detailed description
Rebase this branch against `main`
Resolve the merge conflicts in `package.json`

Расследование ошибок

The `/api/users` endpoint returns 500 errors intermittently. Search the codebase and logs to identify the root cause.

Рефакторинг

/plan Migrate all class components to functional components with hooks

Затем отвечайте на вопросы Copilot . Пересмотрите составленный им план и попросите Copilot внести изменения, если потребуется. Когда план вас устраивает, вы можете предложить: Implement this plan

6. Продвинутые паттерны

Работа в нескольких репозиториях

** Copilot CLI обеспечивает гибкие рабочие процессы с мультирепозиториями** — ключевое отличие для команд, работающих над микросервисами, монорепозиториями или смежными проектами.

Вариант 1: Запуск из родительского каталога

# Navigate to a parent directory containing multiple repos
cd ~/projects
copilot

Copilot теперь можно одновременно получать доступ и работать со всеми детскими репозиториями. Это идеально подходит для:

Архитектуры микрослужб
Скоординированные изменения в связанных репозиториях
Рефакторинг общих шаблонов между проектами

Вариант 2: использовать /add-dir для расширения доступа

# Start in one repo, then add others (requires full paths)
copilot
/add-dir /Users/me/projects/backend-service
/add-dir /Users/me/projects/shared-libs
/add-dir /Users/me/projects/documentation

Просмотр и управление разрешёнными каталогами:

/list-dirs

Пример рабочего процесса: согласованные изменения API

I need to update the user authentication API. The changes span:

- @/Users/me/projects/api-gateway (routing changes)
- @/Users/me/projects/auth-service (core logic)
- @/Users/me/projects/frontend (client updates)

Start by showing me the current auth flow across all three repos.

Эта мультирепозиторная возможность позволяет:

Пересечение рефакторов (обновление общего паттерна везде)
Изменения в контрактах API с обновлениями клиента
Документация, ссылающаяся на несколько кодовых баз
Улучшения зависимости через монорепо

Использование изображений для работы с интерфейсом

Copilot Может работать с визуальными отсылками. Просто перетаскивайте изображения прямо на вход CLI, вставляйте изображение из буфера обмена с помощью Ctrl+V или используйте файлы изображений в вашем запросе:

Implement this design: @mockup.png
Match the layout and spacing exactly

Контрольные списки для сложных миграций

Для крупномасштабных изменений:

Run the linter and write all errors to `migration-checklist.md` as a checklist.
Then fix each issue one by one, checking them off as you go.

Завершение автономной задачи

Переключитесь в режим автопилота, чтобы Copilot можно было автономно выполнять задачу до её завершения. Это идеально подходит для долгосрочных задач, не требующих постоянного контроля. Дополнительные сведения см. в разделе Использование режима Autopilot в интерфейсе командной строки GitHub Copilot.

Опционально, обычно можно ускорить крупные задачи, используя /fleet команду slash в начале вашей подсказки, чтобы Copilot разбить задачу на параллельные подзадачи, выполняемые субагентами. Дополнительные сведения см. в разделе Ускорение выполнения задачи с /fleet помощью команды.

7. Правила команды

Вопросы безопасности

Перед началом работы просмотрите режим разрешений и разрешения инструментов. Автоматическое утверждение может разрешить потенциально разрушительные операции без отдельных запросов.
Изучите все предлагаемые изменения перед принятием.
Используйте списки разрешений разумно.
Никогда не скрывай секреты. Copilot разработана так, чтобы избежать этого, но всегда проверяйте.