¿Qué hace esta skill?

La Refactor de Código Seguro Skill orquesta la reestructuración de código mejorando su estructura interna sin alterar el comportamiento externo. Verifica que las pruebas existentes están en verde, planifica los cambios en pasos incrementales, ejecuta el refactor con control continuo de tests y confirma un commit con prefijo refactor: cuyo diff es estrictamente neutral respecto al comportamiento.

Extracción de módulos
Aísla clientes HTTP, bases de datos o lógicas de negocio en componentes separados sin romper el sistema.
Limpieza de código muerto
Elimina duplicación, dependencias no utilizadas y código muerto con herramientas como knip o depcheck.
Renombrado y claridad
Reduce anidamiento y renombra variables o funciones para mejorar la legibilidad del código.
Mejora arquitectónica
Reestructura la arquitectura general sin introducir nuevas funcionalidades, garantizando seguridad total.

Ejemplos de uso

📦 Extracción de cliente HTTP
Extrae el cliente HTTP de NWS de poller.py manteniendo las pruebas en verde y confirma el commit con prefijo refactor:
🧹 Limpieza de dependencias
Elimina el código muerto y las dependencias no utilizadas en el módulo de pagos usando knip y depcheck
✏️ Reducir anidamiento
Refactoriza la función processOrder para reducir el anidamiento y renombrar las variables poco claras
🏗️ Aislar lógica de negocio
Aísla la lógica de cálculo de impuestos en un componente separado sin alterar el comportamiento del sistema

Características

Verificación de pruebas previa Confirma que las pruebas existen y están en verde antes de tocar el código; añade pruebas de caracterización si la cobertura es baja.
Puertas de control (Gates) Detiene la ejecución en Gate 1 (planificación) y Gate 2 (pre-commit) esperando validación explícita del usuario.
Refactor incremental Aplica cambios en pasos pequeños ejecutando las pruebas después de cada modificación para asegurar que siguen en verde.
Commit neutral garantizado El commit final con prefijo refactor: contiene un diff estrictamente neutral respecto al comportamiento del sistema.
Delegación a agentes especializados Puede delegar tareas específicas como limpieza de dependencias a agentes como refactor-cleaner (knip / depcheck).

Preguntas frecuentes

La skill detecta si la cobertura es baja y sugiere añadir primero pruebas de caracterización antes de proceder con el refactor.
En dos puertas de control: Gate 1 para aprobar el plan de refactor y Gate 2 para confirmar el commit antes de ejecutarlo.
No. El diff resultante debe ser estrictamente neutral respecto al comportamiento; el commit lleva el prefijo refactor:.
Sí. La skill puede delegar a agentes como refactor-cleaner que usan herramientas como knip o depcheck para eliminaciones seguras.

Skills relacionadas

Mas skills de la misma categoria:

Refactor de Código Seguro — Reestructuración segura con Claude AI

¿Prefieres escuchar el contenido? Genera la narración de audio con un clic.