安裝
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。成功訊號是代理不再改用臨時的 dotnet / curl / Docker / shell 去完成這些 Aspire 任務。若 CLI 不存在，停在「本機沒有 Aspire CLI」，不要改用其它安裝程式完成第一次嘗試。
使用案例
案例一：給已有工作區接入或更新指導。對應 aspire agent init，以及 recognize Aspire workspaces。適合倉庫已經在、只想讓代理按 Aspire 方式工作的人。材料沒有寫提示文案或產生了哪些檔案；能確認的是現有工作區可以更新 guidance。不要把案例一寫成已經部署到雲端。
案例二：編排之後做監控診斷。對應 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 混成一條主路徑，也不要推斷某家用戶端獨占。