Навыки агента #REF!

#REF! Навыки агента (Agent Skills) — это собственный каталог, созданный Microsoft, навыков, доступных для анализа с помощью искусственного интеллекта, для разработки #REF!. Каждый навык — это структурированный индекс авторитетного содержимого Microsoft Learn, упакованный таким образом, чтобы ассистенты ИИ для кодирования могли обнаруживать и использовать его для предоставления точного и актуального руководства по службам #REF!.

Навыки следуют Agent Skills open standard и работают с любым совместимым помощником по написанию ИИ, включая #REF! Copilot, Claude Code, Cursor, Gemini CLI, Codex CLI и другие.

Случаи использования

  • Предоставьте помощникам по написанию кода с искусственным интеллектом экспертное руководство по #REF!, основывающееся на официальной документации.
  • Повышение точности и полноты ответов агента для задач разработки #REF!
  • Позволяет разработчикам получать рекомендации, устранять неполадки, шаблоны архитектуры и рекомендации по безопасности непосредственно в редакторе.
  • Предоставляет актуальные структурированные знания, которые дополняют динамические инструменты данных, такие как серверы MCP

Как работают навыки агента

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

Навыки используют постепенное раскрытие информации для эффективной загрузки содержимого:

  1. Обнаружение — помощник по искусственному интеллекту считывает навык и интерфейс YAML для определения релевантности
  2. Инструкции . При активации помощник загружает полное содержимое, которое содержит ссылки на курированную документацию, упорядоченные по разделу
  3. Получение — помощник извлекает обновлённый контент из Microsoft Learn с помощью сервера Learn MCP или средства веб-извлечения

Эта архитектура отделяет индекс знаний (что нужно искать и когда) от доставки содержимого (получение последних документов во время запроса), гарантируя, что навыки остаются актуальными по мере развития документации.

Каталог навыков автоматически создается и поддерживается специально разработанным рабочим процессом (pipeline), который сканирует документацию по продуктам #REF!, идентифицирует ценное процедурное и аналитическое содержимое и преобразует его в структурированные файлы навыков. Производственный конвейер постоянно оценивает изменения содержимого верхнего источника и создает инкрементные обновления.

Каталог навыков

Репозиторий содержит навыки 193 охватывающие основные службы #REF! в следующих категориях:

Категория Навыки Примеры
Инфраструктура и управление двадцать семь Azure Resource Manager, резервное копирование, мониторинг, политика, управление затратами, Arc
Специализированный двадцать семь Quantum, Maps, Решение VMware, SAP, Службы данных здравоохранения, Виртуальный рабочий стол
Нетворкинг двадцать четыре Виртуальная сеть, Front Door, Брандмауэр, VPN-шлюз, ExpressRoute, Балансировщик нагрузки
ИИ и ML 20 Службы ИИ, Машинное обучение, аналитика документов, речь, Служба Bot
Данные и аналитика 20 Cosmos DB, База данных SQL, Фабрика данных, Synapse Analytics, Databricks
Безопасность и идентификация 17 Key Vault, RBAC, Sentinel, Defender для облачных вычислений, Конфиденциальные вычисления
DevOps 14 Azure DevOps, конвейеры, реестр контейнеров, среды развертывания, Поле разработки
Compute 13 Функции, контейнерные приложения, Виртуальные машины, Служба Kubernetes, Служба приложений
Интеграция 12 Logic Apps, управление API, Сетка событий, служебная шина, Центры событий
Хранение 9 Хранилище BLOB-объектов, Файлы, Elastic SAN, NetApp Files, Хранилище контейнеров
IoT и Edge 7 Центр Интернета вещей, IoT Central, IoT Edge, Операции Интернета вещей, Digital Twins

Курируемые пакеты на основе ролей доступны для распространенных сценариев (Основные компоненты, инфраструктура, проектирование данных, ИИ/ML, безопасность, DevOps).

Полный каталог навыков доступен в docs/CATALOG.md.

Требования

  • Требуется доступ к сети. Навыки ссылаются на URL-адреса документации Microsoft Learn, которые ИИ извлекает во время выполнения запроса.
  • Совместимый помощник по программированию на основе ИИ, поддерживающий открытый стандарт Agent Skills (формат).
  • Рекомендуется: сервер Microsoft Learn MCP для оптимального получения документации. Если сервер MCP Learn недоступен, навыки переключаются на возможности веб-запросов, встроенные в большинство помощников по искусственному интеллекту.

