GitHub Copilot custom instructions: расположение и чтение инструментами

GitHub Copilot читает один файл для всего репозитория — .github/copilot-instructions.md, а также файлы .instructions.md для отдельных путей. Он также учитывает AGENTS.md либо один файл CLAUDE.md или GEMINI.md в корне.

Расположение

• .github/copilot-instructions.md — применяется ко всему репозиторию.
• .github/instructions/**/NAME.instructions.md — применяется к файлам, соответствующим applyTo.
• AGENTS.md в любой части репозитория; применяется ближайший файл.
• Один файл CLAUDE.md или GEMINI.md в корне — альтернативный вариант.

Формат

Markdown; пробелы между инструкциями игнорируются. Frontmatter поддерживается только в файлах .instructions.md: в applyTo указываются glob-шаблоны через запятую, а excludeAgent принимает значения "code-review" или "cloud-agent". 2026-06-12 для проверки кода сняли ограничение в 4,000 символов; GitHub рекомендует не превышать примерно 1,000 строк на файл.

Ключи frontmatter: applyToexcludeAgent

# Copilot instructions

This is a Rails app with a React front end in app/javascript/.

## Build and test

- Install: `bundle install && yarn install`
- Test: `bin/rails test`
- Lint: `bin/rubocop`

## Conventions

- Put business logic in app/services/, not in controllers.
- Every migration must be reversible.
- Never commit credentials or edit config/master.key.

Приоритет и объединение

Сначала идут личные инструкции, затем инструкции репозитория и организации; все подходящие наборы передаются Copilot. Если совпадают файл для отдельного пути и файл для всего репозитория, Copilot использует оба. При проверке кода читаются инструкции из head-ветки pull request.

Советы

• На github.com файлы .instructions.md для отдельных путей работают только с Copilot cloud agent и Copilot code review.
• Добавьте excludeAgent: "code-review", чтобы исключить файл из проверки кода, сохранив его доступность для cloud agent.
• Copilot cloud agent может подготовить для вас файл copilot-instructions.md; ограничьте его примерно двумя страницами и не привязывайте к одной задаче.

Другие файлы с инструкциями