custom-agents

Custom Agents — справочник GitHub для описания и проверки Markdown-файлов custom agents, repository instructions, prompts и примеров. Он объясняет, как Copilot читает инструкции с YAML frontmatter и Markdown body, как выбрать область действия файла и как связать профиль агента с agentic workflow. Карточка полезна, когда в репозитории нужно отделить общие правила от path-specific требований или оформить специализированного агента с понятными возможностями. Формат файла остаётся обычным Markdown: frontmatter задаёт конфигурацию, а тело содержит естественно-языковые инструкции. Для repository-wide правил источник указывает .github/copilot-instructions.md. Такой файл распространяет общие coding standards, требования безопасности и тестирования на генерацию кода в репозитории. Для правил, зависящих от пути, используется каталог .github/instructions/ и файлы с суффиксом .instructions.md. Их область задаётся полем applyTo с glob-шаблонами, например отдельными масками для frontend-кода или компонентов. Это позволяет не смешивать требования к разным каталогам: инструкция для frontend может описывать структуру React-компонентов, стили и управление состоянием, тогда как другие правила остаются вне её scope. Профили custom agent размещаются в .github/agents/ или .github/copilot/instructions/. Источник приводит имена AGENTS.md и отдельных Markdown-файлов вроде readme-creator.md или test-writer.md. Для профиля name является обязательным идентификатором, description кратко объясняет назначение, prompt может заменить или дополнить тело Markdown, а tools ограничивает доступные возможности. В стандартных alias перечислены read, edit, search, pr и issue. Документ также описывает совместимость с legacy-именами createFile, editFiles, deleteFiles, codeSearch, runCommand, getFile и listFiles; имена инструментов нечувствительны к регистру. Пустой список tools отключает инструменты, а wildcard разрешает весь доступный набор, поэтому его следует задавать осознанно. Конфигурация может включать MCP-сервер: поле mcp-server содержит url и api-key, причём ключ предназначен для GitHub secrets, а не для публикации в файле. В списке tools допускаются как отдельные серверные инструменты с префиксом server/tool-name, так и все инструменты сервера через server/*. Необязательное settings хранит runtime-параметры, но их конкретный набор зависит от реализации агента. Для path-specific инструкций применимо только applyTo; оно поддерживает * и ** и несколько шаблонов. Так структура frontmatter сама подсказывает, какие поля относятся к профилю, а какие — к области файлов. Источник показывает несколько сценариев. README creator получает read, edit и search, чтобы собрать документ из фактов репозитория, проверить примеры и ссылки. Test writer получает те же базовые инструменты для подготовки тестов по выбранному стеку. В workflow-файле можно указать engine copilot и custom-agent, ссылающийся на .github/agents/code-reviewer.md; такой агент может иметь только read и search, если ему не нужны изменения. Для agentic workflow импорт выполняется через поле imports, а источником импорта могут быть Markdown-файлы в .github/agents/. Важное ограничение этого режима: для одного workflow разрешён только один agent file, поэтому несколько профилей нельзя молча смешивать в одну декларацию. Практическая проверка начинается с фактического расположения файла, чтения frontmatter и сопоставления applyTo или workflow import с нужной областью. Затем проверяют уникальность name, соответствие tools реальным задачам и отсутствие секретов в конфигурации. Этот навык не выдаёт готовую бизнес-логику агента и не обещает, что произвольное поле будет принято конкретным рантаймом: он описывает формат GitHub Copilot и типовые структуры. Поведение нужно проверять в целевом репозитории, с его правилами, доступными инструментами и разрешениями.