recursive-decomposition

Visão geral da skill recursive-decomposition

A skill recursive-decomposition ajuda você a resolver tarefas grandes, com vários arquivos ou vários saltos, dividindo o trabalho em partes menores, processando cada uma de forma independente e depois consolidando os resultados. Ela é especialmente útil para recursive-decomposition em Workflow Automation, revisão em toda a base de código e extração em múltiplos documentos quando um único prompt ficaria superficial demais ou frágil demais.

Para que esta skill serve

Use a skill recursive-decomposition quando a tarefa não for “responder uma pergunta”, e sim “analisar com confiabilidade um grande volume de material”. Casos típicos incluem varrer muitos arquivos, comparar padrões em uma base de código inteira, extrair fatos estruturados de vários documentos ou montar um relatório consolidado a partir de fontes distribuídas.

O que a diferencia de um prompt normal

Um prompt normal pede que o modelo retenha tudo em uma única passagem. Esta skill leva você a uma divulgação progressiva: primeiro estreite o espaço de busca, depois recorra às partes relevantes e, por fim, sintetize. Essa é a principal vantagem quando o desgaste de contexto, a perda de arquivos ou a agregação inconsistente poderiam comprometer a qualidade da resposta.

Casos de uso em que ela funciona melhor

A skill recursive-decomposition é uma ótima opção quando você tem 10+ arquivos, 50k+ tokens ou uma tarefa que exige cobertura sistemática em vez de um resumo rápido. Ela é menos indicada para perguntas pequenas e localizadas, em que o processamento direto é mais barato e mais rápido.

Como usar a skill recursive-decomposition

Instale e ative

Para recursive-decomposition install, adicione a skill ao seu fluxo de trabalho no Claude Code ou em um ambiente com suporte a skills e chame-a quando a tarefa claramente ultrapassar o contexto de uma única passagem. O SKILL.md do repositório aponta para referências de apoio em references/, que é onde ficam as regras práticas de decisão.

Comece com a entrada certa

Dê à skill um objetivo, um limite de escopo e um formato de saída. Um bom input seria: “Analise o tratamento de erros em src/api, src/services e src/utils; retorne uma tabela com padrões, lacunas e recomendações.” Um input fraco seria: “Revise este repositório.”

Leia estes arquivos primeiro

Para usar recursive-decomposition, comece por SKILL.md e depois examine references/cost-analysis.md, references/codebase-analysis.md, references/document-aggregation.md e references/rlm-strategies.md. Esses arquivos mostram quando recursar, como particionar o trabalho e como agregar os resultados sem perder estrutura.

Fluxo de trabalho que gera melhores resultados

Use esta sequência: defina o escopo, identifique arquivos ou documentos candidatos, filtre com agressividade, agrupe os itens restantes, execute subtarefas em paralelo e então sintetize os achados em um único esquema. O guia de recursive-decomposition funciona melhor quando você especifica o que deve ser excluído, o que conta como evidência e como o resultado final deve ser organizado.

FAQ da skill recursive-decomposition

Quando devo usar recursive-decomposition?

Use quando a tarefa abranger muitos arquivos, muitos documentos ou um grande orçamento de tokens, e a completude importar mais do que a velocidade. Se o trabalho for local, restrito ou já estiver bem delimitado, o processamento direto geralmente basta.

recursive-decomposition serve só para bases de código?

Não. O mesmo padrão funciona para bases de código, notas de pesquisa, PRDs, relatórios longos e outros conjuntos de documentos. O requisito principal é que a tarefa se beneficie de filtragem, particionamento e agregação.

Qual é o principal modo de falha?

A falha mais comum é usar recursive-decomposition em uma tarefa mal especificada. Se você não definir o conjunto-alvo, o formato de saída ou os critérios de aceitação, a skill pode recursar com eficiência e ainda assim produzir um resultado disperso.

Esta skill é amigável para iniciantes?

Sim, desde que você consiga descrever um objetivo concreto e um limite de escopo. Em geral, iniciantes se saem melhor quando pedem um único entregável, como uma análise de lacunas, um inventário ou uma comparação, em vez de uma exploração aberta.

Como melhorar a skill recursive-decomposition

Dê à skill uma moldura de busca mais precisa

O melhor uso de recursive-decomposition começa com uma pergunta delimitada. Em vez de “revise o repositório”, diga “encontre todos os padrões de tratamento de erros em src/api e src/services, aponte inconsistências e resuma por módulo”. Um framing mais fechado reduz ruído e faz a recursão valer o custo adicional.

Forneça um esquema de extração

Se você quer saída estruturada, diga o que cada item deve conter. Por exemplo: arquivo, padrão, gravidade, evidência e recomendação. Isso ajuda a skill a manter os subtópicos paralelos comparáveis, em vez de narrá-los de maneiras diferentes.

Seja explícito sobre limites e exclusões

A lógica de decisão do repositório enfatiza contagem de tokens, número de arquivos e se a qualidade importa mais do que a latência. Se você conhece suas restrições, diga isso: “exclua testes”, “ignore documentos arquivados” ou