AI コーディングエージェントを活用する

Aspire は AI コーディングエージェント向けに、優れた初期セットアップ体験を提供します。プロジェクトで aspire agent init を実行すると、AI アシスタントは GitHub Copilot、Claude Code、またはその他の MCP 対応ツールのいずれであっても、分散アプリをすぐに理解し、ビルドし、デバッグし、監視できるようになります。

Aspire がコーディングエージェントに適している理由

Aspire は、コーディングエージェントに対して、開発者が持つのと同じ実行中アプリケーションの可視性を提供します。Aspire Dashboard で確認できるリソースデータ、構造化ログ、分散トレースは、Aspire MCP server と Aspire CLI を通じてエージェントにも公開されます。人がダッシュボードでデバッグする場合でも、エージェントが MCP 経由で診断する場合でも、見えている状況は同じです。

Aspire CLI はエージェント主導のワークフロー向けに設計されています。コマンドはプロンプト待ちでブロックしないように非対話実行をサポートし、多くのコマンドで構造化されたプレーンテキスト出力向けに --format Json を利用できます。主なコマンドは aspire start（バックグラウンド実行）、aspire start --isolated（並列ワークツリー）、aspire wait（正常状態になるまで待機）、aspire describe、aspire logs、aspire docs search です。

aspire agent init でインストールされる Aspire ワークフロースキルは、これらのパターンをエージェントに自動で教えます。

はじめに

aspire new または aspire init で新しい Aspire プロジェクトを作成すると、AI エージェント環境の構成を求められます。構成のセットアップや更新は、いつでも aspire agent init を実行して行えます。

Aspire プロジェクトディレクトリ（AppHost を含むフォルダー）でターミナルを開きます。
次のコマンドを実行します:
Aspire CLI
```
aspire agent init
```

ファイルをインストールする スキル配置先 を選択します。既定では Standard が事前選択されています:

配置先	ディレクトリ	備考
Standard	`.agents/skills/`	VS Code、GitHub Copilot、OpenCode でサポート
Claude Code	`.claude/skills/`	Claude Code 専用
GitHub Skills	`.github/skills/`	VS Code / GitHub Copilot 向け
OpenCode	`.opencode/skill/`	OpenCode 専用

それらの配置先にインストールする スキルとツール を選択します。microsoft/aspire-skills の Aspire ワークフロースキルは次のとおりです:
- aspire — Aspire タスクを適切なワークフローにルーティングします
- aspire-init — 新しい Aspire アプリを作成するか、既存のリポジトリに Aspire のひな形を追加します
- aspire-orchestration — Aspire リソースを開始、停止、待機、管理します
- aspire-monitoring — ログ、トレース、メトリック、リソース状態、診断データを確認します
- aspire-deployment — Aspire アプリを発行、デプロイ、削除します
- aspireify — aspire init の後に AppHost を配線します
フローでは、実行しているコマンドに適したワークフロースキルが事前選択されます。ブラウザー確認には Playwright CLI、.NET API サーフェスのクエリには dotnet-inspect を追加します。実行中の Aspire アプリからのライブデータが必要な場合は、Install Aspire MCP server を選択します。

Aspire ワークフロースキルは、microsoft/aspire-skills GitHub リリースアセットを通じて配布されます。Aspire 13.4 には既定インストール向けの埋め込みスナップショットが含まれ、任意のリモート取得パスでは一致するリリースアセットをダウンロードできます。Playwright CLI や dotnet-inspect などのコンパニオンオプションは、選択した場合に個別にインストールされます。

構成される内容

aspire agent init コマンドは AI 開発環境を検出し、適切な構成ファイルを作成します:

Aspire ワークフロースキルファイル

Aspire ワークフロースキルは、AI コーディングエージェントが Aspire を扱う方法を教えます。トップレベルの aspire スキルは、初期化、オーケストレーション、監視、デプロイ、AppHost 配線向けの専用スキルにリクエストをルーティングします。

たとえば、標準の配置先には次のファイルが含まれます:

ディレクトリ.agents/skills/
- ディレクトリaspire/
  - SKILL.md
- ディレクトリaspire-init/
  - SKILL.md
- ディレクトリaspire-orchestration/
  - SKILL.md
- ディレクトリaspire-monitoring/
  - SKILL.md
- ディレクトリaspire-deployment/
  - SKILL.md
- ディレクトリaspireify/
  - SKILL.md

これらのスキルは、次の方法をエージェントにガイドします:

Aspire アプリケーションの起動と管理（aspire start、aspire stop、aspire describe）
構造化ログと分散トレースを使った問題のデバッグ
aspire add による統合追加と aspire docs によるドキュメント検索
データベースクエリなど、リソース固有の操作に向けたリソース MCP ツールの利用
初回セットアップ、AppHost 配線、監視、オーケストレーション、デプロイ作業を専用ワークフローへルーティング

dotnet-inspect skill

dotnet-inspect コンパニオンスキルは、dotnet-inspect ツールを使って .NET API サーフェスをクエリする方法を AI エージェントに教えます。選択した場合、選択した各配置先にインストールされます:

ディレクトリ.agents/skills/dotnet-inspect/
- SKILL.md
ディレクトリ.github/skills/dotnet-inspect/
- SKILL.md
ディレクトリ.claude/skills/dotnet-inspect/
- SKILL.md
ディレクトリ.opencode/skill/dotnet-inspect/
- SKILL.md

このスキルにより、エージェントは NuGet パッケージ API サーフェスの調査、パッケージバージョン間の API 変更比較、.NET の型とメンバーの探索が可能になります。

Aspire MCP server

MCP サーバーは、実行中の Aspire アプリケーションに対する直接的なランタイムアクセス（リソース状態、ログ、トレース、コマンド）を AI エージェントに提供します。構成の詳細、利用可能なツール、セキュリティモデルは Aspire MCP server を参照してください。

AGENTS.md からの移行

プロジェクトに旧バージョンの Aspire 由来の AGENTS.md ファイルがある場合、新しいスキルファイル形式へ移行できます。スキルファイルはより構造化されており、AI コーディングエージェントにネイティブ認識されます。

aspire agent init を実行し、インストールする Aspire ワークフロースキルを選択します。
スキルファイルは、.agents/skills/aspire/SKILL.md や .agents/skills/aspire-orchestration/SKILL.md など、選択した各スキル配置先の下に作成されます。
旧 AGENTS.md ファイルを確認したうえで削除します。スキルファイルが置き換えます。

最初のプロンプト

構成が完了したら、好みの AI コーディング環境を起動します。次のようにエージェントへ依頼してみてください:

“Aspire アプリを起動して、リソースの状態を表示して。”

“API の HTTP リクエストパフォーマンスを分析して。”

“AppHost に Redis キャッシュを追加して。”

対応している AI アシスタント

aspire agent init コマンドは、次の AI アシスタントをサポートします:

VS Code と GitHub Copilot
Copilot CLI
Claude Code
OpenCode