Aspire スキル

このリポジトリはAspireを使用して分散アプリケーションをオーケストレーションしています。リソースはAppHostプロジェクト(apphost.csまたはapphost.ts)で定義されます。

CLIコマンドリファレンス

タスク	コマンド
アプリの起動	aspire start
分離モードで起動(ワークツリー)	aspire start --isolated
アプリの再起動	aspire start(以前のインスタンスは自動停止)
リソースのヘルスチェック待機	aspire wait <resource>
アプリの停止	aspire stop
リソース一覧の表示	aspire describeまたはaspire resources
リソースコマンドの実行	aspire resource <resource> <command>
リソースの開始/停止/再起動	`aspire resource <resource> start
コンソールログの表示	aspire logs [resource]
構造化ログの表示	aspire otel logs [resource]
トレースの表示	aspire otel traces [resource]
トレースIDのログ表示	aspire otel logs --trace-id <id>
統合の追加	aspire add
実行中のAppHostの一覧表示	aspire ps
AppHostパッケージの更新	aspire update
ドキュメントの検索	aspire docs search <query>
ドキュメントページの取得	aspire docs get <slug>
ドキュメントページ一覧の表示	aspire docs list
環境診断	aspire doctor
リソースMCPツール一覧の表示	aspire mcp tools
リソースMCPツールの呼び出し	aspire mcp call <resource> <tool> --input <json>

ほとんどのコマンドは--format Jsonをサポートしており、マシンが読み取り可能な出力形式で結果を得られます。特定のAppHostを対象とする場合は--apphost <path>を使用してください。

主要なワークフロー

エージェント環境での実行

aspire startを使用してAppHostをバックグラウンドで実行します。Gitワークツリーで作業する場合は、ポート競合を回避し、他の実行中のインスタンスとのユーザーシークレットやローカル状態の共有を防ぐために--isolatedを使用してください:

aspire start --isolated

リソースと対話する前にヘルスチェックが完了するまで待機するには、aspire wait <resource>を使用してください:

aspire start --isolated
aspire wait myapi

再起動は安全です。aspire startは自動的に前のインスタンスを停止します。AppHostプロジェクトに変更を加えた場合はaspire startを再実行してください。

問題のデバッグ

コード変更を加える前に、アプリケーションの状態を検査してください:

1. aspire describe — リソースのステータスを確認
2. aspire otel logs <resource> — 構造化ログを表示
3. aspire logs <resource> — コンソール出力を表示
4. aspire otel traces <resource> — 分散トレースを表示

統合の追加

aspire docs searchで統合のドキュメントを検索し、aspire docs getで詳細なガイドを読み、aspire addでAppHostに統合パッケージを追加します。

統合を追加した後、aspire startでアプリを再起動し、新しいリソースを有効にしてください。

リソースMCPツールの使用

リソースの中にはMCPツールを提供するものもあります(例: WithPostgresMcp()はSQLクエリツールを追加)。CLIで検出し、呼び出します:

aspire mcp tools                                              # 利用可能なツール一覧
aspire mcp tools --format Json                                # 入力スキーマを含む
aspire mcp call <resource> <tool> --input '{"key":"value"}'   # ツールを呼び出す

重要なルール

• 常にアプリを最初に起動してください(aspire start)。開始状態を確認するため、変更を加える前に起動します。
• 再起動するにはaspire startを再実行するだけです — 前のインスタンスは自動的に停止されます。aspire stopの後にaspire runを使用しないでください。aspire runは一切使用しないでください。
• ワークツリーで作業する場合は--isolatedを使用してください。
• 永続的なコンテナを避けてください — 開発初期段階では状態管理の問題を防ぐためです。
• Aspireワークロードはインストールしないでください — 廃止済みです。
• 公式ドキュメントについてはaspire.devおよびlearn.microsoft.com/microsoft/aspireを優先的に使用してください。

Playwright CLI

設定されている場合は、Playwright CLIを使用してリソースの機能テストを実施します。エンドポイントはaspire describeで取得します。利用可能なコマンドについてはplaywright-cli --helpを実行してください。