AIアシスタントにソリューションアーキテクト並みにAzureを理解させる方法
最近、私はこう考えるようになりました：GitHub CopilotやClaude Codeはほとんどあらゆることを知っているのに、クラウド固有の知識になると途端にハルシネーションが始まる。ニューラルネットワークは、3年前に outdated になったAzure Functionsの設定を教えてくれたり、組み込みのサブスクリプション制限に違反するアーキテクチャを提案したりすることがある。問題は、モデルの知識がトレーニング時点のものですべて止まっていることで、Microsoft Learnのドキュメントは日々変化していることです。
MicrosoftのAgent-Skillsリポジトリを見つけました。アイデアはシンプルですが、信じられないほど便利です：AIにドキュメントを「記憶」させる代わりに、構造化されたスキルを食べさせます。これはプロジェクトに直接存在するエージェント用のリファレンスガイドのようなもので、「Azureを操作する際はここを見て、これらのパターンを使用し、これらの制限を忘れないでください」と指示します。
要するに何なのか
このプロジェクトは、Azureを操作するための готовых почти двести のスキル большой каталогです。これらは単なるドキュメントへのリンクではありません。各スキルはMarkdown形式の命令セットで、AIアシスタントがユーザーにコードを提案する前に読み取ります。
Microsoftの開発者は「ドキュメント アズ コード」アプローチを採用しました。Microsoft Learnの山ほどのコンテンツ—ベストプラクティス、決定木、一般的なミス、セキュリティ要件—を取得し、LLMに優しい命令にパッケージ化しました。その結果、エージェントは単にコードを書くだけでなく、特定サービスのコンテキストを理解します。
なぜ自分のプロジェクトに追加するのか
Azureを操作している場合、ニュアンスがどれだけあるかご存じでしょう。例えば、Azure Container Appsは十通りの方法で構成できますが、そのうちEnterprise基準を満たすのは一二通りだけです。
実際には、これらのスキルがもたらすものは以下の通りです：
- エージェントは推測をやめて、現在のAPIパターンを使用します。
- レスポンスには、関連するMicrosoft Learnセクションへの直接リンクが含まれます。
- AIは、壊れた設定をデプロイする前に、制限と構成の癖について警告するようになります。
- エージェントはトラブルシューティング用の готовых чек-листов を取得します。
内部ではどのように動作するか
コアにはオープンなAgent Skills標準があります。各スキルは skills/ ディレクトリ内の独自のフォルダに存在します。 SKILL.md ファイル構造は以下のようになります：
---
name: azure-functions
description: Инструкции по разработке и развертыванию Azure Functions
---
# Azure Functions
## Инструкции
[Тут идут конкретные шаги для агента]
## Примеры
[Примеры правильного использования сервиса]
興味深いことに、システムは段階的開示の原則で動作します。最初、エージェントはYAMLヘッダー内の名前と簡単な説明のみを表示します。リクエストがスキルのトピックと一致する場合、エージェントは完全な命令を「展開」して、それに従って行動し始めます。これにより、不要なものがいっぱいになったモデルのコンテキストウィンドウが節約されます。
これを動かす方法
最も簡単な方法は、プラグインとしてすべてをインストールすることです。VS Codeの場合、コマンドパレットから実行します：Chat: Install Plugin From Sourceを選択し、リポジトリリンク https://github.com/MicrosoftDocs/agent-skills を貼り付けます。
完全なコントロールを好む場合、またはCursorを使用する場合は、リポジトリをクローンし、 skills/ から必要なフォルダをプロジェクトディレクトリにコピーするだけです。各ツールのパスは異なります：
- GitHub Copilot:
.github/skills/ - Cursor:
.cursor/skills/ - Claude Code:
.claude/skills/
ちなみに、VS Codeでは chat.agent.skills 設定を有効にする必要があることを忘れないでください。そうしないと魔法は起こりません。
実践的なメリットとカテゴリ
現在、リポジトリには193のスキルがあります。カテゴリ別に分かれているため、すべてを持ち歩く必要はありません—特定のスタックに必要なものだけを選択できます：
- Compute（13スキル）：App Service、Functions、Batch。
- AI & ML（23スキル）：Azure AI Servicesとボットに関するすべて。
- Security（19スキル）：Active Directory、Key Vaultなど。
- Infrastructure（52スキル）：ここが重量級—AKS、Arc、ネットワーク構成。
どこから始めればわからない場合は、 docs/BUNDLES.md フォルダにキュレーションされたコレクションがあります。例えば、「Quick Start」バンドルには、任意のAzure開発者に役立つ7つの基本サービスが含まれています。
試す価値はあるか
このプロジェクトは、AIアシスタントを実際のタスクに「接地」する優れた方法のようです。毎回Copilotチャットにドキュメントのスニペットをコピペする代わりに、リポジトリを一度接続すれば、Microsoftエコシステムでのゲームのルールを知っている有能なアシスタントが得られます。
これは、Azureへの移行を始めたばかりのチームや、Durable FunctionsやAzure API Managementなどの複雑なサービスの使用を開始するチームに特に便利です。これらは構成を間違えやすく、後で修正すると時間と費用がかかります。
唯一の欠点は、プロジェクトがまだプレビュー段階であり、IDEで実験的なフラグを有効にする必要がある機能がいくつかあることです。しかし、手動モードでも、必要な .md ファイルをプロジェクトにコピーすれば、コード生成の品質が明確に向上します。Azureに積極的に投資しているなら、このリポジトリはブックマークに必ず追加すべきです。
関連プロジェクト