aks-skills — плагин для Claude Code: что делает и как установить
Плагин добавляет в Claude Code и GitHub Copilot навыки глубокой диагностики кластеров AKS, захвата сетевых пакетов и отладки инференса на GPU.
/plugin marketplace add microsoft/skills
/plugin install aks-skills@skillsЧто делает aks-skills
В состав плагина входят пять навыков для поддержки Azure Kubernetes Service. Скилл aks-troubleshooting собирает данные об инциденте в режиме чтения и формирует отчёт о первопричине сбоя, а aks-known-issues сверяет сигнатуру ошибки с базой Microsoft Learn. Для сложных неполадок предусмотрены перехват сетевых пакетов aks-network-capture на выбранных узлах и отладка нагрузок машинного обучения aks-gpu-inference под управлением KAITO.
Плагин опирается на настроенные в системе учётные данные az и kubectl. Ресурсы кластера он не меняет. Без вашего прямого согласия агент не запустит даже сбор сетевого трафика. Для формирования ссылок на портал скилл azure-search-nav авторизуется через Connect-AzAccount.
При работе плагин загружает бинарный файл телеметрии ghcfa-telem с проверкой хеша SHA-256. Если отправку телеметрии нужно отключить, задайте в среде переменную AZURE_MCP_COLLECT_TELEMETRY=false.
Какие задачи решает
- разобрать инцидент в кластере AKS с формированием отчёта о первопричинах
- найти готовое решение известной ошибки AKS по базе Microsoft Learn
- собрать дамп сетевых пакетов с выбранного узла кластера
- устранить нехватку памяти и сбои планировщика в GPU-инференсе на KAITO
Примеры запросов агенту
- Собери диагностические данные по сбою пода в кластере AKS и найди первопричину
- Проверь эту ошибку AKS по базе известных проблем Microsoft Learn
- Сделай ограниченный захват сетевых пакетов на узле
aks-nodepool1
Как установить aks-skills
Через маркетплейс плагинов
/plugin marketplace add microsoft/skills/plugin install aks-skills@skillsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о aks-skills
Как установить aks-skills в Claude Code?
Выполните по очереди команды /plugin marketplace add microsoft/skills и /plugin install aks-skills@skills.
Какие доступы нужны для работы плагина?
Плагину требуются настроенные утилиты az и kubectl с правами на чтение состояния кластера. Для поиска страниц в портале Azure понадобится авторизация через Connect-AzAccount.
Как отключить сбор телеметрии?
Задайте в среде выполнения агента переменную AZURE_MCP_COLLECT_TELEMETRY=false. По умолчанию хук плагина скачивает утилиту ghcfa-telem с проверкой SHA-256 для отправки метрик.
Исходный текст
aks-skills · MIT
# AKS Skills Optional Azure Kubernetes Service (AKS) operational skills for live incident diagnosis, known-issue matching, GPU inference troubleshooting, and packet capture. Install it alongside the base `azure` plugin when you operate AKS clusters. ## Security - The troubleshooting and capture skills read cluster and Azure state with your existing `az` and `kubectl` credentials. They do not change resources or start a packet capture without your explicit approval. - `azure-search-nav` signs you in with `Connect-AzAccount` and sends your Azure Resource Manager access token to the Azure portal navigation search service, the same pattern Azure Copilot uses in the portal. It returns links only and does not modify resources. See its [authentication and data flow notes](skills/azure-search-nav/references/README.md#authentication-and-data-flow). ## Telemetry The `track-telemetry` hook installs a pinned native `ghcfa-telem` release asset when needed, verifies its platform-specific SHA-256 digest before extraction, and caches the executable for reuse. To opt out of telemetry collection, set `AZURE_MCP_COLLECT_TELEMETRY=false` in the environment of the process running the agent. ## Skills | Skill | Use it to | |-------|-----------| | **aks-troubleshooting** | Investigate live AKS incidents with read-only evidence collection and a structured root-cause report | | **aks-known-issues** | Match a named AKS error signature to its documented cause, fix, and Microsoft Learn reference | | **aks-network-capture** | Collect bounded packet captures from selected AKS nodes for wire-level troubleshooting | | **aks-gpu-inference** | Diagnose GPU and KAITO inference workloads: scheduling, out-of-memory, observability, and scaling | | **azure-search-nav** | Get an Azure portal deep link to a specific blade for a supported AKS, Arc-enabled Kubernetes, or Compute resource | ## Relationship to the base `azure` plugin The base `azure` plugin keeps AKS planning, cluster setup, deployment, and baseline diagnostics. This plugin adds deeper operational skills and is never installed automatically: when one would help, the agent explains why and asks before installing it. If you decline, or your host can't install it, the agent continues with the base guidance. ## Install In Copilot CLI: 1. Add the marketplace: `/plugin marketplace add microsoft/azure-skills` 2. Install this plugin: `/plugin install aks-skills@azure-skills` 3. Update it later with `/plugin update aks-skills@azure-skills` If your organization's plugin policy blocks this plugin, the base `azure` plugin's AKS guidance remains available.
© Microsoft · MIT · microsoft/skills
