code-deduplication

Resumen de la habilidad de code-deduplication

La habilidad code-deduplication ayuda a Claude a evitar crear código nuevo cuando ya existe una función, módulo o patrón que resuelve la misma tarea. Es ideal para equipos que siguen añadiendo lógica de “pequeño helper”, utilidades compartidas y parches de refactorización que, poco a poco, acaban generando comportamiento duplicado. Si tu objetivo es hacer code-deduplication para Refactoring, esta habilidad empuja al modelo a revisar primero lo que ya existe y después ampliar o reutilizar, en lugar de reinventarlo.

Qué hace realmente esta habilidad

La habilidad se apoya en un índice de capacidades, normalmente CODE_INDEX.md, para que el modelo razone sobre lo que la base de código ya puede hacer antes de escribir nada nuevo. Eso la hace útil cuando necesitas menos helpers solapados, abstracciones compartidas más limpias y menos divergencia entre archivos que resuelven el mismo problema de formas ligeramente distintas.

Casos de uso que encajan mejor

Usa la habilidad de code-deduplication cuando vayas a añadir funciones de utilidad, consolidar lógica de negocio o limpiar detalles de implementación repetidos en un repositorio. Es especialmente relevante cuando un refactor va a tocar varios archivos y quieres que el modelo prefiera extender antes que duplicar.

En qué se diferencia

A diferencia de un prompt genérico de “refactoriza esto”, esta habilidad añade una disciplina de comprobar antes de escribir y un ciclo de mantenimiento después de los cambios. No se trata solo de escribir menos código; se trata de preservar capacidades existentes, mapearlas con claridad y hacer que el código nuevo justifique su existencia.

Cómo usar la habilidad de code-deduplication

Instálala y actívala en tu flujo de trabajo

Usa la ruta code-deduplication install desde tu gestor de habilidades y aplícala antes de pedir código compartido nuevo o trabajo de refactorización. El frontmatter del repositorio la marca como no invocable por el usuario, así que trátala como una habilidad de flujo de trabajo en segundo plano: apoya la planificación y el proceso de escritura de Claude, en lugar de ser un comando autónomo que ejecutes directamente.

Empieza con el contexto correcto del proyecto

Antes de hacer el prompt, dale al modelo el objetivo actual de la funcionalidad, los archivos relevantes y el índice existente, si lo tienes. La habilidad funciona mejor cuando puede comparar el comportamiento esperado con lo que ya existe. Si solo das una petición vaga como “hazlo más limpio”, el modelo tiene demasiada poca información para detectar solapamientos de forma fiable.

Formato de prompt que funciona bien

Un buen prompt de code-deduplication usage nombra la capacidad que buscas, los archivos implicados y el riesgo de duplicación. Por ejemplo: “Refactoriza el flujo de resumen de pagos. Primero comprueba si CODE_INDEX.md ya cubre formato, redondeo y cálculo de impuestos. Reutiliza los helpers existentes si encajan; solo añade funciones nuevas si la capacidad no existe.” Eso le da al modelo una regla de decisión, no solo una tarea.

Archivos que debes leer primero

Empieza por SKILL.md y después revisa cualquier CODE_INDEX.md a nivel de proyecto o notas de arquitectura equivalentes. Si el repositorio ya tiene un mapa de utilidades, una guía de dependencias o una política de refactorización, léelo antes de editar código. El valor de la habilidad depende de detectar pronto las oportunidades de reutilización, no cuando la implementación ya está en marcha.

Preguntas frecuentes sobre la habilidad de code-deduplication

¿Solo sirve para bases de código grandes?

No. Los repositorios pequeños también se benefician, sobre todo cuando una duplicación temprana luego resulta difícil de deshacer. La habilidad es más valiosa cuando un “helper rápido” tiende a convertirse en tres helpers más con casi el mismo propósito.

¿En qué se diferencia de un prompt normal de refactorización?

Un prompt normal puede mejorar el estilo sin impedir el solapamiento. La habilidad de code-deduplication añade una comprobación estructural: identificar capacidades existentes, comparar la intención, reutilizar o ampliar primero y actualizar el índice después de escribir. Eso la hace más adecuada para code-deduplication para Refactoring que una petición genérica de reescritura.

¿La necesitan los principiantes?

Sí, si suelen crear código nuevo porque el existente cuesta encontrarlo. La habilidad puede reducir duplicaciones accidentales al obligar a dar un paso de búsqueda y decisión. Es menos útil si el repositorio no tiene una estructura clara o no se mantiene un índice de capacidades.

¿Cuándo no debería usarla?

No la uses cuando necesites un experimento puntual, una prueba temporal o una capacidad nueva sin solapamiento realista. En esos casos, el proceso de comprobar antes de escribir puede ralentizarte sin mejorar el resultado.

Cómo mejorar la habilidad de code-deduplication

Dale al modelo objetivos a nivel de capacidad

La mejor mejora que puedes hacer es describir la tarea, no la forma del archivo deseado. Di “estandariza el parseo de fechas en los reportes” en lugar de “añade un helper”. Eso ayuda a la habilidad de code-deduplication a comparar el propósito, que es como decide si la reutilización es posible.

Haz visible antes el solapamiento existente

Aporta ejemplos de funciones sospechosamente parecidas, módulos cercanos o ramas repetidas. Si ya sabes que dos implementaciones son muy próximas, nombra ambas y pide al modelo que elija un único responsable. Así reduces la probabilidad de que la primera pasada cree un duplicado nuevo por accidente.

Pide una decisión explícita de reutilización

Una buena solicitud de code-deduplication guide debería pedir tres cosas: qué código existente se puede reutilizar, qué se debería ampliar y qué sí necesita código nuevo. Eso hace que la salida esté orientada a decisiones, no solo a generación.

Itera con el índice después de la primera pasada

Después de que el modelo escriba el código, pídele que actualice o redacte el índice de capacidades para que el siguiente cambio tenga un mejor mapa. El principal modo de fallo de esta habilidad no es una mala implementación; es perder la señal de reutilización después del refactor. Mantener el índice actualizado es lo que hace que code-deduplication sea sostenible.