code-qualitylisted

# Code Quality Skill ## Cuándo usar esta skill - Antes de hacer commit de cualquier cambio. - Cuando corrijas errores de linting o tipos. - Cuando formatees código nuevo. - Cuando necesites verificar la calidad general del código. ## Herramientas de Calidad Este proyecto usa: | Herramienta | Propósito | |-------------|-----------| | **Ruff** | Linting + Formatting | | **Pyright** | Type checking | ## Flujo de Verificación Completo ### Paso 1: Formatear código ```bash uv run ruff format . ``` Aplica formato automático a todo el código. ### Paso 2: Verificar y corregir linting ```bash # Solo verificar uv run ruff check . # Corregir automáticamente lo posible uv run ruff check . --fix ``` ### Paso 3: Verificar tipos ```bash uv run pyright ``` ## Errores Comunes y Soluciones ### E501: Line too long **Problema**: Línea excede 88 caracteres. **Soluciones**: ```python # Antes mensaje = "Este es un mensaje muy largo que excede el límite de caracteres permitidos por el linter" # Después - usando paréntesis mensaje = ( "Este es un mensaje muy largo que excede " "el límite de caracteres permitidos por el linter" ) # Después - para docstrings, usar noqa """Línea muy larga que es difícil de partir. # noqa: E501""" ``` ### Missing type hints **Problema**: Función sin anotaciones de tipo. **Solución**: ```python # Antes def process(data): return data.upper() # Después def process(data: str) -> str: return data.upper() ``` ### Import ordering **Prob