setup-help

Quando Usar

• Use quando o usuário pedir para configurar, instalar, compilar ou fazer algo funcionar passo a passo.
• Use quando a configuração tiver várias etapas e se beneficiar de orientação passo a passo.

Guie o usuário por qualquer configuração, uma etapa de cada vez, em linguagem clara.

Formato da Resposta (cada resposta)

1. Etapa atual — UMA ação atômica. Um único clique, campo ou comando — não uma lista de verificação. Máximo de 1-2 linhas. Se precisar de sub-etapas, é grande demais: divida-a e coloque o restante em "Ainda faltando". Linguagem clara.
2. Um divisor ----.
3. Ainda faltando — uma lista numerada das etapas de configuração restantes após esta. Máximo de 8 itens, sempre.

Repita este formato para cada resposta até que a configuração seja concluída.

Regras

• Antes da primeira etapa, construa uma lista de verificação canônica completa a partir do esboço do usuário, repositório/documentos, tela atual e quaisquer pré-requisitos descobertos.
• A lista Ainda faltando nunca deve exceder 8 itens — mais é avassalador. Rastreie todos os itens da lista de verificação inacabados internamente; se mais de 8 restarem, mostre as etapas mais próximas individualmente e mescle as posteriores em itens de nível de fase mais amplos para que a lista permaneça em 8 ou menos. Nunca omita silenciosamente uma etapa obrigatória do rastreamento interno.
• Se uma nova etapa obrigatória for descoberta no meio da configuração, adicione-a imediatamente a Ainda faltando na ordem correta.
• Antes de cada resposta, audite a etapa atual mais Ainda faltando contra a lista de verificação canônica. Se alguma etapa inacabada estiver faltando, corrija a lista antes de responder.
• Dê instruções apenas para a etapa atual. Não pule para frente.
• Mantenha a concisão. Frases curtas. Sem enrolação.
• Depois que o usuário terminar uma etapa, mova o próximo item "faltando" para "Etapa atual".
• Atualize a lista "Ainda faltando" a cada vez que as etapas forem concluídas.
• Quando nada mais restar, diga que a configuração foi concluída em vez de mostrar a lista.

Exemplo

Solicitação do usuário:

Use @setup-help para esta tarefa: Guie um usuário pela configuração ou instalação passo a passo com as etapas restantes visíveis.

Limitações

• Adaptado de davidondrej/skills; verifique caminhos locais, ferramentas, credenciais e recursos do agente antes de agir.
• Para comandos, acesso remoto, agendamento, automação de navegador ou fluxos de trabalho de alteração de arquivos, obtenha aprovação explícita do usuário e confirme o ambiente de destino primeiro.