184 Views
May 23, 26
スライド概要
2026年5月23日の『.NETラボ 勉強会 2026年5月』の登壇資料です。AI コーディングツールでAzure 開発を行う上で課題となる内容について、Microsoft 公式が提供しているAzure Skills Plugin とSpec Kit、GitHub Copilot を使い一人W 字モデルでAzure 開発を行って学んだ、気づいた内容をお話します。
外資系の会社でAzure Platform に関するコンサルタントをやっています。Azure を含むMicrosoft 製品、インフラ、CI/CD などを強みとしています。Microsoft MVP 2025 (Azure Compute Infrastructure、Azure Networking)
Microsoft のAzure Skills Plugin とSpec Kit を使い Azure の設計から構築、テスト、運用整備をGitHub Copilot にやってもらう 2026/05/23 .NETラボ 勉強会 2026年5月 Kazuki Yamabe
Agenda • Introduction • Azure におけるAI コーディングの課題 • Azure Skills Plugin 概要 • Azure Skills Plugin とSpec Kit を使った構成 • 成果物を見ながらの解説 • Azure Skills Plugin のTips & 注意事項 • Summary 2
Agenda • Introduction • Azure におけるAI コーディングの課題 • Azure Skills Plugin 概要 • Azure Skills Plugin とSpec Kit を使った構成 • 成果物を見ながらの解説 • Azure Skills Plugin のTips & 注意事項 • Summary 3
Who am I ? Name :Kazuki Yamabe Company:Avanade Japan K.K. Awards :Microsoft MVP 2025 ~ (Azure Compute Infrastructure、Azure Networking) ◼ Blog・SNS • Blog:https://www.kdkwakaba.com/ • X:@kdk_wakaba • Linkedin:kdk-wakaba 4
Notes • 本内容は2026年5月23日現在の内容です。今後のアップデートで内容が変更 される可能性もあります • 本内容は個人の見解であり、会社の方向性、戦略、意見ではありません 5
Today’s goal • Microsoft 提供のAzure Skills Plugin について、概要やどのようなSkills が あるかを理解している • GitHub Copilot とAzure Skills を使ったAzure のシステム開発のイメージ を掴めている 6
Agenda • Introduction • Azure におけるAI コーディングの課題 • Azure Skills Plugin 概要 • Azure Skills Plugin とSpec Kit を使った構成 • 成果物を見ながらの解説 • Azure Skills Plugin のTips & 注意事項 • Summary 7
Azure におけるAI コーディングの課題 8
Agenda • Introduction • Azure におけるAI コーディングの課題 • Azure Skills Plugin 概要 • Azure Skills Plugin とSpec Kit を使った構成 • 成果物を見ながらの解説 • Azure Skills Plugin のTips & 注意事項 • Summary 9
Azure Skills Plugin とは? Microsoft 提供のAzure 開発における設計、実装、運用、移行、改善に関するAI コーディン グ用のSkill 群 Azure 上における既 存Skill を素早く利 用でき、準備や学 習コストを削減 エンタープライズ 向けの設計からイ ンフラ基盤構築の 準備、既存システ ムの改善と幅広く サポート Azure のトラブル シューティングや コスト、クォー ターのように稼働 後の運用面も充実 Microsoft提供のた め品質、セキュリ ティ面の導入の容 易性 出典元:microsoft / azure-skills 10
Azure Skills Plugin にはどんなSkill が入っているか? (一例) Azure に関する設計、実装、テスト、運用、移行、コスト改善と幅広いSkill を完備 Skills 概要 azure-enterprise-infraplanner azure-prepare 企業開発で必要な「方針」「標準」「制約 」とWAF (Well-Architected Framework) を踏まえAzure 基盤の設計、改善を行うSkill。 azure-deploy 成果物をデプロイ手順 (azd up / azd deploy / terraform apply など) に落 とすSkill azure-validate デプロイ前の検証 (pre-flight) を標準化して、実装後の失敗や手戻りを減 少するSkill azure-diagnostics 障害時に必要なログ、メトリクスの収集やトラブルシューティングのよう にAzure の運用に関連するSkill azure-cost Azure のコスト管理について、過去の照会や将来の予測、無駄なコスト削 減のための最適化を行うSkill アプリをAzureに載せるため、Bicep/Terraform やDockerfile のような Azure 基盤を準備する 出典元:microsoft / azure-skills 11
なぜAzure Skills Plugin を使うのか? • 公式提供のSkills のため導入が容易 - Microsoft 提供のため、導入についても納得を得やすい - APM (Agent Package Manager) のようなツールとも相性が良い • ベストプラクティスのようにAzure に関する品質、セキュリティの精度を 担保しやすい - Instructions やSkills を作るとなると何かと知識、経験が必要 - 非推奨なものや怪しいものを使わないようなガードレールも担保される • Skill のメンテナンスにかかるコストの削減 - このあたりの管理負担を削減できるため、開発に集中できる - ただし、Skills のようなものを作る機会が減るため、学習機会を減らすリスクもあり 12
Azure Skills Plugin で設計、開発、テスト、運用整備はどう変わるのか? • 要件定義・設計工程において、Azure 推奨アーキテクチャやセキュリティ 設計をベースにした構成検討を迅速化 - エンタープライズ向け設計のSkill ではWAF (Well-Architected Framework) を参照 - 上流工程においても推奨内容を意識した検討が可能に • 実装工程ではAzure サービス連携や IaC (Bicep やTerraform ) 生成を Skill ベースで標準化し開発工数を削減 • テスト・運用工程においてログ解析・トラブルシューティング・監視・コ スト最適化と AI コーディングツールによる支援可能 • チーム全体で設計・実装・運用パターンを共通化でき、属人化防止と品質 平準化に貢献 13
Azure Skills Plugin ユースケース (一例) • PoC / 検証用のシステム、環境準備 - 既存Skill を使うため、PoC や検証準備と相性がよい - 各種準備を急ぎたい場合はAzure Developer CLI もSkill でサポートしている • システムに関する設計書、ドキュメントのドラフト作成 - 設計や運用に関するSkill を応用することでドキュメントの精度を上げやすい • IaC テンプレートのようなAzure 基盤の整備 - Bicep とTerraform 用のReference もあり、既存でmodule やparameter 分割もできる - ディレクトリ構成などは好みやお作法があるためInstructions あたりで制御する • 既存Azure 基盤の運用整備、改善 - 設計の見直しやコストといった部分でも役立つ 14
Agenda • Introduction • Azure におけるAI コーディングの課題 • Azure Skills Plugin 概要 • Azure Skills Plugin とSpec Kit を使った構成 • 成果物を見ながらの解説 • Azure Skills Plugin のTips & 注意事項 • Summary 15
Azure Skills Plugin とSpec Kit を使った構成 16
Spec Kit とは? GitHub が公開したAI がコードを実装するために必要な設計プロセスを作成するフレームワーク AI 開発において、 仕様の認識祖語や 抜け漏れ、プロン プトの精度による 品質のブレを削減 出典元:github / spec-kit スラッシュコマン ドによる各工程の 要件、技術スペッ クをAI とインタラ クティブに定義可 能 特定の環境に依存 しないため、新規、 既存環境でも導入 が容易 各種成果物を Markdown 形式で テキストとして生 成されるため、 バージョン管理が 用意 17
Azure Skills Plugin とSpec Kit を使った構成 ~ 環境構築 • Azure Skills Plugin の中身を見ると、各工程で必要なツール、MCP サー バーがあるため事前にインストールしておくを推奨 - Azure CLI やAzure Developer CLI、Bicep、Terraform など - Azure リソースを見たうえで各種操作をしたいのであればAzure MCP を事前にセット しておく - AKS のようなツールを扱うのであればkubectl も置いておくとよい - Azure Skills Plugin 以外も管理する場合はAPM で管理する • 今回はローカルPC を汚さないようにDev Container を採用 - ただしSkills を積み過ぎると初回起動時やリビルド時に時間がかかるため注意が必要 (Dev Container 初回時にAPM のインストールが遅くなる、など) 18
Azure Skills Plugin とSpec Kit を使った構成 ~ 設計・実装・テスト Azure Skills Plugin とGitHub Copilot、Spec Kit を使った一人W 字モデル で開発を行う 19
Azure Skills Plugin とSpec Kit を使った構成 ~ 運用整備 • W 字モデルの各工程でテストを作成すると共に運用設計、その時点のド キュメント作成を実施する • AI コーディングツールを前提とするのであれば、各工程で仕様が変わった 場合の変更も取り込みやすい - 突発的な仕様変更でもクライアント、AI とインタラクティブに変えやすい - ただし変更管理による各種調整は人間でどうにかする必要がある • Azure Skills Plugin とAzure MCP に加え、AI が設計書やコードを見れる ため現在のコードに必要な運用部分を洗い出しやすい 20
Agenda • Introduction • Azure におけるAI コーディングの課題 • Azure Skills Plugin 概要 • Azure Skills Plugin とSpec Kit を使った構成 • 成果物を見ながらの解説 • Azure Skills Plugin のTips & 注意事項 • Summary 21
どんなものを作ってみたか成果物を見ながら解説 今回はサンプルアプリケーションとして、Azure とC# を使い2000年代後半 によくあったいにしえの社内ポータルを作成したものを説明します。 ※ イベントに合わせてC# を使っていますが、C# 初心者なので変なところがあったときはご了承ください 22
Azure Skills Plugin を使わなかったらどうなるか? • Azure Skills を使わずに試してみたところ、Azure 構成の変化が見られた - 一例としてデータ層ではAzure Skills ありはSQL Database のようなデータベースを提 案したが、Skills なしのケースはBlob ストレージで対応する、など - IaC についてもmodule 分割は行わずそのまままとめてしまう - 標準的な、と言いつつレビューさせてみると沿っていなかったり… • 運用手順書あたりはトラブルシューティングの部分を参照するかどうかの 差異も見られた - 運用手順書のテストあたりはAzure リソースを見たうえで調査を行うか、などAzure MCP サーバーあたりがいい感じに働く • 大まかな憲章、ルールは同じプロンプトを使う限り大幅な変化は見られな かった 23
Agenda • Introduction • Azure におけるAI コーディングの課題 • Azure Skills Plugin 概要 • Azure Skills Plugin とSpec Kit を使った構成 • 成果物を見ながらの解説 • Azure Skills Plugin のTips & 注意事項 • Summary 24
Azure Skills Plugin のTips ① • Azure Skills Plugin でAzure 寄りにしてくれるが、ワンショット作り切る のは難しい。各工程を少しずつ対話しながら作成すると品質向上に繋がる - ある程度ベストプラクティスな形には寄せてくれるが、実際に作ってみると足りない部 分があったり、成果物のコードがエラーになってたりする - トラブルシューティングに関するSkills もあるため、実装やテスト時のエラー修正もい い感じに対応してくれる • アーキテクチャーやコスト改善に関するSkill もあるため、たたき台を作成 してそこから改善してもらう方法も使える - 初期開発では開発スピードを重視し、ある程度できてきたところで改善用のSkill で追 加開発を検討するのも一つ 25
Azure Skills Plugin のTips ② • 基本的な開発工程について、各工程をAI コーディングツールと共に伴走す ることで開発の流れについて理解が深まる - 理解の浅い工程についてAI ツールやドキュメント類を読んで理解を深めていくと、ど んなことをプロンプトに入力していけばいいか、なども見えてくる - どういうドキュメントが必要なのか、運用するには何が必要か、を考えていくと実業務 でも役立つ • Microsoft で品質を担保しているため、Skill の中身やどんなことを Reference としているかを読んでみるとSkill 作成に役立つ - 中身を読んでみると、1つ1つのSkill にどのような内容を持たせているかの学びになる ため、自作Skill の準備に役立てていく 26
Azure Skills Plugin を使った開発の注意事項 • Azure 関連Skill は他にもあるが、色々なものを複数入れると逆に判断がブ レるため注意 - 複数のAzure 関連Skill を入れる場合、重複すると判断がブレやすい - 逆に足りない部分やカスタマイズするならInstructions やSkills を追加する - まとめて導入でも悪くないが、必要なSkill だけ精査して入れるのも一つの手段 • AI コーディングツールで素早く進めるため、人間の承認、判断が圧倒的に 多くなる - 曖昧な指示が多くなるとレビューやテストをきちんと実施してないこともあるため成果 物は必ず確認する - 1つのモデルでやると偏ることもあるため、レビューは他のモデルにやらせるのも良い - テストに関してはテスト内容のエビデンスを出力させるのも一つ - 成果物に対し公式ドキュメントや実際に手を動かす、動作させたりするのは忘れずに 27
Agenda • Introduction • Azure におけるAI コーディングの課題 • Azure Skills Plugin 概要 • Azure Skills Plugin とSpec Kit を使った構成 • 成果物を見ながらの解説 • Azure Skills Plugin のTips & 注意事項 • Summary 28
Summary • Azure Skills Plugin は開発、インフラ基盤構築における設計、実装、運用、 移行、改善に関するSkills を備えたAI コーディング用のSkills • AI コーディングツールでも事前にSkills を読み込んでおくことで、Spec Kit のよ うな仕様検討時にSkills の文脈を読んで設計、準備、運用観点を取り込める • PoC や小規模の開発ではAzure Skills Plugin 開発でもよいが、実際の企業で使う にはAzure Skills Plugin をベースに自社のルール (お作法) を組み立てていくのが 良い 29
Appendix • Building with Azure Skills • Diving Into Spec-Driven Development With GitHub Spec Kit • GitHub Spec Kit を使用してスペック駆動開発を実装する • Agent Package Manager 30