Menü
BicepファイルのAzure リソースAPIバージョンを最新化。「APIバージョンを更新」「Bicepを最新化」「古いAPIバージョンをチェック」を求める場合に使用。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
azd 前提の IaC ルール。Bicep、azure.yaml、hooks をまたぐ repo 固有ルールを扱う。WHEN: infra/, .bicep, azure.yaml, hooks/, preprovision, postprovision, targetScope, main.parameters.json, enableDatabasePublicAccess
azd フック（pre/postprovision）の作成・編集と azure.yaml のフック設定。PostgreSQL Entra ID ユーザー作成の運用パターンを含む。WHEN: hooks/, preprovision, postprovision, azure.yaml, azd provision, azd up, azd deploy, pgaadauth, PostgreSQL user creation, hook script
Generate Azure architecture diagrams as editable .drawio files with official Azure icons. Outputs native draw.io XML (mxGraphModel format) that can be opened and edited in draw.io Desktop, VS Code draw.io extension, or draw.io Web.
Use this skill any time a .pptx file is involved — as input, output, or both. This includes creating, reading, editing, or modifying presentations. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx filename. This project uses the Microsoft Azure PowerPoint Template (Light).
Basierend auf der SOC-Berufsklassifikation
| name | bicep-api-version-updater |
| description | BicepファイルのAzure リソースAPIバージョンを最新化。「APIバージョンを更新」「Bicepを最新化」「古いAPIバージョンをチェック」を求める場合に使用。 |
BicepファイルのAzureリソースAPIバージョンを最新の安定版に更新する。
| Tool | 用途 |
|---|---|
az provider show | 最新GA版の取得（プライマリ） |
microsoft_docs_fetch | 最新GA版の取得（フォールバック：APIリファレンス参照） |
az bicep build | 構文検証・Linterチェック |
microsoft_docs_search | Breaking changes情報の検索 |
grep / view | Bicepファイルの解析 |
edit | APIバージョンの更新 |
Azure MCP Serverのbicepschemaとaz provider showでは、APIバージョンの取得元が異なる。
| ツール | データソース | 更新タイミング |
|---|---|---|
bicepschema | Bicep CLIに同梱された型定義（Azure/bicep-types-az） | Bicep CLIのリリース時 |
az provider show | Azureリソースプロバイダーへのリアルタイム問い合わせ | 常に最新 |
この設計上の差異により、bicepschemaが返す「最新版」がBicep CLIのバージョンに依存し、実際の最新GA版より古い場合がある。最新版の判定にはaz provider showを使用する。
参考:
bicepschemaの最新版選択ロジックはApiVersionSelector.csで実装されており、安定版を優先してソート・選択する仕様となっている。
az provider show はリソースプロバイダーに登録されているリソースタイプのみを返す。一部の子リソース（例: redisEnterprise/databases/accessPolicyAssignments）は登録されていない場合があり、その場合はAPIリファレンスを参照する必要がある。
更新フロー: Bicepファイル解析 → プレビュー版スキップ判定 → 最新GA版取得・比較 → Breaking Changes確認 → 仮適用 → Linter検証（警告時はロールバック）。各ステップの詳細は「実行手順」を参照。
| 理由 | 報告時の状態 | 追加アクション |
|---|---|---|
| プレビュー版使用中 | ⏭️ スキップ（プレビュー版） | GA移行可否の分析（必須） |
| 既に最新GA版 | ⏭️ スキップ（既に最新） | なし |
| GA版が存在しない | ⏭️ スキップ（GA版なし） | なし |
| Linter警告発生 | ⚠️ スキップ（BCP081警告） | なし |
注意: 以下のコマンド例は bash 前提。AI エージェントは
grepツールを使用すること。PowerShell 環境では対応するコマンドレットで代替すること。
grep -E "^resource\s+" infra/**/*.bicep
対象外:
resourceInput<'Type@version'>/resourceOutput<'Type@version'>構文（Bicep 0.34.1以降）は本スキルの対象外。これらは型定義用でありリソースをデプロイしないため、APIバージョン更新の優先度が異なる。
APIバージョンに -preview が含まれる場合は更新をスキップ。
理由: プレビューAPIを使用しているリソースは、GA版では提供されない機能を意図的に利用しているケースが多い。機械的にGA版へ置き換えると、必要な機能が失われるリスクがある。
ただし、以下の分析は必ず実施すること:
az provider show で最新GA版を取得注意: 以下のコマンド例は bash 前提。AI エージェントは
az provider showの結果を解析して同等の処理を行うこと。PowerShell 環境では対応するコマンドレットで代替すること。
az provider show -n Microsoft.Network \
--query "resourceTypes[?resourceType=='virtualNetworks'].apiVersions" \
-o tsv | tr '\t' '\n' | grep -iv preview | sort -r | head -1
注意:
az provider showの返すAPIバージョン一覧は降順ソートされているように見えるが、公式ドキュメントでは保証されていない。sort -rでクライアント側ソートを行い、確実に最新版を取得する。
複数リソースタイプの一括取得（bash 前提。AI エージェントはリソースタイプごとに az provider show を実行して同等の処理を行うこと）:
for provider_resource in \
"Microsoft.ManagedIdentity:userAssignedIdentities" \
"Microsoft.Network:virtualNetworks" \
"Microsoft.Authorization:roleAssignments"
do
provider="${provider_resource%%:*}"
resource="${provider_resource##*:}"
echo "=== $provider/$resource ==="
az provider show -n "$provider" \
--query "resourceTypes[?resourceType=='$resource'].apiVersions" \
-o tsv 2>/dev/null | tr '\t' '\n' | grep -iv preview | sort -r | head -1
done
az provider show で結果が空の場合（リソースタイプが登録されていない場合）、microsoft_docs_fetch でAPIリファレンスを参照:
URL形式:
https://learn.microsoft.com/en-us/azure/templates/{provider}/{resourceType}
例:
https://learn.microsoft.com/en-us/azure/templates/microsoft.cache/redisenterprise/databases/accesspolicyassignments
APIリファレンスページの上部に利用可能なAPIバージョン一覧が表示される。-preview を含まない最新バージョンを選択する。
microsoft_docs_search で破壊的変更を検索:
検索クエリ例:
- "Microsoft.ContainerService managedClusters API breaking changes"
参考リンク:
edit ツールで更新。この時点では「仮適用」。
az bicep build --file infra/main.bicep 2>&1
理由: Bicep型定義が未対応の場合、プロパティの検証ができず意図しないデプロイエラーのリスクがある。Bicep CLIが更新されれば自動的に対応されるため、待つ方が安全。
禁止: 最新GA版でBCP081警告が出た場合に、警告が出ない別のバージョンへ変更すること。元のバージョンに戻すのみ許可。
例外: #disable-next-line BCP081 で意図的に警告を抑制しているリソースは、更新を許可する（Linterが警告しない）。
更新確定。
以下のセクションを必ず含めること:
## APIバージョン更新サマリー
| ファイル | リソースタイプ | 更新前 | 更新後 | 状態 |
|----------|---------------|--------|--------|------|
| identity.bicep | Microsoft.ManagedIdentity/userAssignedIdentities | 2023-01-31 | 2024-11-30 | ✅ 更新 |
| aks.bicep | Microsoft.ContainerService/managedClusters | 2025-06-02-preview | - | ⏭️ スキップ（プレビュー版） |
| network.bicep | Microsoft.Network/virtualNetworks | 2024-07-01 | - | ⏭️ スキップ（既に最新） |
| network.bicep | Microsoft.Network/publicIPAddresses | 2024-07-01 | - | ⚠️ スキップ（BCP081警告） |
**BCP081警告について:** 最新GA版への更新を試みたが、Bicep型定義が未対応のため元のバージョンを維持した。Bicep CLI更新後に再実行で更新可能になる場合がある。
### スキップされたプレビュー版リソースの分析
| ファイル | リソースタイプ | 現在のバージョン | 最新GA版 | GA移行可否 |
|----------|---------------|-----------------|---------|-----------|
| aks.bicep | Microsoft.ContainerService/managedClusters | 2025-06-02-preview | 2025-10-01 | ❌ 不可 |
**GA版に存在しない属性:**
- `properties.networkProfile.advancedNetworking.security.advancedNetworkPolicies`
上記の属性はプレビュー専用のため、GA版への移行には機能の代替または削除が必要である。
すべての属性がGA版に存在する場合は「✅ 可能」と表示され、GA版への移行を検討できる。
az login）