安装
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 混成一条主路径，也不要推断某家客户端独占。