Fazer o agente seguir o CLI oficial com Aspire Skills

Para quem

Serve para quem constrói apps Aspire distribuídos e quer que o agente reconheça primeiro o espaço de trabalho e depois use o Aspire CLI certo. O repositório oficial é

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

Escreve Aspire Skills como plugin, skill pack e extension pack para esse trabalho. Quer que o agente encaminhe o trabalho comum a skills dedicadas, em vez de improvisar dotnet, curl, Docker ou shell. O material não diz qual produto de agente você deve usar; não complete uma lista de clientes.

Serve mais para reconhecer, olhar a orquestração e diagnosticar, não para publicar de cara. No material, aspire-deployment Publishes, deploys, and tears down Aspire apps. Não tome esse caminho na primeira tentativa.

Primeira tentativa em 3 minutos

O caminho principal usa o Aspire CLI oficial e no prompt você escolhe anexar agent guidance. Para um espaço existente use isto:

aspire agent init

O material também escreve aspire new (criar um app e escolher orientação no prompt) e aspire init (adicionar um esqueleto Aspire a um repo existente e escolher orientação no prompt). A primeira tentativa prefere aspire agent init, porque é Add, update, or reconfigure Aspire guidance in an existing workspace. Pré-requisito: esta máquina já consegue executar o Aspire CLI, e o diretório atual é um espaço Aspire que você permite reescrever. O material não escreve o nome do pacote de instalação do CLI nem um número de versão.

Efeito colateral: grava ou atualiza a config de orientação no espaço. Confirme o diretório antes de executar. Depois veja primeiro se o agente consegue recognize Aspire workspaces e só então decida se sobe recursos. Não faça deploy nem derrube neste passo.

Tarefa de baixo risco: deixe a skill de roteamento de primeiro nível aspire fazer só uma conferência somente leitura, por exemplo se o espaço é reconhecido e se o CLI é chamado certo. Se precisar tocar um app em execução, use só aspire-monitoring para logs, traces, dashboard, telemetry ou diagnostics; não chame aspire-deployment. Sinal de sucesso: o agente não troca mais para um dotnet / curl / Docker / shell improvisado para essas tarefas Aspire. Se o CLI não existir, pare em «esta máquina não tem Aspire CLI»; não termine a primeira tentativa com outro instalador.

Casos de uso

Caso 1: anexar ou atualizar orientação num espaço existente. Corresponde a aspire agent init e recognize Aspire workspaces. Serve quando o repo já existe e você só quer que o agente trabalhe no jeito Aspire. O material não escreve o texto do prompt nem quais arquivos foram gerados; o fato conferível é que um espaço existente pode atualizar guidance. Não escreva o caso 1 como já publicado na nuvem.

Caso 2: depois da orquestração, monitoramento e diagnóstico. Corresponde a aspire-orchestration (Starts, stops, waits for, and manages Aspire resources) e aspire-monitoring (Routes logs, traces, dashboard, telemetry, and diagnostics work). Serve quando os recursos já estão no ar e você só quer logs ou o painel. O material não escreve URL do painel nem regras de alerta; o monitoramento deve ir por essa skill, não por um curl improvisado. Subir/parar recursos tem efeito colateral; confirme que o ambiente permite antes de executar.

Limites de uso

aspire-init Creates a new Aspire project or adds an Aspire skeleton to an existing repo; aspireify Wires an AppHost depois de aspire init. Isso muda a estrutura do repo; não trate como conferência somente leitura. aspire-deployment inclui derrubada e precisa de confirmação extra. O material também mostra npx skills add microsoft/aspire-skills e um conjunto de comandos /plugin; são outras entradas. Na primeira tentativa não misture com o Aspire CLI num único caminho principal, nem infira que um cliente o possui com exclusividade.