aks-network-capture — скилл для Claude Code: pcap с узлов AKS
Собирает ограниченные по времени packet capture с узлов AKS и конфигурацию сети Azure, чтобы показать, где именно теряются пакеты.
/plugin marketplace add microsoft/skills
/plugin install aks-skills@skillsЧто делает aks-network-capture
Скилл запускает tcpdump на узлах или подах кластера AKS и складывает результат в pcap. Рядом собирается сетевая конфигурация Azure — она нужна как подтверждение на уровне проводов, а не как догадка по метрикам.
Работа идёт через связанные скрипты: сначала установка ConfigMap, затем создание захвата, при необходимости генерация тестового трафика, извлечение конкретного запуска и сбор данных Azure. Для Bash и PowerShell есть отдельные версии, а сам run-capture.sh выполняется внутри закреплённого Linux-образа из ConfigMap. Нужны kubectl, а для данных Azure — az.
Перед запуском скилл проверяет возможности хоста: разрешён ли shell, есть ли доступ к кластеру и куда складывать артефакты. Если хост не даёт выполнить команды, скилл не станет обходить политику и предложит план сбора. Захват пакетов — это изменение состояния, поэтому согласие на диагностику не считается разрешением на мутацию: перед откатом к debug-контейнеру нужно отдельное подтверждение.
Какие задачи решает
- снять pcap с конкретного узла AKS
- доказать, на каком участке пути пропадают пакеты
- собрать сетевую конфигурацию Azure вместе с захватом
- сгенерировать тестовый трафик для воспроизведения проблемы
- достать результаты конкретного запуска захвата
Примеры запросов агенту
- Сними pcap с узла AKS, где теряются пакеты
- Запусти захват трафика на поде и собери конфигурацию сети Azure
- Сгенерируй тестовый трафик и покажи, где он обрывается
Как установить aks-network-capture
1Через маркетплейс плагинов
/plugin marketplace add microsoft/skills/plugin install aks-skills@skillsКоманда ставит плагин aks-skills целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add microsoft/skills --skill aks-network-capture -a claude-code3Вручную: положить файлы
~/.claude/skills/aks-network-capture/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/aks-network-capture/
Вручную: положить файлы
.agents/skills/aks-network-capture/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/aks-network-capture/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install microsoft/skills aks-network-capture2Вручную: положить файлы
.github/skills/aks-network-capture/SKILL.mdКомандой платформы
gemini skills install https://github.com/microsoft/skills --path .github/plugins/aks-skills/skills/aks-network-captureВручную: положить файлы
.devin/skills/aks-network-capture/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о aks-network-capture
Как установить aks-network-capture в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add microsoft/skills, затем установите плагин: /plugin install aks-skills@skills.
Что делает aks-network-capture?
Собирает ограниченные packet capture с узлов AKS и данные о сетевой конфигурации Azure. Это даёт доказательства на уровне пакетов, а не общие выводы о связности.
Что нужно для работы скилла?
kubectl для доступа к кластеру и az для данных Azure. Ещё хост должен разрешать выполнение Bash или PowerShell и доступ к связанным скриптам.
Исходный текст
SKILL.md · MIT
--- name: aks-network-capture description: "Collects bounded packet captures from AKS nodes and Azure network configuration for wire-level evidence. WHEN: \"capture packets on an AKS node\", \"take a pcap\", \"run tcpdump on AKS\", \"prove where packets drop\". Use for explicit packet-capture intent after read-only diagnostics, not general AKS connectivity or ingress troubleshooting." license: MIT metadata: author: Microsoft version: "1.0.1" --- # AKS Network Capture ## Quick Reference | Use | Requires | Safety | | --- | --- | --- | | AKS pcap evidence | `kubectl`; `az` for Azure evidence | Bounded, pinned, least privilege | ## When to Use This Skill Use for explicit packet capture after read-only checks, not generic connectivity failures. ## MCP Tools Azure MCP's AKS area provides cluster and node-pool metadata, not Kubernetes command execution or packet capture. ## Host Capability Gate Before executing the workflow, confirm that the host permits the required Bash or PowerShell execution, `kubectl` access to the bound cluster, `az` for Azure evidence, access to the bundled scripts, and an approved artifact destination. A governed Azure CLI tool alone does not establish that shell, Kubernetes commands, or artifact operations are supported. If a required capability is unavailable or prohibited, state that capture execution is unavailable in this host. Analyze supplied, appropriately redacted evidence or give the operator a target-bound collection/capture plan; do not claim to have run it. Never route `kubectl` through Azure MCP, add an unapproved execution path, or bypass host policy. Host support does not replace the mutation and sensitive-data approvals below. Run bundled scripts from the skill root only after this gate is satisfied. ## Workflow/Steps 0. Check host capabilities, then complete [authorization and target binding](references/capture-authorization.md). Capture intent is not mutation consent. Stop for separate approval before any debug-container fallback. 1. Install [Bash](scripts/setup-capture-configmap.sh) / [PowerShell](scripts/setup-capture-configmap.ps1). 2. Capture nodes or pods with [Bash](scripts/create-capture.sh) / [PowerShell](scripts/create-capture.ps1). 3. Generate traffic if approved with [Bash](scripts/generate-test-traffic.sh) / [PowerShell](scripts/generate-test-traffic.ps1). 4. Retrieve the exact run with [Bash](scripts/retrieve-captures.sh) / [PowerShell](scripts/retrieve-captures.ps1). 5. Gather Azure evidence with [Bash](scripts/collect-azure-network-info.sh) / [PowerShell](scripts/collect-azure-network-info.ps1). The ConfigMap runs [run-capture.sh](scripts/run-capture.sh) inside its pinned Linux image. ## Error Handling | Error | Action | | --- | --- | | Invalid input | Correct it before retrying. | | Missing/stale ConfigMap | Run setup again. | | Capture/retrieval failure | Inspect Job logs; missing evidence is not success. |
© Microsoft · MIT · microsoft/skills
