Enrutador de Revisión Python
Usa este skill primero para la revisión de código Python. Oriéntate según el contexto, luego carga solo las habilidades enfocadas que coincidan con el código modificado.
Antes de Revisar: Oriéntate
-
Verifica la versión de Python desde
pyproject.toml,setup.cfg,tox.ini, CI o README.- Si
>=3.10: carga todas las habilidades principales relevantes, pero aplica cada regla solo cuando su condición de Python/herramienta coincida. - Si
3.8-3.9: omite reglas de sintaxis que requieran>=3.10. - Si se desconoce: asume mínimo 3.10, pero expresa los hallazgos sensibles a la versión de forma conservadora.
- Si
-
Clasifica la madurez del proyecto.
- Activo/nuevo desarrollo: el conjunto completo de reglas es apropiado.
- Legado maduro/solo mantenimiento: prioriza hallazgos CRÍTICOS y ALTOS.
- Automatización/scripts: prioriza seguridad, corrección, manejo de recursos y errores claros.
-
Verifica la cadena de herramientas.
- Si el proyecto usa
pyright, no recomiendes configuración específica demypy. - Si el proyecto usa
ruff, difiere los hallazgos de estilo/importaciones a su configuración. - Si no hay herramienta configurada, haz que las sugerencias de herramientas tengan baja severidad a menos que el problema esté relacionado con la corrección.
- Si el proyecto usa
-
Lee exactamente los archivos modificados antes de señalar problemas.
- Cita el archivo y la línea para cada hallazgo.
- No emitas hallazgos genéricos sin evidencia local.
- La coincidencia de una regla es una señal, no un veredicto.
Enrutamiento
| El código modificado afecta... | Carga | Omite cuando... |
|---|---|---|
anotaciones, Any, casts, genéricos, protocolos, APIs públicas | py-type-safety | el cambio es trivial y no tiene superficie tipada |
| excepciones, validación, limpieza, reintentos, fallos por lotes | py-error-handling | no se modificó ninguna ruta de fallo |
| valores predeterminados, configuración, uso de recursos, límites ORM/API, mezcla de I/O/lógica de negocio | py-anti-patterns | el cambio es solo de documentación/configuración |
async def, bucles de eventos, FastAPI/httpx/aio*, tareas, cancelación | py-async-patterns | el proyecto/cambio es solo síncrono |
| formato, nombres, importaciones, docstrings, configuración de lint/tipo | py-code-style | la salida de la herramienta ya lo cubre o la revisión solicitó solo corrección |
Nota de Portabilidad
La columna "Carga" te dice qué reglas de la habilidad enfocada aplicar para cada tipo de cambio. Cómo accedes a esas reglas depende de tu entorno de agente:
- Carga dinámica: Si tu agente soporta activar habilidades en medio de la sesión, haz que la habilidad nombrada sea detectable y actívala cuando la tabla de enrutamiento indique su ámbito.
- Lista de verificación estática: Lee el archivo
SKILL.mdde la habilidad enfocada directamente desde el directorio de habilidades y aplica sus reglas como lista de verificación de revisión.
Ambos enfoques producen el mismo resultado de revisión. La tabla de enrutamiento es el árbol de decisión; la habilidad enfocada proporciona el conjunto de reglas.
Salida de Revisión
Encabeza con errores y riesgos de comportamiento. Mantén los hallazgos solo de estilo detrás de los hallazgos de corrección. Para código legado, prefiere problemas accionables de alto impacto sobre consejos amplios de modernización.