azure-enterprise-infra-planner

用途

Azure Enterprise Infra Planner 用于从工作负载或架构描述出发，规划和预配企业级 Azure 基础设施。适用于以下场景：

• 根据工作负载或架构描述规划企业 Azure 基础设施
• 设计登陆区、中心辐射（hub-spoke）网络或多区域拓扑
• 设计网络基础设施：VNet、子网、防火墙、专用终结点、VPN 网关
• 规划身份、RBAC 与合规驱动的基础设施
• 为订阅范围或多资源组部署生成 Bicep 或 Terraform
• 规划灾难恢复、故障转移或跨区域高可用拓扑

主要能力与工作方式

该技能运行一个 7 阶段、带门控的流水线。输入先经过分类，分为两种流程：

• Greenfield（全新）：仅有新需求，直接按阶段执行。
• Referenced（棕地/引用已有）：用户提供了已存在的内容（在线资源／资源组／订阅、IaC 或基础设施计划，或需求文档）。同样的阶段会执行，但会额外走 referenced-workload.md：对已有资源进行清点并引用（绝不重建），将新工作负载接入其中，且 Phase 7 仅做增量部署，不修改或销毁被引用的资源。

7 个阶段依次为：Phase 1 提取洞察、Phase 2 研究最佳实践、Phase 3 研究资源、Phase 4 生成计划、Phase 5 验证（需用户批准，未批准则退回 Phase 4）、Phase 6 生成 IaC、Phase 7 部署。每个阶段只有通过其门控后才继续推进。

Phase 5 需要用户明确批准；Phase 6 是强化的自验证门控——生成的 IaC 必须默认安全、通过本地校验（az bicep build / terraform validate）且零错误、通过 checkov 安全扫描且无未解决的高危/严重发现，并且技能必须展示命令输出并在推进前发出完成自检；Phase 7 需要明确的、已确认风险的部署确认。

使用方式

技能起始处要求遵循 workflow.md 中的分步说明执行 7 个阶段的规划与预配。

MCP 工具：

• insights_get：获取用户现有 Azure 环境的洞察，以指导规划决策
• get_azure_bestpractices_get：用于代码生成、运维和部署的 Azure 最佳实践
• wellarchitectedframework_serviceguide_get：特定 Azure 服务的 WAF 服务指南
• microsoft_docs_search：在 Microsoft Learn 中搜索相关文档片段
• microsoft_docs_fetch：按 URL 获取 Microsoft Learn 页面的完整内容
• bicepschema_get：任意 Azure 资源类型的 Bicep 架构定义（最新 API 版本）

CLI 命令：az deployment group create、az bicep build、az resource list、terraform init、terraform plan、terraform validate、terraform apply、checkov。

输出 schema：schema.md。

关键参考：workflow.md、waf-checklist.md、resources/、constraints/。

产物（写入 <project-root>/ 下）：.azure/insights.json（Phase 1）、.azure/infrastructure-plan.json（Phase 4，状态为 draft→approved→deployed），以及 infra/main.bicep + infra/modules/* 或 infra/main.tf + infra/modules/**（Phase 6）。

适用场景

面向云架构师和平台工程师，适合企业级 Azure 基础设施的规划、架构设计与 IaC 生成，包括网络拓扑设计、身份与合规规划、高可用与灾备设计，以及在已有环境中增量接入新工作负载的场景。

限制与错误处理

• MCP 工具错误或不可用：工具调用超时、连接错误或工具不存在——重试一次；若仍未解决，回退到参考文件并通知用户。
• 缺少计划批准：meta.status 不为 approved——停止并提示用户批准，之后才能生成 IaC 或部署。
• IaC 校验失败：az bicep build 或 terraform validate 返回错误——修复生成的代码并重新校验；若仍未解决，通知用户。
• 配对约束违反：SKU 或资源组合不兼容——在进入 IaC 生成之前先在计划中修复。
• 未找到基础设施计划或 IaC 文件：文件写到了错误位置或未创建——确认文件存在于 <project-root>/.azure/ 和 <project-root>/infra/；若缺失，严格按照 workflow.md 重新创建文件。

关于该技能的收费、价格或平台等具体信息，资料中暂未提供。