CommunityRedacción y edicióngithub.com

endalk200/habilidades

Colección de habilidades para agentes que utilizo en mi trabajo diario, que abarca tanto trabajo de ingeniería como no relacionado con ella.

¿Qué es habilidades?

Esta habilidad proporciona un marco completo para el desarrollo guiado por pruebas (TDD) dentro de flujos de trabajo de agentes de IA. Define el bucle rojo → verde → refactorización y detalla qué constituye una buena prueba (verificar el comportamiento a través de interfaces públicas), dónde deben colocarse las pruebas (en las costuras) y los antipatrones críticos a evitar, como pruebas acopladas a la implementación, tautologías y división horizontal. La habilidad enfatiza el trabajo en porciones verticales (una prueba → una implementación → repetir) para garantizar que las pruebas validen el comportamiento real del usuario en lugar de una estructura imaginada. También instruye a los agentes a consultar archivos de contexto del proyecto (CONTEXT.md) para mantener la coherencia con el lenguaje del dominio y los registros de decisiones de arquitectura (ADR). Ideal para desarrolladores que utilizan Claude Code, Cursor, Codex o plataformas similares, esta habilidad se integra con el flujo de trabajo de revisión de código para garantizar que las pruebas sigan siendo valiosos documentos vivos de especificaciones.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add endalk200/skills

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Desarrollo Guiado por Pruebas (TDD)

TDD es el bucle rojo → verde → refactorización. Esta habilidad es la referencia que hace que ese bucle produzca pruebas que valgan la pena: qué es una buena prueba, dónde van las pruebas, los antipatrones y las reglas del bucle. Cada sección se aplica en cada ciclo; consúltelas antes y durante el bucle, no después.

Al explorar el código base, lea CONTEXT.md (si existe) para que los nombres de las pruebas y el vocabulario de las interfaces coincidan con el lenguaje del dominio del proyecto, y respete los ADR en el área que está tocando.

Qué es una buena prueba

Las pruebas verifican el comportamiento a través de interfaces públicas, no detalles de implementación. El código puede cambiar por completo; las pruebas no deberían. Una buena prueba se lee como una especificación — "el usuario puede finalizar la compra con un carrito válido" te dice exactamente qué capacidad existe — y sobrevive a las refactorizaciones porque no le importa la estructura interna.

Vea tests.md para ejemplos y mocking.md para pautas de simulación.

Costuras — dónde van las pruebas

Una costura es el lugar donde el módulo bajo prueba presenta su interfaz: donde observas el comportamiento sin entrar en su interior. Las pruebas residen en las costuras, nunca contra los componentes internos.

Antes de escribir una prueba, identifica la costura bajo prueba. Si una interfaz pública existente es la costura obvia, indícala y procede. Si la costura es nueva o ambigua, confírmala primero con el usuario. No puedes probarlo todo — elegir las costuras deliberadamente es cómo el esfuerzo de prueba se concentra en las rutas críticas y la lógica compleja en lugar de en cada caso extremo.

Pregunta: "¿Cuál es la interfaz pública, y qué costuras deberíamos probar?"

Antipatrones

  • Acoplado a la implementación — simula colaboradores internos, prueba métodos privados o verifica a través de un canal secundario (consultando la base de datos en lugar de usar la interfaz). La señal: la prueba se rompe cuando refactorizas pero el comportamiento no ha cambiado.
  • Tautológico — la aserción recalcula el valor esperado de la misma manera que el código (expect(add(a, b)).toBe(a + b), una instantánea derivada manualmente de la misma manera, una constante afirmada igual a sí misma), por lo que pasa por construcción y nunca puede diferir del código. Los valores esperados deben provenir de una fuente independiente de verdad — un literal conocido como bueno, un ejemplo resuelto, la especificación.
  • División horizontal — escribir todas las pruebas primero, luego toda la implementación. Las pruebas masivas verifican un comportamiento imaginado: pruebas la forma de las cosas en lugar del comportamiento orientado al usuario, las pruebas se vuelven insensibles a cambios reales y te comprometes con la estructura de las pruebas antes de entender la implementación. Trabaja en porciones verticales en su lugar — una prueba → una implementación → repetir, cada prueba es una bala trazadora que responde a lo que el último ciclo te enseñó.

Reglas del bucle

  • Rojo antes que verde. Escribe la prueba fallida primero, luego solo el código suficiente para pasarla. No anticipes pruebas futuras ni añadas características especulativas.
  • Una porción a la vez. Una costura, una prueba, una implementación mínima por ciclo.
  • Refactoriza después del verde. Mejora nombres y estructura manteniendo el comportamiento sin cambios y las pruebas pasando. No añadas nuevo comportamiento durante la refactorización; los cambios arquitectónicos más amplios pertenecen a la etapa de revisión (consulta la habilidad code-review).

Skills relacionados