| name | azure-advisor-report |
| description | Generate Azure environment monthly report (Markdown + PowerPoint) from Azure Advisor and Cost Management API. Use when creating Advisor recommendations report, cost trend analysis, or security/reliability assessment for a customer subscription. Triggers on 'Advisor report', 'Azure monthly report', 'subscription report', 'Azure環境レポート', '簡易月次レポート'. |
| argument-hint | Subscription ID(s) and Tenant ID(s), optionally target month (e.g., 2026-04) |
| user-invocable | true |
| license | CC BY-NC-SA 4.0 |
| metadata | {"author":"yamapan (https://github.com/aktsmm)"} |
Azure Advisor 簡易月次レポート生成
Azure Advisor 推奨事項・コスト推移を分析し、顧客向けの簡易月次レポート（Markdown + PowerPoint）を生成するスキル。
When to Use
- 顧客の Azure 環境の Advisor 推奨事項をレポートにまとめたいとき
- コスト推移・サービス別内訳を可視化したいとき
- セキュリティ・信頼性の推奨事項を優先順位付きで報告したいとき
When NOT to Use
- Azure 環境の構築・変更作業（このスキルは読み取り専用のレポート生成のみ）
- 社内用の詳細分析（このスキルは顧客向けレポートに特化）
入力パラメータ
| パラメータ | 必須 | 説明 |
|---|
| Subscription ID | ✅ | 対象サブスクリプション（複数可） |
| Tenant ID | ✅ | 各サブスクリプションのテナント ID |
| 対象月 | ❌ | YYYY-MM 形式。省略時は当月 |
| 顧客名 | ❌ | レポートタイトルに使用。省略時は「Azure 環境」 |
ガードレール
レポート品質ルール を適用すること。
手順
Phase 1: データ取得
データ取得手順 を参照。
Phase 2: Markdown レポート生成
Markdown テンプレート をベースに生成。
出力先: 任意のパス（例: {customer}/monthly-report_{YYYYMMDD}.md）
Phase 3: PowerPoint レポート生成
PPTX 生成スクリプト を使用。
複数サブスクリプションの場合は Subscription ID ごとに章を分ける。重要な推奨事項は個別ページを作り、英語原文、日本語訳、リスク、推奨アクション、メリット / デメリット、是正手順、Microsoft Learn URL を入れる。
Executive Summary と推奨アクションでは、必要に応じて WAF / CAF の観点も添える。
py -3 generate_pptx.py --title "顧客名" --data-dir ./output --output report.pptx
Phase 4: 検証
- PPTX を開いて表示確認（要素の重なりがないか）
- 全コンテンツスライドに speaker notes があるか確認
- 表・本文・参照 URL が 14pt 未満になっていないか確認
- 数値の検算（コスト合計、変動率の基準月明示）
- 英語推奨事項に日本語訳があり、「日本語訳未登録」のような placeholder が残っていないか確認
- 社内情報・社内用語が含まれていないか最終チェック
品質基準（Lessons Learned）
レポート構造の最低要件
初回作成時に以下のセクションを この順序で 含めること。不足・順序違いは手戻りが発生する:
- 📋 対象サブスクリプション（ID・テナント・用途推定）
- 📈 コスト推移・分析（月別テーブル + 前月比% + サービス別月次推移 Top5-7 + 変動インサイト）
- 🔴 エグゼクティブサマリー（優先度 🔴🟡⚪ 付き重要ポイント）
- 💰 コスト最適化（Cost）（Advisor Cost 件数 + 推定削減ポテンシャル + 代表リソース名）
- 🔒 セキュリティ（Security）（Advisor Security 件数 + 重要度分析）
- ⚡ 信頼性・可用性（Reliability）（Advisor Reliability 件数 + Zone冗長/Backup 改善提案）
- ⚙️ オペレーショナルエクセレンス（Advisor OpEx 件数。必ず取得すること。「未取得」「次回予定」は禁止。結果が0件なら「0件（推奨なし）」と記載）
- 📊 全体サマリー（サブスク × カテゴリ一覧 + グループ別集計）
- 🎯 推奨アクション（優先順）（優先度付き・具体的・actionable）
- 📎 参考リンク（Azure Portal Advisor 直リンク）
データ処理の注意事項
PPTX 生成のルール
汎用 PPTX 衛生ルール（スライドノート必須、フォント下限、テーブル列幅、.tmp.pptx で生成して PermissionError 回避、ヘルパー関数の扱いなど）は powerpoint-automation skill を SSOT とする。本レポート固有のルールのみ以下に残す。
- 既存フル構成の継承: 既存顧客に過去の完成度が高い PPTX / generator がある場合、別の薄い新規 deck を作らず、既存のフル構成へ最新データを差し替える。比較軸・カテゴリ別章・speaker notes が落ちると前回品質より劣化するため
- データソース取得日必須: 表紙または補足で各データソースの取得日を明示する（Cost=JPY / 顧客ダッシュボード=USD のように通貨も併記）
- スライドデータは新規記述: テンプレート流用はヘルパー関数のみ。スライドデータ部分のコピー＆置換は旧顧客データが残存するため禁止
Advisor データ取得のルール
- 全 4 カテゴリを必ず取得: Cost, Security, HighAvailability, OperationalExcellence
- 「未取得」「次回予定」は禁止。結果が 0 件なら 「0件（推奨なし）」 と記載
