run-acceptance-tests

Visão geral da skill run-acceptance-tests

O que esta skill faz

A skill run-acceptance-tests ajuda você a executar corretamente os testes de aceitação de providers Terraform, especialmente os testes nomeados com o prefixo TestAcc. Ela foi pensada para o fluxo de trabalho de run-acceptance-tests para Acceptance Testing, em que a tarefa principal não é apenas “rodar um teste”, mas executá-lo no ambiente certo, interpretar falhas e saber quando é necessário algum setup extra específico do provider.

Quem deve usar

Use a skill run-acceptance-tests se você estiver trabalhando em um provider Terraform e precisar de um guia prático de run-acceptance-tests para validação local, troubleshooting no CI ou reprodução de um resultado intermitente. Ela é mais útil quando você já tem um teste de aceitação específico em mente e precisa de uma forma confiável de executá-lo sem ficar no chute com flags ou variáveis de ambiente.

O que a diferencia

Esta skill é opinativa sobre a sequência que importa: comece com uma chamada focada go test -run=... e só depois adicione -count=1, -v, TF_LOG=debug e persistência do workspace quando a primeira execução não bastar. Isso torna a skill run-acceptance-tests melhor do que um prompt genérico, porque ela codifica uma escada de diagnóstico em vez de pedir que você improvise.

Como usar a skill run-acceptance-tests

Instale a skill

Instale a skill run-acceptance-tests com:
npx skills add hashicorp/agent-skills --skill run-acceptance-tests

Se você estiver avaliando a instalação do run-acceptance-tests para um fluxo de trabalho com provider Terraform, confirme que seu ambiente consegue executar testes Go e que você pode definir credenciais do provider com segurança quando necessário. A skill pressupõe um contexto de acceptance testing, não um projeto demo isolado.

Dê à skill um alvo de teste preciso

A melhor entrada é um nome concreto de TestAcc, não um pedido vago como “verifica os testes do provider”. Por exemplo, peça algo como: “Execute TestAccFeatureHappyPath e diagnostique quaisquer variáveis de ambiente ausentes.” A skill funciona melhor quando o nome do teste, o provider e o comportamento esperado estão explícitos.

Comece pelos arquivos e sinais certos

Comece com SKILL.md e, em seguida, examine README.md, AGENTS.md, metadata.json e quaisquer pastas de apoio como rules/, resources/, references/ ou scripts/, se existirem. Neste repositório, a orientação principal fica concentrada em SKILL.md, então a inspeção da árvore de arquivos pesa menos do que em skills maiores, mas ainda vale a pena para confirmar que não há arquivos auxiliares ocultos.

Siga a escada de execução e depuração

Para uma execução normal, use TF_ACC=1 go test -run=TestAccFeatureHappyPath e, primeiro, mantenha a saída sem verbosidade. Se o teste falhar, rode de novo com -count=1 para evitar resultados em cache; depois adicione -v, depois TF_LOG=debug e, só então, considere TF_ACC_WORKING_DIR_PERSIST=1 para inspecionar o estado do Terraform entre as etapas. Esse fluxo em camadas é o núcleo do padrão de uso da skill run-acceptance-tests.

FAQ da skill run-acceptance-tests

Isso é só para testes de aceitação de providers Terraform?

Sim. A skill run-acceptance-tests é focada em acceptance testing de providers Terraform, especialmente testes Go que usam a convenção de nomes TestAcc. Ela não foi feita para testes unitários, suítes genéricas de Go ou verificações de infraestrutura sem relação com isso.

E se o teste precisar de variáveis de ambiente extras?

Isso é esperado. A skill assume explicitamente que alguns providers exigem variáveis de ambiente adicionais e orienta você a identificar variáveis ausentes na saída do teste e configurá-las com segurança. Se credenciais ou endpoints estiverem faltando, trate isso como parte do guia run-acceptance-tests, não como uma falha da skill em si.

Eu preciso disso em vez de um prompt normal?

Use a skill quando você quiser um procedimento repetível, não apenas uma resposta pontual. Um prompt normal pode mandar você rodar um teste; a skill run-acceptance-tests mostra quais flags, variáveis de ambiente e etapas de escalonamento usar quando a primeira tentativa falhar ou quando um teste que passou ainda precise de verificação.

É amigável para quem está começando?

Sim, se você já consegue rodar comandos Go e entende variáveis de ambiente básicas. A skill reduz o chute para iniciantes ao começar com um comando focado e uma escalada clara de depuração, mas ainda espera que você reconheça credenciais específicas do provider, o comportamento do Terraform e as convenções de nomenclatura dos testes.

Como melhorar a skill run-acceptance-tests

Traga um contexto de teste mais forte

As entradas mais úteis são o nome exato do teste, o pacote do provider e o sintoma que você está tentando reproduzir. “Rodar acceptance tests” é amplo demais; “Rodar TestAccResourceBasic no pacote internal/provider e investigar uma pista ausente de TF_LOG” dá à skill contexto suficiente para escolher o caminho certo rapidamente.

Compartilhe os detalhes da falha, não só o status de falha

Se a primeira execução falhar, inclua a saída completa do teste, mensagens sobre variáveis ausentes e se o resultado mudou após -count=1 ou -v. A skill run-acceptance-tests melhora quando você alimenta o formato real da falha, porque testes de aceitação de provider costumam falhar por motivos diferentes: autenticação, prontidão da API remota, drift de estado ou instabilidade do teste.

Use as opções de debug na ordem certa

Peça primeiro a menor escalada necessária e só expanda se as evidências exigirem. No uso de run-acceptance-tests, isso normalmente significa começar com um único nome TestAcc bem focado e só adicionar saída verbosa, logs de debug ou persistência do workspace depois que você souber o que precisa inspecionar.

Itere no teste, não apenas no comando

Se você precisa confirmar que um teste aprovado é realmente significativo, altere uma verificação ou uma etapa e rode de novo, em vez de apenas repetir o mesmo comando. Isso torna a skill run-acceptance-tests mais valiosa para Acceptance Testing, porque ajuda você a distinguir um sucesso real de um falso negativo e a refinar o sinal do teste ao longo do tempo.