{"meta":{"title":"Добавление пользовательских инструкций для GitHub Copilot CLI","intro":"Дайте Copilot дополнительный контекст о том, как понять ваш проект и как строить, протестировать и проверять его изменения.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/ru/enterprise-cloud@latest/copilot/how-tos","title":"Инструкции"},{"href":"/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot","title":"Настройка Copilot CLI"},{"href":"/ru/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions","title":"Добавить пользовательские инструкции"}],"documentType":"article"},"body":"# Добавление пользовательских инструкций для GitHub Copilot CLI\n\nДайте Copilot дополнительный контекст о том, как понять ваш проект и как строить, протестировать и проверять его изменения.\n\nGitHub Copilot может дать ответы, адаптированные к вашим личным предпочтениям, работе вашей команды, используемым инструментам или особенностям вашего проекта, если вы предоставите достаточно контекста для этого. Вместо того, чтобы постоянно добавлять эту контекстную информацию в свои запросы, вы можете создать пользовательские инструкции, которые автоматически добавят эту информацию за вас. Дополнительная информация не отображается, но доступна Copilot для генерации ответов более высокого качества.\n\n## Типы пользовательских инструкций\n\nGitHub Copilot CLI поддерживает инструкции из следующих расположений.\n\nЕсли в таблице ниже не указано, Copilot CLI обнаруживает файлы инструкций репозитория и агента в **стандартных расположениях**: корневой каталог репозитория, текущий рабочий каталог, промежуточные каталоги между ними и все каталоги, вложенные в путь к файлу, над которым он работает. Модульные файлы инструкций ( `*.instructions.md`соответствующие) зависят от пути— файл со `applyTo` значением применяется только к соответствующим файлам.\n\n| Местоположение                                               | Область и поведение                                                                                                                                                                    |\n| ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `$HOME/.copilot/copilot-instructions.md`                     | Инструкции на уровне пользователя, которые применяются к репозиториям.                                                                                                                 |\n| `$HOME/.copilot/instructions/**/*.instructions.md`           | Инструкции на уровне модульных пользователей.                                                                                                                                          |\n| `.github/copilot-instructions.md`                            | Инструкции по всему репозиторию, обнаруженные в стандартных расположениях.                                                                                                             |\n| `.github/instructions/**/*.instructions.md`                  | Инструкции модульного репозитория, обнаруженные в стандартных расположениях, но не промежуточные каталоги.                                                                             |\n| `AGENTS.md`                                                  | Инструкции агента, обнаруженные в стандартных расположениях. Для получения дополнительной информации смотрите [репозиторий agentsmd/agents.md](https://github.com/agentsmd/agents.md). |\n| `CLAUDE.md`                                                  | Инструкции агента, обнаруженные в стандартных расположениях.                                                                                                                           |\n| Copilot CLI также используется `.claude/CLAUDE.md`.          |                                                                                                                                                                                        |\n| `GEMINI.md`                                                  | Инструкции агента, обнаруженные в стандартных расположениях.                                                                                                                           |\n| Каталоги, перечисленные в `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` | Дополнительные `AGENTS.md` и `*.instructions.md` файлы. Разделите несколько каталогов запятыми.                                                                                        |\n\nЕсли вы задаете `COPILOT_HOME` переменную среды, Copilot CLI использует этот каталог вместо `$HOME/.copilot` обоих расположений инструкций на уровне пользователя.\n\n`/instructions` Используйте команду, чтобы просмотреть файлы инструкций, обнаруженные для текущего сеанса, и включить или отключить отдельные файлы.\n\n## Взаимодействие нескольких файлов инструкций\n\nЕсли существуют несколько применимых файлов инструкций на уровне пользователя и репозитория, Copilot CLI объединяет их инструкции. Он удаляет повторяющиеся копии идентичных пользовательских `copilot-instructions.md`, репозиторий и инструкций агента, но не определяет общий порядок приоритета между этими файлами. Избегайте конфликтующих инструкций.\n\nИнструкции, относящиеся к пути, включаются только в том случае, если их `applyTo` значение соответствует файлу, с которым Copilot CLI работает работа. Файл инструкций, который вы отключаете использование `/instructions` , не включается.\n\n## Создание пользовательских инструкций на уровне репозитория\n\n1. В корне вашего репозитория создайте файл с именем `.github/copilot-instructions.md`.\n\n   Создайте папку `.github`, если её ещё нет.\n\n2. Добавьте инструкции по естественному языку в файл в формате Markdown.\n\n   Пробелы между инструкциями игнорируются, поэтому инструкции могут быть написаны как один абзац, каждый из которых находится на новой строке или разделен пустыми строками для удобочитаемости.\n\n   Для помощи в написании эффективных индивидуальных инструкций см. [О кастомизации ответов GitHub Copilot](/ru/enterprise-cloud@latest/copilot/concepts/prompting/response-customization#writing-effective-custom-instructions).\n\n### Ссылка на другие файлы\n\nВ `.github/copilot-instructions.md`, `AGENTS.md`или `CLAUDE.md`используйте `@` относительный путь для включения другого файла.\nCopilot CLI считывает указанный файл немедленно и поддерживает ссылки в ссылочных файлах.\n\nСсылки на файлы должны оставаться в репозитории или в пользовательском каталоге инструкций для локальных инструкций. Абсолютные пути и пути, начинающиеся с `~/` , не загружаются. Ссылки на файлы не развернуты или `GEMINI.md``*.instructions.md` не развернуты.\n\n## Создание пользовательских инструкций для конкретного пути\n\n1. Создайте каталог, `.github/instructions` если он еще не существует.\n\n2. По желанию создайте подкаталоги `.github/instructions` для организации ваших файлов инструкций.\n\n3. Создайте один или несколько `NAME.instructions.md` файлов, где `NAME` указывается назначение инструкций. Имя файла должно заканчиваться `.instructions.md`.\n\n4. В начале файла создайте блок frontmatter, содержащий ключевое `applyTo` слово. Используйте синтаксис glob, чтобы указать, к каким файлам или каталогам применяются инструкции.\n\n   Например:\n\n   ```markdown\n   ---\n   applyTo: \"app/models/**/*.rb\"\n   ---\n   ```\n\n   Можно указать несколько шаблонов, разделив их запятыми. Например, чтобы применить инструкции ко всем файлам TypeScript в репозитории, можно использовать следующий блок frontmatter:\n\n   ```markdown\n   ---\n   applyTo: \"**/*.ts,**/*.tsx\"\n   ---\n   ```\n\n   Примеры Glob:\n\n   * `*` - все будут совпадать со всеми файлами текущей директории.\n   * `**` или `**/*` — все совпадут со всеми файлами во всех каталогах.\n   * `*.py` - будет совпадать со всеми `.py` файлами текущей папки.\n   * `**/*.py` - будет рекурсивно совпадать со всеми `.py` файлами во всех каталогах.\n   * `src/*.py`- будет `.py` совпадать со всеми `src` файлами в каталоге. Например `src/foo.py` , и `src/bar.py`*нет*`src/foo/bar.py`.\n   * `src/**/*.py` - будет рекурсивно совпадать со всеми `.py` файлами в `src` каталоге. Например, `src/foo.py`, `src/foo/bar.py`и `src/foo/bar/baz.py`.\n   * `**/subdir/**/*.py` - будет рекурсивно совпадать со всеми `.py` файлами в любой `subdir` папке на любой глубине. Например, `subdir/foo.py`, `subdir/nested/bar.py`, `parent/subdir/baz.py`, и `deep/parent/subdir/nested/qux.py`, но *не*`foo.py` на пути, не содержащем каталога `subdir` .\n\n5. Опционально, чтобы предотвратить использование файла либо Copilot cloud agent одним из вариантов Copilot code review, добавьте `excludeAgent` ключевое слово в блок фронтматтера. Используйте либо или `\"code-review\"``\"cloud-agent\"`.\n\n   Например, следующий файл будет читаться только .Copilot cloud agent\n\n   ```markdown\n   ---\n   applyTo: \"**\"\n   excludeAgent: \"code-review\"\n   ---\n   ```\n\n   Если ключевое `excludeAgent` слово не включено в передний блок Matterblock, оба Copilot code review и Copilot cloud agent будут использовать ваши инструкции.\n\n6. Добавьте пользовательские инструкции на естественном языке с помощью формата Markdown. Пробелы между инструкциями игнорируются, поэтому инструкции могут быть написаны как один абзац, каждый из которых находится на новой строке или разделен пустыми строками для удобочитаемости.\n\n## Пользуемые инструкции\n\nИзменения, внесенные в пользовательские файлы инструкций, не сразу доступны для использования в активных сеансах CLI. Чтобы применить изменения, выйти из текущего сеанса и возобновить его (например, запустить `copilot --continue`) или запустить новый сеанс (например, использовать `/new` в интерактивном сеансе).\n\n## Дополнительные материалы\n\n* [Поддержка различных типов пользовательских инструкций](/ru/enterprise-cloud@latest/copilot/reference/custom-instructions-support)\n* [Пользовательские инструкции](/ru/enterprise-cloud@latest/copilot/tutorials/customization-library/custom-instructions) — тщательно подобранная коллекция примеров\n* [Использование пользовательских инструкций для разблокировки возможностей обзора кода Copilot](/ru/enterprise-cloud@latest/copilot/tutorials/customize-code-review)"}