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

Узнайте, как максимально использовать GitHub Copilot CLI.

В этой статье

Введение

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

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

Примечание.

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

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

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

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

Поддерживаемые локации (в порядке обнаружения):

МестоположениеScope
~/.copilot/copilot-instructions.mdВсе сессии (глобальные)
.github/copilot-instructions.mdРепозиторий
.github/instructions/**/*.instructions.mdРепозиторий (модульный)
(в корне Git или cwd)Репозиторий
, ,Репозиторий

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

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

## 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`

Совет

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

Дополнительные сведения см. в разделе AUTOTITLE.

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

Управляйте, какие инструменты Copilot могут запускаться без разрешения. Когда Copilot запрашивает разрешение на действие, вы можете выбрать Разрешить один раз или Всегда разрешить добавить инструмент в список разрешений для этой и будущих сессий.

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

/reset-allowed-tools

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

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

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

  • — Разрешить все команды Git
  • — Разрешить все npm-скрипты
  • — Разрешить команды тестирования npm
  • — Разрешить запись файлов

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

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

МодельЛучше всего дляКомпромиссы
Claude Opus 4.5 (по умолчанию)Сложная архитектура, сложность отладки, тонкий рефакторингБольшинство способных, но используют больше премиум-запросов
Клод Соннет 4.5Ежедневное программирование, большинство рутинных задачБыстрый, экономичный, хорошо справляется с большинством работ
Кодекс GPT-5.2Генерация кода, обзор кода, простые реализацииОтлично подходит для обзора кода, созданного другими моделями

Recommendations:

  • Opus 4.5 идеально подходит для задач, требующих глубокого мышления, сложного проектирования системы, тонкого расследования ошибок или глубокого понимания контекста.
  • Переходите на Sonnet 4.5 для рутинных задач, где важна скорость и экономия — он эффективно справляется с основной частью повседневного кодирования.
  • Используйте Codex для генерации кода с большим объёмом и как второе мнение при обзоре кода, созданного другими моделями.

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

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

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

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

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

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

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

/plan Add OAuth2 authentication with Google and GitHub providers

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

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

Вы можете нажать Ctrly , чтобы просмотреть и отредактировать план в вашем стандартном редакторе файлов 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 содержит бесконечные сессии. Не стоит переживать, что у тебя закончится контекст. Система автоматически управляет контекстом с помощью интеллектуального уплотнения, который резюмирует историю разговора, сохраняя при этом важную информацию.

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

~/.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

Примечание.

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

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

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

/session

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

/session checkpoints

Примечание.

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

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

/session checkpoints NUMBER

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

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

/session files

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

/session plan

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

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

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

Команда

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

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

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

Команда

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

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

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

/delegate Add dark mode support to the settings page

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

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

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

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

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

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

Используйте Интерфейс командной строки Copilot в качестве партнёра по программированию пары при вступлении в новый проект. Например, вы можете спросить 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 для разработки тестов.

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

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

  • /review Use Opus 4.5 and Codex 5.2 to review the changes in my current branch against `main`. Focus on potential bugs and security issues.

Операции Git

Copilot excels at Git workflows:

  • 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. Прочитайте созданный им план и попросите обеспечивает гибкие рабочие процессы с мультирепозиториями — ключевое отличие для команд, работающих над микросервисами, монорепозиториями или смежными проектами.

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

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

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

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

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

# 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 или используйте ссылки на файлы изображений:

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 могли работать автономно над задачей до её завершения. Это идеально подходит для долгосрочных задач, не требующих постоянного контроля. Дополнительные сведения см. в разделе AUTOTITLE.

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

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

  • Создайте с:

    • Команды сборки и тестирования
    • Рекомендации по стилю кода
    • Обязательные проверки перед коммитами
    • Архитектурные решения

  • Устанавливать конвенции для:

    • Когда использовать (сложные признаки, рефакторинг)
    • Когда использовать (косвенная работа)
    • Процессы проверки кода с помощью ИИ

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

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

Измерение производительности

Метрики отслеживания, такие как:

  • Время от выпуска до запроса
  • Количество итераций до слияния
  • Циклы обратной связи при проверке кода
  • Улучшение покрытия испытаний

Получение помощи

Из командной строки вы можете показать помощь, используя команду: .

Для помощи по различным вопросам заходите:

copilot help TOPIC

где может быть один из: , , , , или .

Внутри CLI

Для помощи внутри CLI запросите:

/help

Чтобы просмотреть статистику использования, введите:

/usage

Чтобы отправить приватную обратную связь на GitHub о Интерфейс командной строки Copilot, вызвать отчёт об ошибке или отправить запрос на функцию, введите:

/feedback

Отработка практических навыков

Попробуйте упражнение Creating applications with Интерфейс командной строки Copilot Skills для практического опыта создания приложения с помощью Интерфейс командной строки Copilot.

Вот что вы узнаете:

  • Install Интерфейс командной строки Copilot
  • Используйте шаблон проблемы, чтобы создать проблему
  • Создайте калькулятор Node.js CLI
  • Функциональность калькулятора расширения
  • Пишите модульные тесты для функций калькулятора
  • Создайте, просматривайте и объединяйте ваш pull-запрос

Дополнительные материалы

  • AUTOTITLE
  • AUTOTITLE
  • AUTOTITLE
  • Copilot планы и цены