О навыках агента

Агентские навыки расширяют возможности инсайдеров Агент кодирования Copilot, GitHub Copilot CLI и Visual Studio Code инсайдеров выполнять специализированные задачи.

Кто может использовать эту функцию?

Агент кодирования Copilot доступен с планами GitHub Copilot Pro, GitHub Copilot Pro+, Бизнес GitHub Copilot и GitHub Copilot Enterprise. Агент доступен во всех репозиториях, хранящихся на GitHub, за исключением репозиториев, принадлежащих управляемые учетные записи пользователей и где он был явно отключен.

GitHub Copilot CLI доступен для планов GitHub Copilot Pro, GitHub Copilot Pro+, Бизнес GitHub Copilot и GitHub Copilot Enterprise планов. Если вы получаете Copilot из организации, политика Интерфейс командной строки Copilot должна быть включена в параметрах организации.
Sign up for Copilot

В этой статье

О навыках агента

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

Навыки агента работают с Агент кодирования Copilot, GitHub Copilot CLI и режимом агента в Visual Studio Code Insiders. Поддержка стабильной версии VS Code появится в ближайшее время.

Вы можете создавать собственные навыки, чтобы обучать Copilot выполнять задачи определённым, повторяемым способом — или использовать навыки, которые делятся онлайн, например, в anthropics/skills репозитории или в сообществе GitHub github/awesome-copilot .

В настоящее время навыки можно создавать только на уровне репозитория. Поддержка навыков организационного и корпоративного уровня появится в ближайшее время.

Вы можете использовать как навыки, так и пользовательские инструкции, чтобы обучить Copilot работе в вашем репозитории и выполнении конкретных задач. Мы рекомендуем использовать пользовательские инструкции для простых инструкций, относящихся почти к каждой задаче (например, информация о стандартах кодирования вашего репозитория), а также навыки более подробных инструкций, к которым Copilot должны получить доступ при необходимости. Чтобы узнать больше о пользовательских инструкциях репозитория, смотрите АВТОЗАГОЛОВОК.

Примечание.

GitHub Copilot CLI находится в Общедоступная предварительная версия с защитой данных и может быть изменен.

Добавление навыков в ваш репозиторий

  1. Создайте .github/skills каталог для хранения своих навыков.

    Примечание.

    Также поддерживаются навыки, .claude/skills хранящиеся в каталоге.

  2. Создайте подкаталог для вашего нового навыка. У каждого навыка должна быть своя собственная папка (например, .github/skills/webapp-testing). Имена каталогов навыков должны быть строчными, использовать дефисы для пробелов и обычно совпадают с name названиями на SKILL.md фронтике.

  3. Создайте SKILL.md файл с инструкциями вашего навыка.

    Примечание.

    Файлы навыков должны быть названы SKILL.md.

           `SKILL.md` файлы — это файлы Markdown с YAML frontmatter. В самом простом виде они включают в себя:
    • Титульный лист YAML * имя (обязательно): уникальный идентификатор навыка. Это, должно быть, строчная буква, с дефисами для пробелов. * Описание (требуется): Описание того, что делает навык и когда Copilot должен его использовать. * лицензия (по желанию): описание лицензии, применяемой к данному навыку.
    • Корпус Markdown с инструкциями, примерами и рекомендациями для Copilot для следования.

  4. По желанию добавьте скрипты, примеры или другие ресурсы в каталог ваших навыков. Например, если вы пишете навык для конвертации изображений между разными форматами, вы можете включить скрипт для конвертации SVG-изображений в PNG.

Пример файла SKILL.md

Этот файл будет находиться в .github/skills/github-actions-failure-debugging каталоге.

Markdown
---
name: github-actions-failure-debugging
description: Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows.
---

To debug failing GitHub Actions workflows in a pull request, follow this process, using tools provided from the GitHub MCP Server:

1. Use the `list_workflow_runs` tool to look up recent workflow runs for the pull request and their status
2. Use the `summarize_job_log_failures` tool to get an AI summary of the logs for failed jobs, to understand what went wrong without filling your context windows with thousands of lines of logs
3. If you still need more information, use the `get_job_logs` or `get_workflow_run_logs` tool to get the full, detailed failure logs
4. Try to reproduce the failure yourself in your own environment.
5. Fix the failing build. If you were able to reproduce the failure yourself, make sure it is fixed before committing your changes.

Как Copilot использует навыки

При выполнении задач Copilot решает, когда использовать ваши навыки, исходя из вашего запроса и описания навыка.

Когда Copilot решает использовать навык, файл SKILL.md будет введён в контекст агента, давая агенту доступ к вашим инструкциям. Затем он может следовать этим инструкциям и использовать любые скрипты или примеры, которые вы могли включить в каталог навыка.