1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | azure-well-architected-MicrosoftDocs-Agent-Skills |
| 项目自述名称 | Azure Well Architected Skill |
| 作者/维护者 | Microsoft（MicrosoftDocs 官方仓库） |
| 来源链接 | https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-well-architected |
| 许可证 | 内容 CC BY 4.0 + 代码 MIT（数据来自仓库 LICENSE / LICENSE-CODE 文件） |
| GitHub Stars | 724★（数据来自 GitHub API；为合集仓库整体数字，仓库下共 200+ 个子技能，不代表本技能自身热度） |
| Forks | 117（同上，合集整体数字） |
| 最新版本 | 无独立版本号，SKILL.md 元数据标注 generated_at: 2026-08-09，由文档同步流水线持续更新 |
| 安装方式 | 插件市场一键安装，或克隆仓库后手动复制 |
2. 功能介绍与亮点
本技能是微软官方 docs2skills 工具从 Microsoft Learn 文档批量生成的 Azure Well-Architected Framework（WAF）专家知识库。与合集内其他聚焦单一 Azure 服务的技能不同，本技能覆盖的是横跨全部 Azure 服务的架构设计方法论——不限定于某一款产品，而是解决“如何评估与优化任意一个 Azure 工作负载”这个更上层的问题。正文以「分类索引」组织七大主题：设计评审检查清单、成本/可靠性/性能/安全/运维优化建议、设计原则、跨维度取舍（tradeoffs）、按服务给出的 WAF 落地指南（30 个具体 Azure 服务）、按工作负载类型的参考架构（AI、高性能计算、任务关键型、SaaS、可持续设计），以及成熟度评估问卷。
技术上采用「本地行号索引 + 按需远程抓取」模式：agent 先用本地索引定位相关章节，再通过 mcp_microsoftdocs:microsoft_docs_fetch（或回退到通用网页抓取）取回文档正文，避免把全部文档内容一次性塞进上下文。内容规模上，正文覆盖 30 个具体 Azure 服务的落地指南与 5 类工作负载参考架构，是一份不绑定具体产品线、可服务于任何 Azure 架构决策场景的技能。
3. 适用场景
固定分类：DevOps 与基础设施
适用于负责 Azure 云架构设计与评审的解决方案架构师、平台工程师与技术负责人：新项目立项阶段对照设计原则与检查清单做架构预审、迁移或重构前评估现有工作负载在成本/可靠性/安全/性能各维度的差距、针对 AI/HPC/SaaS/任务关键型等特定工作负载类型套用官方参考架构、在成本与可靠性等目标冲突时查阅官方取舍指南辅助决策、定期用成熟度评估问卷复盘架构健康度。适用群体覆盖面比单一服务技能（如仅覆盖某个具体 Azure 产品）更广，因为 WAF 方法论适用于几乎所有 Azure 工作负载，不要求使用特定服务作为前提。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方插件市场一键安装（/plugin marketplace add + /plugin install），亦可手动复制到 .claude/skills/ |
| Codex | 原生支持 | 官方插件市场一键安装（codex plugin marketplace add），亦可手动复制到 .codex/skills/ |
| OpenClaw | 未验证 | README 明确列出的受支持工具（Claude Code / Gemini CLI / Codex CLI / Antigravity IDE / GitHub Copilot / Cursor / OpenCode / AdaL CLI）未包含 OpenClaw；技能遵循通用的 Agent Skills 开放标准，理论上可手动安装，但未见官方或第三方验证 |
| Hermes Agent | 未验证 | 同上，README 未提及，且未找到第三方验证信息 |
5. 推荐理由
它把分散在数十个 Microsoft Learn 页面上的 Azure Well-Architected Framework 官方指南（设计原则、跨维度取舍、按服务落地指南、按工作负载参考架构、成熟度评估）预编译成一份可检索的结构化索引，且是合集内唯一不依赖具体产品线、能覆盖任意 Azure 架构决策场景的技能——无论 agent 协助的是数据库选型、AI 应用架构还是成本优化，都能命中这份通用方法论，而不必像单一服务技能那样先判断用户具体在用哪款产品。官方持续同步维护，内容随 Azure 官方文档更新而更新。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Microsoft 官方一线厂商出品（发布方即 Azure Well-Architected Framework 的所有者）；未见针对本子技能自身的独立热度数据（如独立第三方评测、可量化采用数据）支撑更高档评分 |
| 可用性 | 9 | 插件市场一键安装或克隆复制两种路径皆简单；文档结构完整（七大分类索引 + 精选官方链接，覆盖 30 个服务与 5 类工作负载）；仓库有近期同步更新记录（generated_at: 2026-08-09，仓库最近一次推送在其后一周内）；无付费依赖 |
| 安全性 | 9 | 纯文档/参考类技能，不执行本地代码；仅通过官方 MCP 工具或网页抓取访问 learn.microsoft.com 官方域名，外联目标透明；License 明确；官方账号维护，无造假迹象 |
综合评分：8.3（三项均值）
安全检查清单：①无 shell 命令执行 ②仅联网抓取 Microsoft Learn 官方文档，无其他数据外发 ③不要求 API Key 或其他凭据 ④SKILL.md 正文未见可疑指令或隐蔽外发 ⑤作者为 Microsoft 官方账号，信誉明确 ⑥License 明确（CC BY 4.0 + MIT）⑦近期有周期性维护记录
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| wa-review-aws-samples-sample-well-architected-skills-and-steering | AWS 官方出品的 AWS Well-Architected Framework 评审技能，逻辑结构类似但服务对象是 AWS 平台 | 云厂商不同，方法论体系不互通；两者是同类思路在不同云平台上的对应产品，不构成同平台内的重复 |
| google-cloud-waf-reliability-google-skills 等系列 | Google Cloud 官方出品的 Well-Architected Framework 分主题技能（成本优化/安全/可靠性各拆成独立子技能） | 服务 GCP 平台，且按 WAF 单一支柱拆分为多个子技能；本技能服务 Azure 平台，一份技能内覆盖全部支柱与跨服务落地指南，颗粒度更整合 |
| azure-app-service-MicrosoftDocs-Agent-Skills 等同合集单产品技能 | 聚焦某一具体 Azure 服务（如 App Service）的开发、故障排查与配置知识 | 定位是“单一产品的深度操作手册”；本技能是“跨产品的架构方法论”，两者互补——具体开发用单产品技能，架构评审与选型决策用本技能 |
8. 用户评价
该技能所在的 MicrosoftDocs/Agent-Skills 合集曾被微软官方工程博客（All Things Azure）以工程团队一手视角介绍，作者为 Microsoft 应用 AI 团队的首席研究工程师；但该文章未提及 azure-well-architected 这一具体子技能，也未给出用户采用数据。第三方平台与 GitHub 仓库内均未检索到与本技能直接相关的具名用户评价或 issue 讨论。
9. 其他补充
仓库同时提供多种 AI 编码助手的安装路径（GitHub Copilot、Gemini CLI、Cursor、Antigravity IDE、OpenCode、AdaL CLI 等），并支持社区通过 issue 反馈内容缺口，官方据此持续修订；仓库当前不接受直接提交的技能改动 PR，需通过更新 Microsoft Learn 官方文档并申请重新抓取生效。
10. 安装使用方式
- 插件市场（推荐，Claude Code / Codex）：Claude Code 执行
/plugin marketplace add MicrosoftDocs/agent-skills，再/plugin install azure-agent-skills@microsoft-agent-skills；Codex 执行codex plugin marketplace add MicrosoftDocs/agent-skills，再从/plugins安装azure-agent-skills。 - 手动安装（全部助手）：
git clone https://github.com/MicrosoftDocs/agent-skills.git，将skills/azure-well-architected/文件夹复制到目标助手的技能目录（如 Claude Code 的.claude/skills/或~/.claude/skills/）。 - 安装后无需重启，agent 会在识别到 Azure 架构设计、评审或优化相关请求时自动加载本技能；技能运行时需要网络访问以抓取 Microsoft Learn 文档正文，若所在环境提供
mcp_microsoftdocs工具优先使用，否则回退到通用网页抓取。
11. 注意事项
- 正文索引依赖网络实时抓取官方文档正文，离线环境下只能看到索引本身，无法取回文档详情。
- 本技能是方法论与评审框架，不涉及具体服务的详细配置步骤；具体某个 Azure 服务的开发与故障排查建议配合同合集内对应的单产品技能一起使用。
- OpenClaw、Hermes Agent 的兼容性未获官方或第三方验证，使用前建议先手动测试 SKILL.md 是否能被正确识别加载。