microsoft-docs

microsoft-docs — официальный навык Microsoft для понимания технологий через поиск и получение материалов Microsoft Learn. Он предназначен для вопросов о Azure, .NET, Microsoft 365, Windows и Power Platform, а также для ситуаций, когда нужно разобраться, как работает технология, найти учебный сценарий, параметры конфигурации, лимиты, квоты или рекомендации по лучшим практикам. Важная особенность карточки: навык ориентирован на работу с официальной документацией, поэтому ответ строится от найденного материала Microsoft Learn, а не от неподтверждённого пересказа стороннего источника. Основной инструмент поиска — microsoft_docs_search. Его следует использовать, чтобы найти концепцию, обзор, tutorial, quickstart или страницу с нужной настройкой. Для получения полного содержания предусмотрен microsoft_docs_fetch; он нужен после поиска, когда короткого фрагмента недостаточно. В исходном SKILL.md отдельно указаны случаи для полного fetch: пошаговые tutorials, configuration guides, глубокие разборы, а также обрезанные search excerpts. Такой двухшаговый процесс помогает сначала сузить область запроса, а затем читать полный официальный контекст перед объяснением или подготовкой инструкции. Качество запроса зависит от конкретики. В источнике приведено различие между слишком широким запросом вроде Azure Functions и уточнённым запросом про Python v2 programming model, quickstart или best practices. К запросу рекомендуется добавлять версию, если она важна, намерение пользователя — overview, tutorial, limits или quickstart — и платформу, когда технология работает в нескольких средах, например Linux или Windows. Это особенно важно для .NET, Azure-сервисов и конфигураций, где одинаковое название может скрывать разные версии, режимы или ограничения. Набор сценариев включает понимание концепций, изучение сервиса, поиск пошагового tutorial, получение вариантов настройки, проверку limits и quotas и поиск security best practices в официальных материалах. Для вопроса о Cosmos DB можно искать partition key design best practices; для Container Apps — scaling rules KEDA; для Azure Functions — конкретную модель программирования. После выдачи поиска полезно получить полную страницу, если требуется выполнить шаги без пропусков или объяснить зависимость между параметрами. Совместимость предусматривает основной Microsoft Learn MCP Server по адресу https://learn.microsoft.com/api/mcp. Если MCP недоступен, источник предлагает запасной вариант через mslearn CLI: npx @microsoft/learn-cli search "azure functions timeout" или npx @microsoft/learn-cli fetch с URL; для установленного CLI используются команды mslearn search и mslearn fetch. Поэтому отсутствие MCP не является поводом придумывать локальную базу фактов, но требует явно перейти к резервному способу получения официальной страницы. Навык отвечает за поиск и понимание документации, а не за автоматическое изменение Azure, Windows, .NET или Microsoft 365. Он не превращает найденный фрагмент в гарантию применимости: версию, платформу, режим и ограничения нужно уточнить в полной странице Learn. Если выдача обрезана, следует выполнить fetch; если нужен tutorial, необходимо проверить весь порядок шагов; если нужен лимит или quota, требуется читать соответствующий официальный раздел, а не переносить число из общего обзора.