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

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

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

Aspire は、コーディングエージェントに対して、開発者が持つのと同じ実行中アプリケーションの可視性を提供します。[Aspire Dashboard](/ja/dashboard/overview/) で確認できるリソースデータ、構造化ログ、分散トレースは、[Aspire MCP server](/ja/get-started/aspire-mcp-server/) と [Aspire CLI](/ja/get-started/install-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` を実行して行えます。

1. Aspire プロジェクトディレクトリ（AppHost を含むフォルダー）でターミナルを開きます。

1. 次のコマンドを実行します:

   ```bash title="Aspire CLI"
   aspire agent init
   ```

1. ファイルをインストールする **スキル配置先** を選択します。既定では **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 専用                                |

1. それらの配置先にインストールする **スキルとツール** を選択します。[`microsoft/aspire-skills`](https://github.com/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** を選択します。

   :::note[Aspire ワークフロースキルバンドル]
   Aspire ワークフロースキルは、[`microsoft/aspire-skills`](https://github.com/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`](https://github.com/richlander/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 の型とメンバーの探索が可能になります。

:::note[dotnet-inspect を使う場合]
エージェントに広範な .NET API サーフェスのクエリが必要な場合は `dotnet-inspect` をインストールします。Aspire 固有の API ドキュメントについては、Aspire スキルが C# と TypeScript の両方で `aspire docs api` コマンドを使うようエージェントをガイドします。
:::

### Aspire MCP server

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

## AGENTS.md からの移行

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

1. `aspire agent init` を実行し、インストールする Aspire ワークフロースキルを選択します。

2. スキルファイルは、`.agents/skills/aspire/SKILL.md` や `.agents/skills/aspire-orchestration/SKILL.md` など、選択した各スキル配置先の下に作成されます。

3. 旧 `AGENTS.md` ファイルを確認したうえで削除します。スキルファイルが置き換えます。
**Tip:** スキルファイルは `AGENTS.md` よりも構造化されており、完全な CLI
  コマンド参照表、ワークフローパターン、エージェントが自動で従うルールを含みます。プロジェクト固有のニーズに合わせてカスタマイズできます。

## 最初のプロンプト

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

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

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

> "AppHost に Redis キャッシュを追加して。"

<LoopingVideo
      aria-label="Aspire MCP を使ってリソース一覧を取得する GitHub Copilot と VS Code"
      controls={true}
      sources={[
        {
          src: '/mcp-vscode-list-resources.mp4',
          type: 'video/mp4',
          title: 'GitHub Copilot と統合した Aspire MCP を示す VS Code のデモ',
        },
      ]}
    />
  <p>
      Claude Code で Aspire MCP サーバーを構成し、ターミナルから実行中の Aspire
      リソースを確認できます。
    </p>
  <p>
      Copilot CLI で Aspire MCP サーバーを構成し、Aspire
      アプリのリソース状態、ログ、トレースを取得できます。
    </p>
  <p>
      OpenCode で Aspire MCP
      サーバーを構成し、エージェントによるターミナルワークフローから実行中の
      Aspire アプリケーションを調査できます。
    </p>
  ## 対応している AI アシスタント

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

- [VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) と GitHub Copilot
- [Copilot CLI](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/use-copilot-cli#add-an-mcp-server)
- [Claude Code](https://docs.claude.com/en/docs/claude-code/mcp)
- [OpenCode](https://opencode.ai/docs/mcp-servers/)
**Note:** Aspire MCP サーバーは STDIO トランスポートプロトコルを使用しており、この MCP
  通信プロトコルをサポートする他のエージェント型コーディング環境でも動作する可能性があります。

## 関連情報

- [Aspire MCP server](/ja/get-started/aspire-mcp-server/) — MCP サーバー向けのツール、セキュリティ、トラブルシューティング
- [aspire agent command](/ja/reference/cli/commands/aspire-agent/)
- [aspire agent init command](/ja/reference/cli/commands/aspire-agent-init/)
- [aspire agent mcp command](/ja/reference/cli/commands/aspire-agent-mcp/)
- [Dashboard security considerations](/ja/dashboard/security-considerations/)
- [Dashboard and AI coding agents](/ja/dashboard/ai-coding-agents/)