Code Refactor

Refactorizaciones disciplinadas de renombrado/reemplazo en múltiples archivos con protecciones para casos límite y APIs que rompen compatibilidad

Por mhattingpete · mhattingpete/claude-skills-marketplace

Probado · Funciona ★ 8.0/10

Code Refactor — Refactorizaciones disciplinadas de renombrado/reemplazo en múltiples archivos con protecciones para casos límite y APIs que rompen compatibilidad

Qué hace

Una habilidad de refactorización que guía a Claude a través de un bucle de buscar-analizar-informar-ejecutar-verificar-probar para cambios masivos de código como renombrar identificadores, reemplazar patrones obsoletos y actualizar llamadas a API. Se activa cuando un usuario pide renombrar una variable/función en varios archivos, reemplazar todas las instancias de un patrón o realizar cambios consistentes en múltiples ubicaciones. Para 1-9 archivos usa Grep+Edit nativo; para más de 10 archivos, lo entrega a un entorno de ejecución de código Python para ahorrar tokens.

Informe de la prueba

Se construyeron dos proyectos JS idénticos de 3 archivos y se ejecutó la misma tarea: renombrar getUserData -> fetchUserData. La REFERENCIA (reemplazo global ingenuo) mutó las 7 ocurrencias, incluyendo el literal de cadena `const label = "getUserData"` y `console.log('getUserData called')`. La ejecución de la HABILIDAD siguió el bucle buscar->analizar->ejecutar->verificar del cuerpo y sus reglas "Cadenas/comentarios: preguntar si se debe actualizar" / "APIs exportadas: advertir sobre cambios que rompen compatibilidad": renombró solo los 3 sitios de identificadores genuinos (def, import, call) más el comentario de documentación descriptivo, y dejó intactos el literal de cadena heredado y el mensaje de registro. Se verificó que api.code_transform.rename_identifier referenciado existe (obtención sin procesar HTTP 200); sin problemas de seguridad (sin curl|sh, base64 o exfiltración). El modo nativo es autónomo; el modo de ejecución depende de un entorno de ejecución externo no incluido en el directorio de la habilidad.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/mhattingpete/claude-skills-marketplace.git /tmp/code-refactor-src
mkdir -p ~/.claude/skills
cp -R /tmp/code-refactor-src/code-operations-plugin/skills/code-refactor ~/.claude/skills/code-refactor
# Native mode (1-9 files) is self-contained: uses built-in Grep + Edit tools, no extra deps.
# Execution mode (10+ files) additionally needs the repo's execution-runtime/api/ package
#   (code_transform.py etc.) importable on PYTHONPATH via the companion `code-execution` skill.
#   That runtime is NOT copied by the command above; only native mode works out of the box.

Comandos y prompts de ejemplo

/code-refactorRefactorizaciones disciplinadas de renombrado/reemplazo en múltiples archivos con protecciones para casos límite y APIs que rompen compatibilidad

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

Rename this function across every file in the repo
Replace all deprecated API calls with the new method
Update this pattern consistently in all locations

Informe completo →