code-deduplication

Visão geral da skill de code-deduplication

A skill code-deduplication ajuda o Claude a evitar criar novo código quando uma função, módulo ou padrão existente já resolve a mesma tarefa. Ela é ideal para equipes que vivem adicionando lógica de “helper pequeno”, utilitários compartilhados e patches de refatoração que, aos poucos, viram comportamento duplicado. Se o seu objetivo é code-deduplication para Refactoring, esta skill faz o modelo verificar primeiro o que já existe e, só então, estender ou reutilizar em vez de reinventar a roda.

O que essa skill realmente faz

A skill se apoia em um índice de capacidades, geralmente CODE_INDEX.md, para que o modelo raciocine sobre o que a base de código já consegue fazer antes de escrever qualquer coisa nova. Isso a torna útil quando você quer menos helpers sobrepostos, abstrações compartilhadas mais limpas e menos divergência entre arquivos que resolvem o mesmo problema de formas um pouco diferentes.

Casos de uso ideais

Use a skill de code-deduplication quando estiver adicionando funções utilitárias, consolidando lógica de negócio ou limpando detalhes de implementação repetidos em um repositório. Ela é especialmente relevante quando a refatoração deve tocar vários arquivos e você quer que o modelo prefira extensão em vez de duplicação.

O que a diferencia

Ao contrário de um prompt genérico de “refatore isso”, esta skill adiciona uma disciplina de checar antes de escrever e um ciclo de manutenção depois das mudanças. Não se trata apenas de escrever menos código; trata-se de preservar as capacidades existentes, mapeá-las com clareza e fazer o novo código justificar sua existência.

Como usar a skill de code-deduplication

Instale e ative no seu fluxo de trabalho

Use o caminho code-deduplication install no seu gerenciador de skills e aplique-o antes de pedir novo código compartilhado ou trabalho de refatoração. O frontmatter do repositório marca essa skill como não invocável pelo usuário, então trate-a como uma skill de fluxo de trabalho em segundo plano: ela apoia o planejamento e a escrita do Claude, em vez de ser um comando independente que você executa diretamente.

Comece com o contexto certo do projeto

Antes de pedir algo, informe ao modelo o objetivo atual da feature, os arquivos relevantes e o índice existente, se houver. A skill funciona melhor quando consegue comparar o comportamento pretendido com o que já existe. Se você passar apenas um pedido vago como “deixe isso mais limpo”, o modelo terá informação de menos para detectar sobreposição com confiabilidade.

Formato de prompt que funciona bem

Um prompt forte de code-deduplication usage nomeia a capacidade que você quer, os arquivos envolvidos e o risco de duplicação. Por exemplo: “Refatore o fluxo de resumo de pagamento. Primeiro verifique se CODE_INDEX.md já cobre formatação, arredondamento e cálculo de impostos. Reutilize os helpers existentes se eles atenderem; só adicione novas funções se a capacidade não existir.” Isso dá ao modelo uma regra de decisão, não apenas uma tarefa.

Leia estes arquivos primeiro

Comece por SKILL.md e depois examine qualquer CODE_INDEX.md em nível de projeto ou notas de arquitetura equivalentes. Se o repositório já tiver um mapa de utilitários, guia de dependências ou política de refatoração, leia isso antes de editar o código. O valor da skill depende de encontrar oportunidades de reutilização cedo, não depois que a implementação já está em andamento.

FAQ da skill de code-deduplication

Isso é só para bases de código grandes?

Não. Repositórios menores também se beneficiam, especialmente quando a duplicação inicial fica difícil de desfazer depois. A skill é mais valiosa quando um “helper rápido” costuma virar mais três helpers com praticamente a mesma finalidade.

Como isso é diferente de um prompt normal de refatoração?

Um prompt normal pode melhorar o estilo sem impedir sobreposição. A skill de code-deduplication adiciona uma checagem estrutural: identificar capacidades existentes, comparar intenção, reutilizar ou expandir primeiro e atualizar o índice depois de escrever. Isso a torna mais adequada para code-deduplication para Refactoring do que um pedido genérico de reescrita.

Iniciantes precisam dessa skill?

Sim, se com frequência acabam criando código novo porque o código existente é difícil de encontrar. A skill pode reduzir duplicações acidentais ao forçar uma etapa de busca e decisão. Ela é menos útil se o repositório não tiver uma estrutura clara ou não houver disposição para manter um índice de capacidades.

Quando não devo usar?

Não dependa dela quando você precisar de um experimento pontual, um spike temporário ou uma nova capacidade sem sobreposição realista. Nesses casos, o processo de checar antes de escrever pode atrasar sem melhorar o resultado.

Como melhorar a skill de code-deduplication

Dê ao modelo objetivos no nível de capacidade

A melhor melhoria que você pode fazer é descrever a tarefa, não a forma desejada do arquivo. Diga “padronizar o parsing de datas em relatórios” em vez de “adicionar um helper”. Isso ajuda a skill de code-deduplication a comparar propósito, que é como ela decide se a reutilização é possível.

Traga sobreposições existentes à tona cedo

Forneça exemplos de funções suspeitamente parecidas, módulos próximos ou branches repetidos. Se você já sabe que duas implementações estão muito próximas, nomeie as duas e peça ao modelo para escolher um único dono. Isso reduz a chance de a primeira passagem criar uma nova duplicação por acidente.

Peça uma decisão explícita de reutilização

Um pedido forte de code-deduplication guide deve pedir três coisas: o que do código existente pode ser reutilizado, o que deve ser estendido e o que realmente precisa de código novo. Isso faz a saída ficar orientada a decisão, em vez de puramente geradora.

Itere com o índice depois da primeira passada

Depois que o modelo escrever o código, peça para atualizar ou rascunhar o índice de capacidades para que a próxima mudança tenha um mapa melhor. O principal modo de falha dessa skill não é uma implementação ruim; é perder o sinal de reutilização depois da refatoração. Manter o índice atualizado é o que torna a code-deduplication durável.