1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Azure Web Application Firewall Skill（azure-web-application-firewall） |
| 作者/维护者 | Microsoft（MicrosoftDocs/Agent-Skills 仓库，微软官方文档团队维护） |
| 来源链接 | https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-web-application-firewall |
| 许可证 | 文档内容 CC BY 4.0、代码部分 MIT（数据来源：仓库 LICENSE / LICENSE-CODE 文件） |
| GitHub Stars | 715（数据来源：GitHub API；该数字属整个 Agent-Skills 合集仓库，不代表本技能自身热度） |
| Forks | 116（同上，合集整体数据） |
| 最新版本 | 仓库不发布正式 release，内容随 Microsoft Learn 文档源自动化再生成；本技能文件最近一次生成时间为 2026-08-16（数据来源：SKILL.md 内 generated_at 元数据，对应 commit 历史显示按周级节奏自动更新） |
| 安装方式 | Claude Code / Codex 可通过官方插件市场一键安装整套技能集，或手动复制 skills/azure-web-application-firewall/ 目录到本地 agent 的 skills 目录 |
2. 功能介绍与亮点
这是微软官方把 Azure Web Application Firewall（WAF，覆盖 Front Door 与 Application Gateway 两种承载形态）的 Microsoft Learn 文档预编译成的结构化参考技能，正文按行号索引组织成八大主题、含 62 条官方文档直链：
- 故障排查与限额参考独立成章：Front Door WAF 常见行为异常、规则误判、请求体/文件上传大小限制、规则引擎在高负载下的行为，均有专门直链定位。
- 配置板块覆盖面最广：CAPTCHA 挑战、地理过滤（geo-filtering）、机器人防护、自定义与托管规则、限流策略、日志敏感数据脱敏、按 CLI/PowerShell/门户三种方式配置，Front Door 与 Application Gateway 两条路径均有对应操作页。
- 安全治理板块：IP 限制规则、DRS（默认规则集）规则组说明、排除项/例外列表配置、用 Azure Policy 强制实施 WAF 合规基线。
- 与安全运营工具集成：WAF 日志接入 Microsoft Sentinel 实现自动化事件响应、用 Security Copilot 调查 WAF 事件、保护 APIM 与 Azure OpenAI 端点。
- 基础设施即代码部署：Bicep、ARM 模板、Terraform 三种方式创建与升级 WAF v2 策略均有直链示例。
- 无本地代码执行：技能目录内仅含一份 Markdown 文件，不含任何脚本或可执行文件。
亮点：微软官方出品、内容完全溯源到 learn.microsoft.com 权威文档；SKILL.md 自身在 description 中明确划清与 azure-application-gateway、azure-front-door、azure-firewall、azure-ddos-protection 等姊妹技能的边界，避免误用；官方仓库把它归入自维护的 “Security & Compliance Bundle” 精选包。
3. 适用场景
固定分类：安全与合规。
适用于需要为面向公网的 Web 应用配置攻击防护策略的云安全工程师与运维人员——无论是为 Front Door 或 Application Gateway 配置 WAF 规则、限流策略与机器人/地理过滤，排查规则误判导致的请求被拦截问题，把 WAF 日志接入 Sentinel 做威胁狩猎，还是用 Bicep/ARM/Terraform 把 WAF 策略纳入基础设施即代码流水线，都可以让 agent 按需调取该技能获取官方权威指导。
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库提供
.claude-plugin/插件清单，/plugin marketplace add MicrosoftDocs/agent-skills后执行/plugin install azure-agent-skills@microsoft-agent-skills即可安装整套技能（含本技能）；官方仓库 README 明确将 Claude Code 列为兼容的 AI 编码助手之一。 - Codex：原生支持——仓库同时提供 Codex CLI 的 plugin 清单与 marketplace catalog，
codex plugin marketplace add MicrosoftDocs/agent-skills后从/plugins安装；官方 README 明确将 Codex CLI 列入声明兼容名单。 - OpenClaw：需适配——OpenClaw 读取与 Claude Code 相同的 SKILL.md 标准，本技能不含任何 Claude 专属依赖，理论上把
skills/azure-web-application-firewall/目录复制进 OpenClaw 的 skills 路径即可使用；但官方兼容名单与仓库 README 均未列出该 agent 的专门安装说明，需手动完成目录复制。 - Hermes Agent：需适配——Hermes 官方技能系统原生支持 SKILL.md 标准（frontmatter 含
name/description必填，其余为可选字段），理论上可直接放入本地 skills 目录使用；但官方兼容名单与仓库 README 均未将 Hermes 列入声明兼容的 agent 名单，需手动完成目录复制。
5. 推荐理由
WAF 规则配置的坑很少是“不知道该开哪个开关”，而是分散在几十篇文档里的细节：Front Door 与 Application Gateway 两条技术路径的规则语法不完全一致、CAPTCHA/机器人防护/地理过滤各自的配置入口不同、规则误判导致正常请求被拦截时该看哪份排查指南、日志里的敏感数据该怎么脱敏。这个技能把 Microsoft Learn 里分散的 WAF 知识预编译成带行号的结构化索引，八大主题全部覆盖，62 条官方文档直链，直接对应规则调优、限流防护、日志排查、IaC 部署等高频云安全配置场景。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 MicrosoftDocs 系微软官方文档团队、内容对象为微软自有产品 Azure WAF，属第一方官方出品；所属 Agent-Skills 合集仓库 715 星不计入单个子技能；专门检索未找到针对 azure-web-application-firewall 这一具体技能包装形式的独立第三方评价 |
| 可用性 | 8 | 内容结构完整，八大主题均有实质内容并带行号索引与官方文档直链，正文 127 行、含 62 条文档直链，覆盖故障排查、配置、安全治理、集成、部署各方面参考资料，是同代 202 个技能中类目覆盖较广的一档；SKILL.md 于 2026-08-16 最近一次生成，处于活跃更新节奏；插件市场一键安装或手动复制单文件均简便，无付费依赖；运行时需联网抓取 Learn 文档内容，非完全自包含 |
| 安全性 | 9 | 官方出品、完全开源可审计（文档 CC BY 4.0、代码 MIT）；技能目录内无任何脚本或可执行文件，仅一份 Markdown；全文逐段检查未发现任何要求 agent 顺带提及第三方品牌或执行任务外操作的可疑指令；运行时唯一的“外联”是拉取 learn.microsoft.com 官方文档页面，目标完全透明；技能本身只提供配置指导，不代 agent 存储或操作实际凭据 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 无——技能目录内不含任何脚本或可执行文件 |
| ② 运行时联网外发 | 需要网络访问以拉取文档内容，目标固定为 learn.microsoft.com 官方页面，外联目标透明 |
| ③ API key/凭据 | 不涉及，技能本身不需要任何凭据，也不代用户存储或传输实际密钥 |
| ④ 可疑指令/注入迹象 | 未发现——全文逐段核查均为文档索引与链接列表 |
| ⑤ 作者/组织信誉 | 微软官方文档组织 MicrosoftDocs，无造假迹象；技能目录本身不含任何可执行代码 |
| ⑥ License | 文档 CC BY 4.0、代码 MIT，明确 |
| ⑦ 最近维护时间 | 本技能文件按周级节奏自动化再生成，最近一次生成距今约 1 周，处于持续维护的合集仓库中 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| azure-defender-for-cloud-MicrosoftDocs-Agent-Skills（同合集内） | 同一仓库、同一自动化流水线生成的参考技能，覆盖 Azure 及跨云资源的持续安全态势管理与威胁防护 | 面向的是“整体云环境的安全态势打分与告警”（CSPM 视角）；本技能面向的是“某一层防线（Web 边缘流量）该怎么配置规则”，两者可配合使用：Defender 发现风险、WAF 落地拦截 |
| azure-sentinel-MicrosoftDocs-Agent-Skills（同合集内） | SIEM/SOAR 运营参考技能，覆盖威胁狩猎、事件响应自动化 | 面向的是“安全事件发生后怎么关联分析与响应”；本技能面向的是“攻击流量到达前怎么在边缘拦截”，WAF 日志正是 Sentinel 分析的数据源之一 |
| claude-code-owasp | 纯只读安全评审技能，对照 OWASP Agentic AI Security 标准审查业务代码 | 审查的是“应用代码本身有没有漏洞”（代码层）；本技能配置的是“网络边缘该怎么过滤恶意流量”（网络层），两者防护的是攻击链的不同环节，不互相替代 |
8. 用户评价
该技能所属 SKILL.md 索引本身在第三方渠道尚无具名用户评价；其索引的底层服务 Azure Web Application Firewall 作为 Azure 平台的常用边缘防护组件，在第三方技术社区有大量围绕其规则调优与故障排查的讨论，但均针对该功能本身而非这一具体的技能包装形式。
9. 其他补充
该仓库整体按 Compute、集成、数据与分析、AI/ML、安全与身份、网络、基础设施、管理、专项等类别组织了 202 个同结构技能，覆盖 Azure 几乎全部主流服务。官方额外维护了一份 docs/BUNDLES.md 精选包清单，本技能被收录进其中的 “Security & Compliance Bundle”，与身份、访问控制、安全服务类技能归为一组打包推荐。
10. 安装使用方式
- 插件市场（Claude Code）：
/plugin marketplace add MicrosoftDocs/agent-skills，再执行/plugin install azure-agent-skills@microsoft-agent-skills，随后运行/reload-plugins或重启生效，将安装该仓库全部技能。 - 插件市场（Codex）：
codex plugin marketplace add MicrosoftDocs/agent-skills，再从/plugins浏览器中选择安装azure-agent-skills。 - 手动安装（适用于 OpenClaw / Hermes Agent 等其他 agent）：克隆仓库后，将
skills/azure-web-application-firewall/目录复制到本地 agent 的 skills 路径（如.claude/skills/、.hermes/skills/等，具体路径因 agent 而异）。 - 使用前无需额外认证或 API key；技能触发后会在需要时通过
mcp_microsoftdocs:microsoft_docs_fetch（如已安装 Microsoft Docs MCP）或普通网页抓取工具拉取具体文档内容。
11. 注意事项
- 技能内容为预编译的文档索引而非实时文档镜像，若
generated_at元数据显示的生成时间超过 3 个月，SKILL.md 会提示 agent 建议用户拉取仓库最新版本。 - 默认安装方式是整套插件（202 个技能一次性安装），若只想安装
azure-web-application-firewall单个技能，需改用手动复制目录的方式。 - 跨 Agent 兼容性仅确认 Claude Code / Codex 原生支持；OpenClaw、Hermes Agent 均需手动复制目录完成适配。
- 技能明确声明不适用于 Azure Application Gateway 通用配置、Azure Front Door 通用配置、Azure Firewall、Azure DDoS Protection 相关任务，误用场景应改用仓库内对应的姊妹技能。
- 技能本身不执行任何本地代码，但依赖网络访问拉取 Microsoft Learn 页面，离线环境下只能使用 SKILL.md 内置的分类目录与直链列表，无法获取链接指向的具体文档正文。