azure-deploy skill 是什麼、怎麼安裝使用：讓智能體執行 azd up / terraform apply，並帶上部署前檢查

本文根據 microsoft/azure-skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 55.0 萬次；所在倉庫 microsoft/azure-skills 在 GitHub 約 1555 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

這是「準備 → 驗證 → 部署」三段流程的最後一棒。description：為已經準備好的應用執行 Azure 部署——項目裏已有 .azure/deployment-plan.md 和基礎設施文件；運行 azd up、azd deploy、terraform apply 和 az deployment，內置錯誤恢復。用戶說「創建並部署」「新建應用」時不該用它，那是 azure-prepare 的事。

SKILL.md 開頭是一段強制的前置檢查：計劃文件必須存在，並且狀態必須是 Validated。它特別禁止智能體自己把狀態改成已驗證——只有 azure-validate 在真正跑過檢查後才能寫這個狀態，跳過驗證「只會導致部署失敗」。

步驟表共十步：

1. 讀計劃，確認狀態和驗證證據；
2. 完成部署前檢查清單；
3. 按計劃裏的配方類型加載對應做法（azd、Azure CLI 等各有一套）；
4. 權限健康檢查——例如容器應用通過託管身份拉取鏡像時，先預配資源，確認拉取鏡像的角色已經生效；
5. 執行部署；
6. 部署後配置（如數據庫的託管身份、數據遷移）；
7. 出錯時查該配方的錯誤對照表；
8. 確認部署完成、端點可訪問；
9. 到 Azure 上查詢實際分配的角色是否正確夠用；
10. 把訪問地址以完整的 https:// 連結報告給你。

規則裏還有一條：破壞性操作必須先徵得你的同意。

怎麼安裝

azure-deploy 隨微軟的 Azure 插件一起安裝，插件同時配置好 Azure MCP Server。Claude Code 裏（命令來自倉庫 README）：

text
/plugin marketplace add microsoft/azure-skills
/plugin install azure@azure-skills

Gemini CLI 用 gemini extensions install https://github.com/microsoft/azure-skills，Codex 用 codex plugin marketplace add microsoft/azure-skills；GitHub Copilot 的裝法見 README。真正操作雲資源前，本機要裝好 Azure CLI（az）並登入，部署類場景還要 Azure Developer CLI（azd）。

倉庫整體介紹和其他安裝方式，詳見本站《azure-skills 是什麼、怎麼安裝：微軟官方 Azure Skills 插件（技能 + Azure MCP Server，讓智能體真正操作 Azure）》。

怎麼用

在跑過 prepare 和 validate 的項目裏：

• 「執行部署」「run azd up」——觸發詞包括 push to production、go live、ship it。
• 「代碼改了，只更新應用，不動基礎設施」——對應 azd deploy。
• 「部署失敗了，按錯誤訊息排查後重試」。

如果它發現沒有計劃文件或狀態不對，會停下來讓你先走前兩步，這是設計如此。

適合誰 / 侷限

適合希望部署過程有固定檢查點的團隊，而不是讓智能體憑印象敲命令。侷限：它只負責執行，應用和基礎設施的設計問題要回到 prepare 階段解決；自動的錯誤恢復只覆蓋參考文件裏列出的常見情況；生產環境是否允許智能體直接發佈，應當由團隊自己的發佈流程決定，穩妥的做法是先用於開發和測試環境。

注意事項

• 許可：MIT。
• 會真實創建和修改雲資源：這一步開始產生 Azure 費用，執行前確認訂閱、區域和資源組；不再需要的環境記得清理。
• 使用本機的 az / azd 登入身份，權限等同於你本人；建議用權限受限的帳號或服務主體，而不是訂閱所有者。
• 部署可能包含數據庫遷移等不易回退的操作，重要環境先做備份。