tdd es una skill de Desarrollo Guiado por Tests para crear funcionalidades, corregir errores y escribir pruebas duraderas con el ciclo rojo-verde-refactoriza. Prioriza pruebas centradas en el comportamiento a través de interfaces públicas, mocking solo en los límites y orientación práctica para automatización de pruebas, refactorización y diseño de interfaces.
Esta skill obtiene 78/100, lo que la convierte en una candidata sólida para el directorio: responde claramente a búsquedas sobre TDD y rojo-verde-refactoriza, y aporta suficiente guía de trabajo como para reducir dudas, aunque es más instructiva que una herramienta en sí y no incluye automatización de instalación ni archivos de soporte. Quienes busquen una guía práctica de TDD para agentes deberían considerarla; quienes necesiten una integración más profunda con un proyecto concreto quizá prefieran más estructura.
- Alta capacidad de activación: el frontmatter indica explícitamente que debe usarse para crear funcionalidades o corregir errores con TDD, rojo-verde-refactoriza, pruebas de integración o desarrollo primero en tests.
- La guía operativa es concreta: aborda pruebas sobre interfaces públicas, cuándo hacer mocking, diseño de interfaces para que sean testeables y candidatos a refactorización, con ejemplos de código y temas relacionados enlazados.
- Buena divulgación progresiva: el SKILL.md principal enlaza documentos complementarios específicos (tests, mocking, diseño de interfaces, refactorización, módulos profundos), de modo que un agente puede profundizar sin tener que adivinar.
- No hay comando de instalación ni archivos o scripts de soporte, así que la adopción se limita a leer la guía en lugar de ejecutar alguna automatización.
- El contenido apuesta de forma explícita por pruebas de integración y por evitar mocks internos, lo que puede no encajar con equipos que dependen mucho de estilos de TDD muy centrados en pruebas unitarias.
Panorama general de la habilidad tdd
tdd es una habilidad de Test-Driven Development para construir funcionalidades y corregir errores con el ciclo red-green-refactor. Es ideal para ingenieros que buscan una guía práctica de tdd que mantenga las pruebas alineadas con el comportamiento, no con la implementación. Si trabajas en una base de código donde los refactors son frecuentes, las interfaces importan y las pruebas frágiles te están frenando, esta habilidad te ayuda a escribir tests que resisten los cambios.
La tarea principal es sencilla: convertir una idea imprecisa de funcionalidad en una secuencia segura de pasos pequeños y testeables. La habilidad tdd resulta especialmente útil para automatización de pruebas, testing de estilo integración y código que se beneficia de límites más claros. Su postura más firme es probar a través de interfaces públicas y mockear solo en los verdaderos límites del sistema.
Para qué sirve tdd
Usa tdd cuando quieras un flujo de trabajo test-first para nuevo comportamiento, corrección de bugs o refactors que necesitan una red de seguridad. Encaja bien cuando ya conoces el resultado esperado, pero no el camino de implementación más limpio.
Qué hace diferente a esta habilidad tdd
El repo no se limita a “escribe primero los tests”. Empuja una disciplina concreta: evitar cortes horizontales, preferir pruebas centradas en el comportamiento y diseñar interfaces fáciles de testear. Eso hace que la habilidad tdd sea más útil que un prompt genérico cuando necesitas tests duraderos en lugar de rápidos y frágiles.
Cuándo tdd no es buena opción
Si necesitas un unit test rápido y puntual, un script desechable o verificar llamadas internas con mucho mock, probablemente esta no sea la herramienta adecuada. La habilidad está pensada para software que esperas refactorizar, donde la calidad del test importa más que la cantidad de tests.
Cómo usar la habilidad tdd
Instala y carga la habilidad
Usa el comando de instalación del directorio para el paso tdd install y abre primero SKILL.md. Después, lee tests.md, mocking.md, interface-design.md, refactoring.md y deep-modules.md para conocer las reglas que realmente condicionan la calidad de la salida.
Dale a la habilidad un comportamiento, no una solución
El mejor uso de tdd empieza con un resultado visible para el usuario, una entrada y un resultado esperado. Buen formato de prompt:
- “Añade validación en el checkout para que los carritos inválidos devuelvan un error claro y los válidos completen el pago”
- “Corrige el bug por el que los emails duplicados crean dos cuentas”
- “Escribe tests para un flujo de reintentos contra una API de pagos, usando la interfaz pública del servicio”
Mal formato de prompt:
- “Escribe tests para checkout”
- “Haz este módulo más testeable”
- “Mockea la base de datos y verifica que se llamó a la función”
Sigue el ciclo red-green-refactor
Empieza por el comportamiento observable más pequeño, escribe un único test que falle y lo demuestre, implementa el mínimo código para pasar y luego refactoriza manteniendo el test en verde. No agrupes primero todos los tests y dejes la implementación para después; la habilidad advierte explícitamente contra los cortes horizontales porque generan comportamiento imaginado en lugar de comportamiento probado.
Lee primero estos archivos
Para una ejecución práctica, prioriza:
SKILL.mdpara la filosofía y el flujo de trabajotests.mdpara patrones de tests buenos y malosmocking.mdpara mockear solo en los límitesinterface-design.mdpara hacer el código más fácil de testearrefactoring.mdpara saber qué mejorar después del primer pase en verde
Preguntas frecuentes sobre la habilidad tdd
¿tdd es solo para unit tests?
No. Esta habilidad tdd prefiere tests de estilo integración a través de interfaces públicas, lo que muchas veces la hace mejor para automatización de pruebas y testing de comportamiento que para setups aislados basados sobre todo en unit tests.
¿Necesito mockearlo todo?
No. Una regla central de esta tdd guide es mockear solo en los límites del sistema, como APIs externas, tiempo, aleatoriedad o, a veces, el sistema de archivos o la base de datos. No mockees tus propios módulos solo para que los tests pasen.
¿Pueden usar tdd los principiantes?
Sí, si pueden describir el comportamiento esperado con claridad. La principal curva de aprendizaje no es la sintaxis; es elegir el límite correcto y evitar tests sobre detalles de implementación.
¿En qué se diferencia tdd de un prompt normal?
Un prompt normal puede producir tests que apenas compilan. La habilidad tdd es más opinativa: empuja tests primero sobre comportamiento, incrementos pequeños y un diseño de interfaz que mantiene los tests estables durante los refactors.
Cómo mejorar la habilidad tdd
Empieza con una entrada más precisa
Obtendrás mejores resultados con tdd si incluyes el comportamiento, el límite y la restricción. Por ejemplo, di “construye un emisor de emails con reintento que use un wrapper real del servicio, pero mockea el tiempo y el proveedor externo” en lugar de “haz esto testeable”.
Vigila los modos de fallo más comunes
Los errores más frecuentes son abusar de los mocks, probar métodos privados y escribir tests que describen cómo funciona el código en vez de lo que ve el usuario. Si el primer borrador parece demasiado centrado en la implementación, revisa el prompt para nombrar la API pública y el resultado observable.
Itera del test al diseño
Después de la primera salida, usa los fallos para mejorar el diseño de la interfaz: parámetros más pequeños, valores de retorno más claros y menos efectos secundarios. Si el código sigue siendo difícil de testear, el problema quizá sea la forma de la API, no los tests.
Pide objetivos de refactor después de dejarlo en verde
Una vez cubierto el comportamiento, pide a la habilidad que identifique duplicación, métodos largos, módulos superficiales, feature envy o primitive obsession. Ahí es donde la habilidad tdd aporta valor extra: te ayuda a pasar de “tests que pasan” a un diseño más limpio que seguirá siendo fácil de testear.