python-anti-patterns

Resumen

¿Qué es python-anti-patterns?

python-anti-patterns es una skill práctica diseñada para ayudar a desarrolladores y equipos de Python a identificar y evitar errores comunes en el código. Ofrece una lista de verificación con los anti-patrones más frecuentes en bases de código Python, facilitando la detección de problemas antes de que lleguen a producción. Esta skill es especialmente útil para revisiones de código, depuración, refactorización de código legado y para establecer estándares de codificación en equipos.

¿Quién debería usar esta skill?

• Desarrolladores Python que quieran mejorar la calidad de su código
• Equipos que realizan revisiones de código o refactorizaciones
• Educadores que enseñan buenas prácticas en Python
• Cualquier persona que mantenga o depure proyectos en Python

Problemas que resuelve python-anti-patterns

• Reduce la deuda técnica al señalar malas prácticas
• Ayuda a prevenir errores sutiles causados por fallos comunes
• Facilita la revisión de código con una lista de verificación lista para usar
• Apoya la incorporación de nuevos miembros aclarando qué evitar en código Python

Cómo usar

Pasos de instalación

1. Instala la skill con el siguiente comando:

   npx skills add https://github.com/wshobson/agents --skill python-anti-patterns
   

2. Tras la instalación, comienza revisando el archivo SKILL.md para acceder a la lista completa de anti-patrones en Python.

Revisar y aplicar la lista de verificación

• Utiliza la lista durante las revisiones de código para detectar problemas temprano.
• Consulta los ejemplos para cada anti-patrón, como evitar lógica dispersa de timeout/reintentos y escenarios de doble reintento.
• Centraliza el manejo de errores y la lógica de reintentos según las recomendaciones para mejorar la mantenibilidad.

Adaptación a tu flujo de trabajo

• Integra la lista en el proceso de revisión de código de tu equipo.
• Úsala como herramienta didáctica para la incorporación de nuevos desarrolladores.
• Aplica las recomendaciones al refactorizar o depurar código existente.

Archivos sugeridos para explorar

• SKILL.md: Lista principal y guía de uso
• Skills relacionadas: Para patrones positivos, consulta python-design-patterns

Preguntas frecuentes

¿Cuándo debería usar python-anti-patterns?

Usa esta skill antes de fusionar código, al depurar errores difíciles de encontrar o al refactorizar código Python legado. También es útil para enseñar buenas prácticas y establecer estándares en el equipo.

¿Qué tipos de anti-patrones cubre?

La skill aborda problemas como lógica duplicada de timeout/reintentos, doble reintento en múltiples capas y otras trampas comunes que pueden causar errores o dificultades de mantenimiento.

¿Puedo usar esta skill con cualquier proyecto Python?

Sí, python-anti-patterns es independiente del tipo de proyecto dentro del ecosistema Python y puede aplicarse a cualquier base de código Python.

¿Esta skill reemplaza las guías de diseño positivas?

No, python-anti-patterns se enfoca en lo que se debe evitar. Para patrones recomendados y arquitectura, consulta la skill python-design-patterns.

¿Dónde puedo encontrar más detalles o ejemplos?

Abre la pestaña de Archivos para explorar todo el árbol de archivos, incluyendo SKILL.md con listas detalladas y ejemplos de código.