Создание агентских навыков для GitHub Copilot

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

В этой статье

Примечание.

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

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

Создание и добавление навыка

Чтобы создать навык агента, вы пишете SKILL.md файл и, по желанию, другие ресурсы, такие как дополнительные файлы Markdown или скрипты, на которые вы ссылаетесь в SKILL.md инструкциях.

Чтобы добавить навык, вы сохраняете файл SKILL.md и все вспомогательные ресурсы в место, где Copilot знает, что нужно искать навыки. Это может быть как в репозитории, так и в вашем домашнем каталоге.

  1. Создайте skills каталог для хранения своих навыков и других навыков, которые вы захотите создать в будущем.

    Для проектных навыков, специфичных для одного репозитория, храните свой навык в .github/skills или .claude/skills.

           **Для личных навыков**, которые используются в разных проектах, храните свои навыки под `~/.copilot/skills` или `~/.claude/skills`.

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

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

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

    Внимание

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

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

  4. По желанию добавьте скрипты, примеры или другие ресурсы в каталог ваших навыков.

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

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

Для проектного навыка этот файл будет находиться в .github/skills/github-actions-failure-debugging каталоге вашего репозитория.

Для личного навыка этот файл должен находиться в каталоге ~/.copilot/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 будет введён в контекст агента, давая агенту доступ к вашим инструкциям. Затем он может следовать этим инструкциям и использовать любые скрипты или примеры, которые вы могли включить в каталог навыка.

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

Вы можете использовать как навыки, так и пользовательские инструкции, чтобы обучить Copilot работе в вашем репозитории и выполнении конкретных задач.

Мы рекомендуем использовать пользовательские инструкции для простых инструкций, относящихся почти к каждой задаче (например, информация о стандартах кодирования вашего репозитория), а также навыки более детальных инструкций, которые Copilot должен получить доступ только по актуальности.

Чтобы узнать больше о пользовательских инструкциях репозитория, смотрите АВТОЗАГОЛОВОК.