Hacer que el agente siga el CLI oficial con Aspire Skills

Para quién

Encaja para quien construye apps Aspire distribuidas y quiere que el agente reconozca primero el espacio de trabajo y luego use bien el Aspire CLI. El repositorio oficial es

https://github.com/microsoft/aspire-skills

Escribe Aspire Skills como plugin, skill pack y extension pack para este trabajo. Quiere que el agente enrute el trabajo habitual a skills propias, en vez de improvisar dotnet, curl, Docker o shell. El material no dice qué producto de agente debes usar; no completes una lista de clientes.

Encaja más con reconocer, mirar la orquestación y diagnosticar, no con publicar de entrada. En el material, aspire-deployment Publishes, deploys, and tears down Aspire apps. No tomes ese camino en el primer intento.

Primera prueba en 3 minutos

El camino principal usa el Aspire CLI oficial y en el prompt eliges acoplar agent guidance. Para un espacio existente usa esto:

aspire agent init

El material también escribe aspire new (crear una app y elegir guía en el prompt) e aspire init (añadir un esqueleto Aspire a un repo existente y elegir guía en el prompt). El primer intento prefiere aspire agent init, porque es Add, update, or reconfigure Aspire guidance in an existing workspace. Requisito: esta máquina ya puede ejecutar el Aspire CLI, y el directorio actual es un espacio Aspire que permites reescribir. El material no escribe el nombre del paquete de instalación del CLI ni un número de versión.

Efecto: escribe o actualiza la config de guía en el espacio. Confirma el directorio antes de ejecutar. Después mira primero si el agente puede recognize Aspire workspaces, luego decide si arrancar recursos. No despliegues ni derribes en este paso.

Tarea de bajo riesgo: deja que el skill de enrutado de primer nivel aspire haga solo una comprobación de solo lectura, por ejemplo si el espacio se reconoce y si el CLI se llama bien. Si hay que tocar una app en marcha, usa solo aspire-monitoring para logs, traces, dashboard, telemetry o diagnostics; no llames aspire-deployment. Señal de éxito: el agente ya no cambia a un dotnet / curl / Docker / shell improvisado para estas tareas Aspire. Si no hay CLI, para en «esta máquina no tiene Aspire CLI»; no termines el primer intento con otro instalador.

Casos de uso

Caso 1: acoplar o actualizar guía en un espacio existente. Corresponde a aspire agent init y recognize Aspire workspaces. Encaja cuando el repo ya existe y solo quieres que el agente trabaje al modo Aspire. El material no escribe el texto del prompt ni qué archivos se generaron; lo comprobable es que un espacio existente puede actualizar guidance. No escribas el caso 1 como ya desplegado en la nube.

Caso 2: tras la orquestación, supervisión y diagnóstico. Corresponde a aspire-orchestration (Starts, stops, waits for, and manages Aspire resources) y aspire-monitoring (Routes logs, traces, dashboard, telemetry, and diagnostics work). Encaja cuando los recursos ya están arriba y solo quieres logs o el panel. El material no escribe URL del panel ni reglas de alerta; la supervisión debe ir por ese skill, no por un curl improvisado. Arrancar/parar recursos tiene efectos; confirma que el entorno lo permite antes de ejecutar.

Límites de uso

aspire-init Creates a new Aspire project or adds an Aspire skeleton to an existing repo; aspireify Wires an AppHost después de aspire init. Eso cambia la estructura del repo; no lo trates como una comprobación de solo lectura. aspire-deployment incluye derribo y necesita confirmación extra. El material también muestra npx skills add microsoft/aspire-skills y un conjunto de comandos /plugin; son otras entradas. En el primer intento no los mezcles con el Aspire CLI en un solo camino principal, ni infieras que un cliente lo posee en exclusiva.