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

Модифицировать поведение и возможности Copilot при выполнении конкретных задач.

В этой статье

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

Чтобы сказать Copilot использовать конкретный навык, включите название навыка в подсказку, перед которым следует косой чертой вперёд. Например, если у вас есть навык под названием «frontend-design», вы можете использовать подсказку, например:

Use the /frontend-design skill to create a responsive navigation bar in React.

Командование навыками в CLI

  •         **Перечислите доступные навыки:** используйте команду `/skills list` или строку:

    What skills do you have?

  •         **Включите или отключите определённые навыки:** используйте команду `/skills` , а затем используйте клавиши вверх и вниз на клавиатуре и пробел, чтобы включить или выключить навыки.

  •         **Узнайте больше о навыке** (включая его местоположение): используйте команду `/skills info`.

  •         **Добавьте место навыков:** чтобы добавить альтернативное место для хранения навыков, используйте команду `/skills add`.

  •         **Перезарядка навыков:** если вы добавили навык во время сессии CLI, вы можете добавить его с помощью команды `/skills reload` , чтобы не перезапускать CLI для использования.

  •         **Удалить навыки:** чтобы удалить навык, который вы добавили напрямую — не через плагин — используйте команду `/skills remove SKILL-DIRECTORY`. Чтобы удалить навыки, добавленные в плагин, нужно управлять самим плагином. Используйте `info` подкоманду, чтобы узнать, из какого плагина взят навык.

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

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

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

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

Чтобы узнать больше о том, чем навыки отличаются от других функций кастомизации, см. Сравнение особенностей настройки CLI на GitHub Copilot.