技能介绍

你在解决什么问题

在 Azure 上跑 AKS 时，问题往往分散在 Microsoft Learn 的长文档里：升级被弃用 API 卡住、SNAT 端口耗尽、CoreDNS/GPU/Fleet 行为异常、网络策略从 NPM 迁到 Cilium、PCI 与 workload identity 怎么落地。你需要的不只是「搜一篇文档」，而是按场景（运维、架构、合规）快速定位到可执行的章节，并在需要时拿到最新官方 Markdown。

技能如何组织与使用

本技能把 AKS 知识拆成九类分类索引（问题排查、最佳实践、决策制定、架构与设计模式、限制与配额、安全性、配置、集成与编码模式、部署）。Agent 应先用索引表定位主题：带行号范围的条目用 read_file 读 SKILL 内对应段落；带独立参考文件的条目读关联文件（如安全专题）。索引内还挂了大量 Learn 链接，用于细化到具体故障或配置步骤。

远程文档是第二根支柱：技能要求网络访问。优先通过 mcp_microsoftdocs:microsoft_docs_fetch 拉取页面（查询串含 from=learn-agent-skill，返回 Markdown）；若 MCP 不可用，可用 fetch_webpage 并带上 from=learn-agent-skill&accept=text/markdown 作为备用。这样本地索引负责「往哪翻」，远程拉取负责「正文是否跟官方一致」。

适用边界与注意点

技能不替代你在订阅里的实际操作权限；变更集群前仍要在测试环境验证。
若 metadata.generated_at 超过约 3 个月，索引内的行号与链接可能与仓库/文档演进不一致，应提示用户更新技能包。
mcp_microsoftdocs 未安装时，远程拉取能力会打折，应按技能说明引导用户安装后再做深度文档检索。
内容侧重 Microsoft 官方 AKS/Fleet 体系；与 EKS/GKE 的对比条目存在，但主线仍是 Azure 上的 Kubernetes 托管服务。