model-hierarchy

Visão geral do skill model-hierarchy

O que o model-hierarchy faz

O skill model-hierarchy ajuda um agente a encaminhar o trabalho para o modelo mais barato que consiga executá-lo bem. Ele foi feito para cenários em que você quer controlar melhor os custos sem perder qualidade nas tarefas rotineiras. Se o seu fluxo está gastando tokens premium em leitura de arquivos, checagens de status, formatação ou buscas simples, este skill oferece um guia prático de hierarquia de modelos, em vez de depender só da intuição.

Quem deve instalar

Instale model-hierarchy se você executa um workflow com agente que cria subagentes, troca de modelo com frequência ou paga por muitas tarefas pequenas. Ele é especialmente útil para Workflow Automation, configurações no estilo Claude Code e qualquer ambiente em que a escolha errada de modelo aumente o gasto sem chamar atenção. Ele é menos útil se você já tiver lógica rígida de roteamento no código ou quase nunca trocar de modelo.

O que o torna diferente

O skill não é apenas “use um modelo mais barato”. Ele embute uma regra simples de decisão: tarefas rotineiras vão para a camada mais baixa, tarefas moderadas ficam no nível intermediário e só problemas realmente difíceis justificam raciocínio premium. Isso torna o model-hierarchy mais acionável do que um prompt genérico, porque dá ao agente um hábito repetível de classificação e um padrão claro para o trabalho de subagentes.

Como usar o skill model-hierarchy

Instale o model-hierarchy

O repositório foi pensado como um skill que você copia para o diretório de skills do seu agente ou para o contexto de prompt. No OpenClaw, o README do repo mostra a cópia de SKILL.md para o caminho de skills e a reinicialização do gateway. Em sistemas no estilo Claude Code / Codex, a instalação prática é colar as regras de roteamento em CLAUDE.md ou nas instruções do projeto. Se você estiver avaliando model-hierarchy install, verifique se o seu agente lê skills a partir de arquivos, instruções globais ou config local no repo.

Comece com a entrada certa

model-hierarchy usage funciona melhor quando você informa três coisas ao agente: o tipo de tarefa, a saída esperada e se a tarefa faz parte de um workflow maior. Entrada fraca: “me ajuda com este repo.” Entrada melhor: “Classifique isto como rotina ou moderado e então escolha o modelo mais barato que consiga ler config.json com segurança, resumir o resultado e informar o risco caso a classificação esteja errada.” Isso dá contexto suficiente para o skill fazer o roteamento correto.

Leia estes arquivos primeiro

Comece com SKILL.md para ver as regras de roteamento, depois examine README.md para padrões de instalação e examples/claude-code.md ou examples/openclaw.md para uso específico da plataforma. Se você quiser entender o comportamento em casos-limite, tests/scenarios.json é útil porque mostra como o skill classifica tarefas rotineiras versus moderadas. Esse é o caminho mais rápido para entender o model-hierarchy skill sem ler o repositório inteiro.

Use isso em um workflow

Um workflow prático com model-hierarchy é: classifique a tarefa, decida se ela é rotina/moderada/complexa e depois selecione o modelo aceitável mais barato antes da execução. Para subagentes, a regra padrão deve ser barato, a menos que o trabalho exija raciocínio profundo ou visão. Seja explícito quando a tarefa incluir entrada de imagem, leitura de gráficos ou outro trabalho não textual, porque modelos apenas de texto não devem ser usados nesses casos. Esse limite importa mais do que o custo em tokens.

FAQ do skill model-hierarchy

O model-hierarchy é só para OpenClaw?

Não. O OpenClaw é um padrão de integração suportado, mas o skill também faz sentido para Claude Code, Codex e outras pilhas de agentes que permitam definir comportamento de roteamento nas instruções. Se o seu sistema consegue seguir uma política de seleção de modelo, o model-hierarchy normalmente se encaixa.

Em que isso difere de um prompt normal?

Um prompt normal pede um comportamento pontual. O skill model-hierarchy fornece uma regra de roteamento reutilizável que o agente pode aplicar antes de cada tarefa. Isso o torna melhor para operações repetidas, agentes em segundo plano e fluxos sensíveis a custo, nos quais a escolha do modelo faz parte do trabalho.

Ele é amigável para iniciantes?

Sim, desde que você consiga distinguir tarefas rotineiras, moderadas e complexas. O skill é mais simples do que um mecanismo completo de políticas, mas ainda exige honestidade sobre a dificuldade da tarefa. Se você subclassificar como rotina um debugging difícil ou trabalho com visão, a economia desaparece quando o modelo falha e você precisa executar tudo de novo.

Quando eu não deveria usar?

Não use model-hierarchy como uma estratégia geral de rebaixar tudo. Se o trabalho exige debugging profundo, decisões de arquitetura, revisão de segurança ou entrada multimodal, o modelo mais barato geralmente é a escolha errada. Ele também é uma opção ruim se a sua organização já impõe a seleção de modelos no código com guardrails fortes.

Como melhorar o skill model-hierarchy

Dê rótulos de tarefa mais fortes

A forma mais rápida de melhorar os resultados do model-hierarchy é declarar a categoria da tarefa logo no início. Boas entradas nomeiam a ação e a complexidade esperada: “busca rotineira em arquivo”, “rascunho de código moderado” ou “debugging complexo com falha anterior”. Isso reduz suposições e ajuda o agente a aplicar a camada correta já na primeira tentativa.

Descreva as restrições que afetam o roteamento

A escolha do modelo muda quando você menciona tamanho de contexto, entrada multimodal ou tolerância a falhas. Por exemplo: “Esta é uma tarefa de resumo apenas de texto a partir de um log de 200 linhas” ou “Isso exige análise de captura de tela, então evite modelos apenas de texto.” Esses detalhes importam porque expõem casos de incompatibilidade que o skill não deve tentar otimizar às cegas.

Itere depois da primeira passagem

Se a primeira saída parecer sofisticada demais, peça ao agente para reclassificar a tarefa e explicar por que escolheu esse nível. Se parecer fraca demais, solicite uma promoção de nível e identifique os sinais que faltaram: raciocínio entre arquivos, ambiguidade ou falha anterior. O model-hierarchy guide funciona melhor quando você o usa como checagem de roteamento, não como veredito único.

Fique atento aos modos de falha comuns

O principal modo de falha é tratar tarefas “simples à primeira vista” como rotina quando, na verdade, elas escondem dependências, casos-limite ou necessidade de visão. Outro é copiar o skill para um workflow sem dizer ao agente onde encontrar a política ou quando ignorá-la. Para melhorar model-hierarchy for Workflow Automation, mantenha a regra de roteamento próxima da origem da tarefa e deixe explícito o caminho de escalonamento.