CodeSigils/py-review-skill

Habilidades portátiles de revisión de código Python para agentes compatibles con agentskills.io — enrutador más habilidades enfocadas en seguridad de tipos, manejo de errores, antipatrones, asincronía y estilo de código.

¿Qué es py-review-skill?

Este skill actúa como un enrutador central para la revisión de código Python en agentes de IA compatibles con agentskills.io. Proporciona un proceso estructurado de orientación (versión de Python, madurez del proyecto, cadena de herramientas) y luego dirige al agente a habilidades enfocadas según el tipo de cambio de código. Las habilidades enfocadas cubren seguridad de tipos, manejo de errores, antipatrones, patrones asíncronos y estilo de código. Es útil porque evita la sobrecarga de aplicar reglas irrelevantes, prioriza hallazgos críticos según el contexto y se integra sin problemas con herramientas como ruff, mypy o pyright. El agente carga dinámicamente la habilidad adecuada o lee su documentación directamente, garantizando revisiones precisas y contextualmente relevantes.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add CodeSigils/py-review-skill

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

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

Documentación

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

  1. 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.
  2. 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.
  3. Verifica la cadena de herramientas.

    • Si el proyecto usa pyright, no recomiendes configuración específica de mypy.
    • 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.
  4. 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...CargaOmite cuando...
anotaciones, Any, casts, genéricos, protocolos, APIs públicaspy-type-safetyel cambio es trivial y no tiene superficie tipada
excepciones, validación, limpieza, reintentos, fallos por lotespy-error-handlingno se modificó ninguna ruta de fallo
valores predeterminados, configuración, uso de recursos, límites ORM/API, mezcla de I/O/lógica de negociopy-anti-patternsel cambio es solo de documentación/configuración
async def, bucles de eventos, FastAPI/httpx/aio*, tareas, cancelaciónpy-async-patternsel proyecto/cambio es solo síncrono
formato, nombres, importaciones, docstrings, configuración de lint/tipopy-code-stylela 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.md de 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.

Skills relacionados