Habilidades codebase-cleanup-refactor-clean
🧹

codebase-cleanup-refactor-clean

Seguro

Refactorizar Código a una Arquitectura Limpia y SOLID

¿Luchas con la deuda técnica, código duplicado y sistemas difíciles de mantener? Esta skill aplica patrones de refactorización probados y principios SOLID para transformar bases de código desordenadas en arquitecturas limpias, modulares y comprobables.

Soporta: Claude Codex Code(CC)
🥉 74 Bronce
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Pruébalo

Usando "codebase-cleanup-refactor-clean". Refactoriza esta clase OrderProcessor de 200 líneas que maneja validación, pagos, envíos y notificaciones por correo electrónico todo en un método.

Resultado esperado:

Separada en 5 clases enfocadas: OrderValidator, PaymentService, ShippingCalculator, EmailNotificationService y OrderOrchestrator. Redujo la complejidad del método de 45 a 8 por método. Agregó 18 pruebas unitarias con 92% de cobertura.

Usando "codebase-cleanup-refactor-clean". Nuestra base de código tiene un 30% de duplicación, especialmente en el manejo de errores y consultas de base de datos en todos los servicios.

Resultado esperado:

Extrajo el manejo de errores común en BaseExceptionHandler con 6 tipos de excepciones personalizadas. Creó GenericRepository con operaciones CRUD. Eliminó el 28% de duplicación, redujo la base de código en 1,400 líneas mientras mantenía la funcionalidad.

Auditoría de seguridad

Seguro
v1 • 2/25/2026

All 89 static analysis findings are false positives. The skill contains only markdown documentation with code examples for educational purposes. Detected patterns (backticks, file operations, network references) are part of fenced code blocks demonstrating refactoring concepts in Python, TypeScript, Go, and Java. No executable code, prompt injection attempts, or malicious patterns found. Safe for publication.

2
Archivos escaneados
934
Líneas analizadas
0
hallazgos
1
Auditorías totales
No se encontraron problemas de seguridad
Auditado por: claude

Puntuación de calidad

38
Arquitectura
100
Mantenibilidad
87
Contenido
50
Comunidad
100
Seguridad
91
Cumplimiento de la especificación

Lo que puedes crear

Modernización de Monolitos Heredados

Transforma funciones monolíticas de 500 líneas en una arquitectura limpia y modular con preocupaciones separadas para validación, lógica de negocio y acceso a datos.

Sprint de Limpieza de Deuda Técnica

Elimina sistemáticamente la duplicación de código, extrae números mágicos a constantes y aplica principios SOLID en módulos de alto riesgo y modificados frecuentemente.

Revisión de Arquitectura Pre-Característica

Evalúa la calidad de la base de código antes del trabajo de características importantes, identificando oportunidades de refactorización que reducirían el riesgo de implementación y mejorarían la extensibilidad.

Prueba estos prompts

Limpieza Rápida de Código 
Revisa la base de código actual en busca de code smells y mejoras rápidas. Identifica números mágicos, mejora los nombres de variables, elimina código muerto y extrae cualquier código duplicado en funciones reutilizables.
Refactorización de Principios SOLID 
Analiza este código en busca de violaciones SOLID. Refactoriza para seguir los principios de Responsabilidad Única, Abierto/Cerrado, Sustitución de Liskov, Segregación de Interfaces e Inversión de Dependencias. Muestra comparaciones antes/después.
De Monolito a Arquitectura Modular 
Descompone este sistema monolítico en capas limpias: entidades de dominio, repositorios, servicios y validadores. Aplica inyección de dependencias y separa completamente las preocupaciones. Genera pruebas completas.
Priorización de Deuda Técnica 
Audita toda la base de código y prioriza la deuda técnica por impacto de negocio y riesgo. Proporciona una hoja de ruta de refactorización con estimaciones de esfuerzo, análisis de ROI y programación recomendada de sprints.

Mejores prácticas

  • Lee siempre el código existente antes de proponer cambios para entender el contexto y la lógica de negocio
  • Comienza con refactorizaciones de alto impacto y bajo esfuerzo como extraer números mágicos y mejorar nombres
  • Genera pruebas completas antes de refactorizar para garantizar la preservación del comportamiento
  • Divide las refactorizaciones grandes en commits pequeños y revisables que puedan probarse independientemente

Evitar

  • Evita reescribir módulos completos desde cero sin entender los requisitos existentes
  • No apliques patrones de diseño en todas partes — úsalos solo cuando resuelvan problemas reales
  • Nunca refactorices sin pruebas o mecanismo para validar la equivalencia funcional
  • No cambies múltiples preocupaciones no relacionadas en una sola iteración de refactorización

Preguntas frecuentes

¿Esta skill modificará mi código automáticamente?
No. La skill analiza el código y sugiere estrategias de refactorización. Tú revisas el plan, luego Claude aplica los cambios con tu aprobación usando las herramientas Edit.
¿Qué tipos de código puede refactorizar esta skill?
Funciona con Python, TypeScript, JavaScript, Go, Java, C#, Ruby y la mayoría de los lenguajes principales. Se enfoca en la estructura y el diseño, no en optimizaciones específicas del lenguaje.
¿Cómo sé si la refactorización es segura?
La skill genera pruebas completas antes de refactorizar y valida los cambios después. También identifica factores de riesgo como baja cobertura de pruebas y recomienda enfoques conservadores.
¿Esta skill puede corregir problemas de rendimiento?
Parcialmente. Identifica ineficiencias algorítmicas como operaciones O(n²) y sugiere estrategias de caché. Sin embargo, no reemplaza las herramientas de perfilado de rendimiento dedicadas.
¿Qué pasa si mi base de código no tiene pruebas?
La skill primero recomendará agregar cobertura de pruebas antes de refactorizar. Puede generar pruebas de caracterización para el comportamiento existente, luego proceder con refactorizaciones conservadoras.
¿Cuánto tiempo toma una refactorización típica?
Varía según el alcance. La limpieza rápida (nombres de variables, código muerto) toma minutos. La refactorización SOLID para una clase toma 30-60 minutos. La reestructuración arquitectónica mayor puede requerir múltiples sesiones durante varios días.

Detalles del desarrollador

Autor

sickn33

Licencia

MIT

Repositorio

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/codebase-cleanup-refactor-clean

Ref.

main

Estructura de archivos

📁 resources/

📄 implementation-playbook.md

📄 SKILL.md