provider-test-patterns

Descripción general de la skill provider-test-patterns

provider-test-patterns es una skill de pruebas de aceptación para proveedores de Terraform, pensada para equipos que usan terraform-plugin-testing con el Plugin Framework. Te ayuda a escribir, revisar y depurar tests de proveedor con menos ensayo y error que un prompt genérico, sobre todo cuando necesitas elegir el TestCase, TestStep, los checks de estado, los checks de plan, la verificación de importación o la configuración de sweepers correctos.

Mejor encaje y objetivo a resolver

Usa la skill provider-test-patterns cuando tu tarea real sea: “Necesito un patrón fiable de prueba de aceptación para un recurso de proveedor y quiero saber qué forma de test encaja con este escenario”. Es especialmente útil en trabajo de backend sobre providers, donde la dificultad no está solo en la sintaxis, sino en elegir la estrategia de aserción adecuada y la cobertura correcta del ciclo de vida.

Qué cubre bien

La skill provider-test-patterns destaca cuando necesitas orientación sobre:

• el flujo del ciclo de vida del test entre plan, apply, refresh y destroy
• la estructura de TestCase y TestStep
• ConfigStateChecks, plancheck y CompareValue
• pruebas de importación con ImportStateKind
• sweepers y seguridad en la limpieza
• patrones de escenarios como basic, update, disappears, validation y regression
• pruebas de recursos efímeros con el patrón echoprovider

Cuándo merece una instalación

Instala provider-test-patterns si quieres patrones con criterio que se mapean directamente a tests de aceptación de proveedores de Terraform, especialmente para equipos de backend que ya trabajan con el Plugin Framework. Encaja mejor que un prompt general cuando el principal riesgo es omitir un check obligatorio, usar el tipo de aserción equivocado o estructurar tests de una forma difícil de mantener.

Cómo usar la skill provider-test-patterns

Instálala y cárgala en contexto

Usa el flujo de instalación de tu gestor de skills, y luego abre primero SKILL.md. La skill upstream no define su propio comando de instalación, así que el paso práctico de provider-test-patterns install consiste en añadir la skill mediante el flujo de skills de tu agente y después leer la skill junto con las referencias de apoyo.

Empieza por la forma del test, no por el código

El mejor flujo de provider-test-patterns usage es describir el escenario antes de pedir código. Indica:

• tipo de recurso y fase del ciclo de vida
• si la cobertura es basic, update, import, disappears, validation o regression
• qué debe verificarse en el estado o en el plan
• si hace falta limpieza mediante sweepers
• si el caso involucra recursos efímeros

Eso le da a la skill suficiente estructura para elegir entre checks de configuración normales, statecheck, plancheck o comparaciones entre pasos.

Lee primero estos archivos

Para adoptarlo rápido, léelos en este orden:

1. SKILL.md para el conjunto principal de patrones y la guía del ciclo de vida
2. references/checks.md para statecheck, plancheck, valores conocidos y comparadores
3. references/ephemeral.md si el recurso es efímero o usa echoprovider
4. references/sweepers.md si te preocupa dejar recursos huérfanos

Patrón de prompt sólido

Un buen prompt para provider-test-patterns debe incluir el recurso, el modo de fallo y el estilo de aserción deseado. Por ejemplo:

Write an acceptance test for example_widget update behavior. I need a TestStep sequence that verifies the name changes, the old value is preserved until refresh, and the final state matches the new config. Use CompareValue if that is the right fit.

Eso es mejor que “escribe un test” porque le da a la skill un objetivo de decisión, no solo un tema.

Preguntas frecuentes sobre la skill provider-test-patterns

¿provider-test-patterns es solo para ingenieros de Terraform Provider?

Principalmente sí. Está diseñada para pruebas de aceptación de Terraform Provider y resulta más útil en provider-test-patterns for Backend Development, donde necesitas cobertura fiable de estado, plan y limpieza.

¿Necesito conocer ya terraform-plugin-testing?

No, pero la skill da por hecho que trabajas en ese ecosistema. Si eres nuevo, sigue siendo útil porque reduce la incertidumbre sobre la estructura del test, aunque conviene verificar los detalles con la documentación referenciada y con las convenciones de test ya existentes en tu provider.

¿En qué se diferencia de un prompt normal?

Un prompt normal puede generar un archivo de test plausible, pero provider-test-patterns es más útil cuando importa la elección de la aserción. Te ayuda a decidir si usar ConfigStateChecks, un plan check, un destroy check, verificación de import state o un patrón de sweeper según el propósito real del test.

¿Cuándo no debería usarla?

No la uses para tests unitarios genéricos, pruebas de Go sin relación directa o dudas rápidas solo de sintaxis. Tampoco encaja bien si no estás usando pruebas de aceptación de Terraform Provider, porque los patrones y las restricciones son específicos de ese flujo.

Cómo mejorar la skill provider-test-patterns

Da por adelantado los datos que faltan del test

La mejor forma de mejorar los resultados de provider-test-patterns es dar el conjunto mínimo de datos que cambia el diseño del test:

• nombre del recurso y paquete del provider
• si el recurso se crea, actualiza, importa o destruye
• los atributos exactos que hay que comprobar
• si los valores son estáticos, calculados, sensibles o dependen de otro paso
• si el test debe cubrir limpieza o recuperación de fugas

Menciona el fallo que intentas evitar

Si explicas qué puede salir mal, la skill puede elegir mejores aserciones. Por ejemplo, indícale si te estás protegiendo contra:

• drift después de refresh
• estado de importación incorrecto
• cambios de valores entre pasos
• limpieza de destroy ausente
• datos efímeros que no se pueden afirmar directamente

Esto es más útil que pedir un “ejemplo completo”, porque el patrón del test depende del modo de fallo.

Itera afinando las aserciones

Después de la primera respuesta, ajusta la petición con la brecha exacta que sigues viendo. Buenos seguimientos incluyen:

• “Haz que ConfigStateChecks verifique el formato del ID calculado.”
• “Reescribe esto como un test de importación con ImportStateKind.”
• “Añade un sweeper y muestra la configuración necesaria de TestMain.”
• “Convierte esto a un patrón de recurso efímero usando el enfoque echoprovider.”

Ese tipo de iteración mejora mucho más la salida de provider-test-patterns guide que pedir una versión más larga.