azure-app-onboard

Azure App Onboard

⛔ 每个仓库都必须走完整流程（步骤 1–10）。没有例外。 不要跳过步骤、拒绝执行，也不要根据你识别出的内容提前结束。请按顺序遵循下方的工作流表——执行每一步之前，先阅读其参考资料。

快速参考

属性	值
最适合	知道要构建什么，但不知道该使用哪些 Azure 服务的开发者
输入	业务构想或现有代码库、预算／规模偏好（可选）
输出	架构方案、成本估算、IaC 文件、已部署的 Azure 资源
阶段	发现 → 架构设计 → 搭建 → 部署（自包含，不调用外部技能）

何时使用此技能

• 部署现有代码，但不知道该使用哪些 Azure 服务
• 检查现有代码是否已准备好部署到 Azure
• 将现有应用迁移到 Azure，无需重写或只需少量改动
• 在确定基础设施方案之前获取成本估算
• 了解架构决策及被否决的替代方案
• 获取有关 Azure 架构或服务选择的问题的答案（例如，“我应该使用什么数据库？”）
• 无需相关经验即可获得 Azure 入门指导

何时不使用

场景	改用
运行 azd up 或执行现有部署	azure-deploy
优化现有 Azure 支出	可选 azure-cost 插件中的 cost-optimization
为已知架构生成 Bicep/Terraform	azure-prepare
验证基础设施或运行部署前检查	azure-validate
排查正在运行的 Azure 部署问题	azure-diagnostics
直接部署或管理 AKS/Kubernetes	azure-kubernetes
查找或列出已有的 Azure 资源	azure-resource-lookup

如果无法使用 cost-optimization，请说明它由可选的 azure-cost 插件提供，并引导用户使用其客户端支持的插件安装流程；不要暗示交接已完成。

流程规则

⛔ 每次 AppOnboard 会话开始时，都必须阅读 references/pipeline-rules.md。 其中包含审批关卡、阶段生命周期、会话产物、按原样部署和安全基线规则。

工作流

⛔ 部署恢复： 在部署门禁获批后，或执行任何 az deployment/az webapp deploy/az acr build 之前——如果你尚未阅读 deploy/SKILL.md，请先阅读 .copilot-azure/sessions/{id}/deploy-checklist.md，再阅读 deploy/SKILL.md。⛔ 绝 NEVER 调用 {"skill": "azure-deploy"}——这是用于不同工作流的另一个技能。

⛔ 脚手架生成后的转换（强制）： 写入 scaffold-manifest.json 后，你的下一个操作必须立即是步骤 8（部署审批门禁）——不能是总结报告、不能是“以下是生成的文件”消息，也不能是完成信号。确认 context.json 中包含 completedPhases: [...,"scaffold"] 和 currentPhase: "deploy"（如果脚手架子 Agent 没有更新，请自行更新）。如果相关内容已从上下文中移除（脚手架阶段加载的参考资料较多），请重新阅读 approval-gates.md § Deploy Gate，然后准确呈现提示：“🚀 准备好部署了吗？（Yes / Run manually / Edit plan / Cancel）”。此门禁必须是你回复中的最后内容——等待用户回复。

#	步骤	操作	参考资料
1	会话检查 + Azure 登录	创建/恢复会话，验证 Azure CLI 身份验证，确定订阅和用户身份	⛔ 你必须阅读 session-protocol.md
2	范围初步判断	检查 azd 标记，进行初步判断。空工作区或仅有代码（无基础设施）→ 直接进入步骤 3。	⛔ 阅读 intent-gathering.md § 范围初步判断
3	先决条件扫描	⛔ 如果 completedPhases 包含 "prereq"，则跳过。否则：调用 {"skill": "azure-app-onboard-prereq"}。写入 prereq-output.json，更新 context.json。以下情况必须停止： overallHealth: "blocked" 或设置了 routeToSkill。
4	收集意图	呈现先决条件检查结果，确认技术栈和 Azure 服务，并询问剩余问题。	⛔ 阅读 intent-gathering.md § 先决条件检查返回后
5	规划架构	写入 prepare-plan.json。	⛔ 你必须阅读 prepare/SKILL.md
6	脚手架审批门禁	在生成任何文件之前，向用户展示计划并征求批准。	⛔ 阅读 approval-gates.md § 脚手架门禁
7	生成脚手架	生成 IaC，进行自查。写入 scaffold-manifest.json。更新 context.json。	⛔ 你必须阅读 scaffold/SKILL.md
8	部署审批门禁	展示验证摘要。⛔ 获批后：先阅读 deploy-checklist.md → deploy/SKILL.md。绝不调用 {"skill": "azure-deploy"}。	⛔ 阅读 approval-gates.md § 部署门禁
9	部署	执行 IaC，进行运行状况检查。写入 deploy-result.json。	⛔ 你必须阅读 deploy/SKILL.md
10	交接	提供部署身份信息、清理命令和后续步骤。	⛔ 你必须阅读 handoff-protocol.md

错误处理

错误	处理方式
阶段失败	停止，报告阶段和错误。由用户决定：重试、跳过或中止。
MCP 服务不可用	跳过受影响的检查，在 costEstimate.assumptions[] 和每个审批门禁中添加免责声明。
缺少 RBAC	报告所需角色和 az role assignment 命令。

共享参考资料： MCP 工具（跨阶段工具参数） | IaC 资源（用于故障排除的 Azure 资源文档）