Проверка подлинности не требуется для использования навыков. Навыки — это статические файлы, которые выполняются локально в среде разработки.

Начало работы

Installation

  1. Клонируйте репозиторий:

    git clone https://github.com/MicrosoftDocs/agent-skills.git

  2. Скопируйте папки навыков из каталога навыков помощника по искусственному интеллекту:

    Помощник по искусственному интеллекту Путь на уровне проекта Глобальный путь
    #REF! Copilot {project}/.github/skills/ ~/.copilot/skills/
    Код Клода {project}/.claude/skills/ ~/.claude/skills/
    Codex CLI {project}/.codex/skills/ ~/.codex/skills/
    Cursor {project}/.cursor/skills/ —
    Интерфейс командной строки Gemini {project}/.gemini/skills/ —

    Это важно

    Скопируйте папки внутри (например, , не саму папку ).

  3. Пользователи VS Code: включите чат и используйте навыки агента в настройках.

  4. Начните задавать вопросы вашему помощнику #REF! на базе ИИ. Навыки активируются автоматически на основе запроса.

Использование

После установки задайте вопросы помощника по искусственному интеллекту естественным образом:

  • "Помогите мне настроить Функции Azure и Устойчивые функции"
  • "Каковы рекомендации по Контейнеры приложений Azure?"
  • Я получаю ошибки ограничения скорости в моей учетной записи хранилища — как диагностировать такие ошибки?

Помощник автоматически обнаруживает соответствующие навыки, загружает структурированное руководство и извлекает последнюю документацию из Microsoft Learn, чтобы предоставить точные и обоснованные ответы.

Compatibility

Эти навыки работают с любым помощником по программированию ИИ, поддерживающим спецификацию навыков агента:

Помощник по программированию искусственного интеллекта Тип Путь к навыкам
#REF! Copilot Расширение VS Code .github/skills/
Код Клода Anthropic CLI .claude/skills/
Codex CLI OpenAI CLI .codex/skills/
Cursor Интегрированная среда разработки, изначально ориентированная на ИИ .cursor/skills/
Интерфейс командной строки Gemini Google DeepMind .gemini/skills/
Antigravity IDE Интегрированная среда разработки DeepMind .agent/skills/
OpenCode Интерфейс командной строки с открытым кодом .agent/skills/

Взаимосвязь с сервером Learn MCP

Навыки агента и сервер MCP Learn являются дополнительными:

  • Learn MCP Server предоставляет инструменты для работы с содержимым Microsoft Learn — поиск, извлечение и выборка примеров кода.
  • Навыки агента предоставляют знания — структурированные рекомендации по тому, что искать, когда и как применять.

Навыки используют сервер Learn MCP (или эквивалентный метод получения данных) в качестве механизма доставки содержимого. Вместе они дают помощникам по искусственному интеллекту как способность распознавать, что важно, так и возможность извлекать самое авторитетное последнее содержимое.

Доступность и цены

Навыки для агента #REF! доступны как общедоступный репозиторий с открытым исходным кодом под двойной лицензией.

  • Содержимое документации: Creative Commons Attribution 4.0 International
  • Код: лицензия MIT

Нет платы за использование навыков.

Ограничения

  • Навыки требуют доступа к сети для получения документации из Microsoft Learn. Без доступа к сети навыки предоставляют индексы курированных ссылок, но не могут получить полное содержимое.
  • В настоящее время каталог навыков охватывает 193 #REF! службы. Охват расширяется при каждом запуске конвейера по мере публикации новой документации.
  • Навыки создаются из общедоступной документации Microsoft Learn. Содержимое из учебных модулей, схем обучения и курсов под руководством инструктора в настоящее время не включается.
  • Конвейер генерации выполняется инкрементально. Может быть небольшая задержка между обновлениями документации в Microsoft Learn и соответствующими обновлениями навыков.

Как предоставить отзыв

  • #REF! Проблемы: https://github.com/MicrosoftDocs/agent-skills/issues (предпочтительнее для ошибок, пробелов или запросов функций).
  • Вклады: Репозиторий приветствует пул-реквесты. Ознакомьтесь с рекомендациями по участию в README.

Дальнейшие шаги

  • Начало работы с сервером Learn MCP в VS Code
  • Спецификация "Навыки агента" с открытым стандартом
  • репозиторий навыков агента #REF!
  • Подборки навыков для каждой роли
  • Last updated on