Habilidad de Estándares de Codificación Python Dignos
Estándares de codificación Python de calidad de producción para escribir código Python limpio, mantenible y moderno (versiones 3.10-3.13).
Cuándo Usar Esta Habilidad
Se activa automáticamente cuando los usuarios preguntan sobre:
- "haz esto más pitónico" / "es esto buen Python"
- "sugerencias de tipo" / "anotaciones de tipo" / "tipado"
- "LBYL vs EAFP" / "manejo de excepciones"
- "pathlib vs os.path" / "operaciones de rutas"
- "patrones de CLI" / "uso de click"
- "revisión de código" / "mejora este código"
- Cualquier pregunta sobre calidad o estándares de código Python
Nota: Esta habilidad son estándares generales de Python, no específicos de Dagster. Use
/dagster-expert para patrones de Dagster.
Cuándo Usar Esta Habilidad vs. Otras
| Necesidad del Usuario | Usar Esta Habilidad | Habilidad Alternativa |
|---|---|---|
| "haz esto más pitónico" | ✅ Sí - estándares Python | |
| "es esto buen Python" | ✅ Sí - calidad de código | |
| "sugerencias de tipo" | ✅ Sí - guía de tipado | |
| "LBYL vs EAFP" | ✅ Sí - patrones de excepción | |
| "pathlib vs os.path" | ✅ Sí - manejo de rutas | |
| "patrones específicos de Dagster" | ❌ No | /dagster-expert |
| "análisis de argumentos CLI" | ✅ Sí - patrones de CLI |
Conocimiento Central (SIEMPRE Cargado)
Detección de Versión
Identifique la versión mínima de Python del proyecto verificando (en orden):
pyproject.toml- Busque el camporequires-python(ej.,requires-python = ">=3.12")setup.pyosetup.cfg- Busquepython_requires- Archivo
.python-version- Contiene la versión como3.12o3.12.0 - Por defecto a Python 3.12 si no se encuentra un especificador de versión
Una vez identificada, cargue el archivo específico de la versión adecuado:
- Python 3.10: Cargar
versions/python-3.10.md - Python 3.11: Cargar
versions/python-3.11.md - Python 3.12: Cargar
versions/python-3.12.md - Python 3.13: Cargar
versions/python-3.13.md
Carga Condicional (Cargar Según Patrones de Tarea)
Los archivos centrales anteriores cubren más del 80% de los patrones de código Python. Solo cargue estos archivos adicionales cuando detecte patrones específicos:
Ejemplos de detección de patrones:
- Si la tarea menciona "click" o "CLI" -> Cargar
cli-patterns.md - Si la tarea menciona "subprocess" -> Cargar
subprocess.md
Estructura de la Documentación de Referencia
Los documentos de referencia están organizados en archivos de nivel superior y subdirectorios:
Referencias Centrales (junto a SKILL.md)
dignified-python-core.md- Estándares esenciales (siempre cargados)cli-patterns.md- Patrones de interfaz de línea de comandos (click, argparse)subprocess.md- Operaciones de subprocesos
Referencias Específicas de Versión (versions/)
versions/python-3.10.md- Características disponibles en Python 3.10+versions/python-3.11.md- Características disponibles en Python 3.11+versions/python-3.12.md- Características disponibles en Python 3.12+versions/python-3.13.md- Características disponibles en Python 3.13+
Temas Avanzados (references/advanced/)
exception-handling.md- Patrones LBYL, límites de errorinterfaces.md- Patrones ABC y Protocoltyping-advanced.md- Patrones de tipado avanzadosapi-design.md- Principios de diseño de API
Cuándo Leer Cada Documento de Referencia
references/advanced/exception-handling.md
Leer cuando:
- Escribiendo bloques try/except
- Envolviendo APIs de terceros que puedan lanzar excepciones
- Viendo o escribiendo
from eofrom None - No está seguro si existe una alternativa LBYL
references/advanced/interfaces.md
Leer cuando:
- Creando clases ABC o Protocol
- Escribiendo decoradores @abstractmethod
- Diseñando interfaces de capa de puerta de enlace
- Eligiendo entre ABC y Protocol
references/advanced/typing-advanced.md
Leer cuando:
- Usando typing.cast()
- Creando alias de tipo Literal
- Estrechando tipos en bloques condicionales
references/module-design.md
Leer cuando:
- Creando nuevos módulos Python
- Agregando código a nivel de módulo (más allá de constantes simples)
- Usando el decorador @cache a nivel de módulo
- Viendo Path() o cómputo a nivel de módulo
- Considerando importaciones en línea
references/api-design.md
Leer cuando:
- Agregando valores de parámetros por defecto a funciones
- Definiendo funciones con 5 o más parámetros
- Usando ThreadPoolExecutor.submit()
- Revisando firmas de funciones
references/checklists.md
Leer cuando:
- Revisión final antes de confirmar código Python
- No está seguro si ha seguido todas las reglas
- Necesita una consulta rápida de requisitos
Cómo Usar Esta Habilidad
- El conocimiento central se carga automáticamente (LBYL, pathlib, importaciones básicas, antipatrones)
- La detección de versión ocurre una vez: identifique la versión mínima de Python y cargue el archivo de versión adecuado
- Los documentos de referencia se cargan bajo demanda según los disparadores anteriores
- Patrones adicionales pueden requerir carga extra (patrones de CLI, subprocesos)
- Cada archivo es autocontenido con guía completa para su dominio