インストール
aspire agent init誰向けか
Aspire 分散アプリを作っており、エージェントに先にワークスペースを識別させ、それから Aspire CLI を正しく使わせたい人向け。公式リポジトリは
https://github.com/microsoft/aspire-skills
Aspire Skills を、この種の仕事向けの plugin、skill pack、extension pack と書く。よくある仕事を専用スキルへルーティングさせ、その場しのぎの dotnet、curl、Docker、shell を組ませない。材料はどのエージェント製品を必須とも書いていない。クライアント名簿を自分で足さない。
先に識別、オーケストレーションの閲覧、診断をする向きであり、いきなり公開する向きではない。材料の aspire-deployment は Publishes, deploys, and tears down Aspire apps。最初の試行ではこの道を取らない。
3 分で最初の試行を終える
主経路は公式 Aspire CLI を使い、プロンプトで agent guidance の接続を選ぶ。既存ワークスペースでは次を使う：
aspire agent init
材料は aspire new（アプリを新規作成し、プロンプトで指導を選ぶ）と aspire init（既存リポジトリに Aspire 骨格を足し、プロンプトで指導を選ぶ）も書く。最初の試行は aspire agent init を優先する。それが Add, update, or reconfigure Aspire guidance in an existing workspace だから。前提：本機はすでに Aspire CLI を実行でき、今のディレクトリは書き換えを許した Aspire ワークスペースである。材料は CLI のインストール包名も版番号も書いていない。
副作用：ワークスペースへ指導設定を書く、または更新する。実行前にディレクトリを確認する。実行後、エージェントが recognize Aspire workspaces できるかを見てから、リソースを起動するか決める。この段階でデプロイも破棄もしない。
低リスクな作業：最上位の aspire ルーティングスキルに読み取り専用確認だけさせる。例えばワークスペースが識別されるか、CLI が正しく呼ばれるか。動いているアプリに触るなら aspire-monitoring だけで logs、traces、dashboard、telemetry、diagnostics を見る。aspire-deployment は呼ばない。成功の合図は、エージェントがこれらの Aspire 作業をその場しのぎの dotnet / curl / Docker / shell に切り替えないこと。CLI が無ければ「本機に Aspire CLI が無い」で止める。他のインストーラで最初の試行を終わらせない。
利用例
例 1：既存ワークスペースに指導を接続または更新する。対応は aspire agent init と recognize Aspire workspaces。リポジトリはすでにあり、エージェントに Aspire のやり方で働いてほしい人向け。材料はプロンプト文面も、どのファイルが生成されたかも書いていない。確認できるのは、既存ワークスペースが guidance を更新できること。例 1 をすでにクラウドへデプロイ済みと書かない。
例 2：オーケストレーションのあと監視診断をする。対応は aspire-orchestration（Starts, stops, waits for, and manages Aspire resources）と aspire-monitoring（Routes logs, traces, dashboard, telemetry, and diagnostics work）。リソースはすでに上がっており、ログまたはダッシュボードだけ見たい人向け。材料はダッシュボード住所も警報規則も書いていない。監視はそのスキルを通し、その場しのぎの curl にしない。リソースの起動/停止には副作用がある。環境が許すかを先に確認してから実行する。
利用上の境界
aspire-init は Creates a new Aspire project or adds an Aspire skeleton to an existing repo。aspireify は aspire init のあと Wires an AppHost。これらはリポジトリ構造を変える。読み取り専用点検として扱わない。aspire-deployment は破棄を含み、追加の確認が要る。材料は別に npx skills add microsoft/aspire-skills と一組の /plugin コマンドも出す。それらは別入口。最初の試行で Aspire CLI と一本の主経路に混ぜない。特定クライアントの独占とも推論しない。