run-acceptance-tests

Descripción general de la skill run-acceptance-tests

Qué hace esta skill

La skill run-acceptance-tests te ayuda a ejecutar correctamente las pruebas de aceptación de un proveedor de Terraform, especialmente las pruebas cuyo nombre empieza por TestAcc. Está pensada para el flujo de trabajo de run-acceptance-tests de Acceptance Testing, donde la tarea principal no es solo “ejecutar una prueba”, sino hacerlo con el entorno adecuado, interpretar los fallos y saber cuándo hace falta una configuración adicional específica del proveedor.

Quién debería usarla

Usa la skill run-acceptance-tests si trabajas en un proveedor de Terraform y necesitas una guía práctica de run-acceptance-tests para validación local, depuración en CI o reproducir un resultado intermitente. Es más útil cuando ya tienes en mente una prueba de aceptación concreta y necesitas una forma fiable de ejecutarla sin improvisar flags ni variables de entorno.

Qué la hace diferente

Esta skill es muy concreta sobre la secuencia que importa: empieza con una invocación enfocada de go test -run=... y luego añade -count=1, -v, TF_LOG=debug y la persistencia del workspace solo cuando la primera ejecución no basta. Eso hace que la skill run-acceptance-tests sea mejor que un prompt genérico, porque incorpora una escalera de diagnóstico en lugar de pedirte que improvises.

Cómo usar la skill run-acceptance-tests

Instala la skill

Instala la skill run-acceptance-tests con:
npx skills add hashicorp/agent-skills --skill run-acceptance-tests

Si estás evaluando la instalación de run-acceptance-tests para un flujo de trabajo de proveedor de Terraform, confirma que tu entorno puede ejecutar pruebas de Go y que puedes definir credenciales del proveedor de forma segura cuando haga falta. La skill asume un contexto de pruebas de aceptación, no un proyecto de demostración independiente.

Dale a la skill un objetivo de prueba preciso

La mejor entrada es un nombre concreto de TestAcc, no una petición vaga como “revisa las pruebas del proveedor”. Por ejemplo, pide algo como: “Ejecuta TestAccFeatureHappyPath y diagnostica cualquier variable de entorno que falte”. La skill funciona mejor cuando el nombre de la prueba, el proveedor y el comportamiento esperado están explícitos.

Empieza por los archivos y señales correctos

Comienza con SKILL.md y después inspecciona README.md, AGENTS.md, metadata.json y cualquier carpeta de apoyo como rules/, resources/, references/ o scripts/ si existen. En este repositorio, la guía principal está concentrada en SKILL.md, así que revisar el árbol de archivos importa menos que en skills más grandes, pero sigue siendo útil para confirmar que no haya archivos auxiliares ocultos.

Sigue la secuencia de ejecución y depuración

Para una ejecución normal, usa TF_ACC=1 go test -run=TestAccFeatureHappyPath y deja la salida sin modo verboso al principio. Si la prueba falla, repítela con -count=1 para evitar resultados en caché; después añade -v, luego TF_LOG=debug y solo entonces considera TF_ACC_WORKING_DIR_PERSIST=1 para inspeccionar el estado de Terraform entre pasos. Este flujo por etapas es el núcleo del uso de run-acceptance-tests.

Preguntas frecuentes sobre la skill run-acceptance-tests

¿Esto es solo para pruebas de aceptación de proveedores de Terraform?

Sí. La skill run-acceptance-tests está acotada a las pruebas de aceptación de proveedores de Terraform, especialmente pruebas de Go que usan la convención de nombres TestAcc. No está pensada para pruebas unitarias, suites genéricas de Go ni verificaciones de infraestructura no relacionadas.

¿Qué pasa si la prueba necesita variables de entorno adicionales?

Eso es lo esperado. La skill asume explícitamente que algunos proveedores requieren variables de entorno adicionales y te indica que identifiques las variables que faltan a partir de la salida de la prueba y las configures de forma segura. Si faltan credenciales o endpoints, trátalo como parte de la guía de run-acceptance-tests, no como un fallo de la skill.

¿Necesito esto en lugar de un prompt normal?

Usa la skill cuando quieras un procedimiento repetible, no solo una respuesta puntual. Un prompt normal puede decirte que ejecutes una prueba; la skill run-acceptance-tests te indica qué flags, variables de entorno y pasos de escalado usar cuando el primer intento falla o cuando una prueba que pasa todavía necesita verificación.

¿Es apta para principiantes?

Sí, siempre que ya puedas ejecutar comandos de Go y entiendas las variables de entorno básicas. La skill reduce la incertidumbre para quienes empiezan al partir de un comando focalizado y una escalada de depuración clara, pero sigue esperando que reconozcas credenciales específicas del proveedor, el comportamiento de Terraform y las convenciones de nombres de las pruebas.

Cómo mejorar la skill run-acceptance-tests

Aporta más contexto de la prueba

Las entradas más útiles son el nombre exacto de la prueba, el paquete del proveedor y el síntoma que intentas reproducir. “Ejecuta pruebas de aceptación” es demasiado amplio; “Ejecuta TestAccResourceBasic en el paquete internal/provider e investiga una pista faltante de TF_LOG” le da a la skill suficiente contexto para elegir rápido el camino correcto.

Comparte los detalles del fallo, no solo el estado de fallo

Si la primera ejecución falla, incluye la salida completa de la prueba, los mensajes de variables faltantes y si el resultado cambió después de -count=1 o -v. La skill run-acceptance-tests mejora cuando le das la forma real del fallo, porque las pruebas de aceptación de proveedores suelen fallar por motivos distintos: autenticación, disponibilidad de la API remota, deriva del estado o inestabilidad de la prueba.

Usa las opciones de depuración en el orden correcto

Pide primero la mínima escalada necesaria y amplía solo si la evidencia lo exige. En el uso de run-acceptance-tests, eso suele significar empezar con un único nombre TestAcc bien enfocado y luego añadir salida verbosa, registros de depuración o persistencia del workspace solo después de saber qué necesitas inspeccionar.

Itera sobre la prueba, no solo sobre el comando

Si necesitas confirmar que una prueba que pasa realmente aporta señal, cambia una comprobación o un paso y vuelve a ejecutarla en lugar de repetir solo el mismo comando. Eso hace que la skill run-acceptance-tests sea más valiosa para Acceptance Testing, porque te ayuda a distinguir un pase real de un falso negativo y a afinar con el tiempo la señal de la prueba.