Pular para o conteúdo
Skillpedia
Agentes48 mil · #2645

context-optimization

Ajuda seu agente a usar melhor o espaço de informações disponível. Ele comprime e organiza os dados para que o agente possa processar mais informações.

O que ela faz

Esta ferramenta ajuda a IA a usar melhor a memória (contexto) que ela tem disponível. Ela faz isso resumindo informações antigas, guardando apenas o essencial, para que a IA possa lidar com mais dados ou conversas mais longas sem se perder.

Quando usar

  • ✓Quando a IA precisa lembrar de muitas informações de uma vez.
  • ✓Para fazer a IA responder mais rápido em conversas longas.
  • ✓Para processar documentos grandes sem que a IA se perca.

Exemplo do que pedir para a IA

“Resuma esta longa conversa para que eu possa entender os pontos principais.”

Quer saber mais? Abra as seções abaixo.

Como usar

O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.

Link da skill

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/context-optimization/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/context-optimization/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
Como funciona

A ferramenta identifica o que é mais importante na conversa ou nos documentos que a IA está lendo. Ela então cria resumos ou guarda apenas as partes cruciais, liberando espaço na memória da IA para novas informações.

Instalação

Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.

No terminal (Claude Code, Codex, Cursor), na pasta do projeto:

npx skills add sickn33/agentic-awesome-skills --skill context-optimization

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/context-optimization/SKILL.md -o SKILL.md
Conteúdo técnico (SKILL.md)

Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.

Técnicas de Otimização de Contexto

A otimização de contexto estende a capacidade efetiva de janelas de contexto limitadas através de compressão estratégica, mascaramento, cache e particionamento. O objetivo não é aumentar magicamente as janelas de contexto, mas sim fazer melhor uso da capacidade disponível. Uma otimização eficaz pode dobrar ou triplicar a capacidade de contexto efetiva sem a necessidade de modelos maiores ou contextos mais longos.

Quando Usar

Ative esta funcionalidade quando:

  • Limites de contexto restringem a complexidade da tarefa
  • Otimizando para redução de custos (menos tokens = custos menores)
  • Reduzindo a latência para conversas longas
  • Implementando sistemas de agentes de longa duração
  • Precisando lidar com documentos ou conversas maiores
  • Construindo sistemas de produção em escala

Conceitos Principais

A otimização de contexto estende a capacidade efetiva através de quatro estratégias principais: compactação (resumindo o contexto próximo aos limites), mascaramento de observação (substituindo saídas verbosas por referências), otimização de KV-cache (reutilizando computações em cache) e particionamento de contexto (dividindo o trabalho entre contextos isolados).

A percepção chave é que a qualidade do contexto importa mais do que a quantidade. A otimização preserva o sinal enquanto reduz o ruído. A arte reside em selecionar o que manter versus o que descartar, e quando aplicar cada técnica.

Tópicos Detalhados

Estratégias de Compactação

O que é Compactação Compactação é a prática de resumir o conteúdo do contexto ao se aproximar dos limites, e então reinicializar uma nova janela de contexto com o resumo. Isso destila o conteúdo de uma janela de contexto de maneira de alta fidelidade, permitindo que o agente continue com degradação mínima de desempenho.

A compactação geralmente serve como a primeira alavanca na otimização de contexto. A arte reside em selecionar o que manter versus o que descartar.

Implementação de Compactação A compactação funciona identificando seções que podem ser comprimidas, gerando resumos que capturam pontos essenciais e substituindo o conteúdo completo por resumos. A prioridade para compressão vai para saídas de ferramentas (substituir por resumos), turnos antigos (resumir conversas iniciais), documentos recuperados (resumir se houver versões recentes) e nunca comprimir o prompt do sistema.

Geração de Resumos Resumos eficazes preservam diferentes elementos dependendo do tipo de mensagem:

Saídas de ferramentas: Preservam descobertas chave, métricas e conclusões. Removem a saída bruta e verbosa.

Turnos de conversação: Preservam decisões chave, compromissos e mudanças de contexto. Removem preenchimento e idas e vindas.

Documentos recuperados: Preservam fatos e alegações chave. Removem evidências de suporte e elaboração.

Mascaramento de Observação

O Problema da Observação Saídas de ferramentas podem compor 80%+ do uso de tokens em trajetórias de agentes. Grande parte disso é saída verbosa que já cumpriu seu propósito. Uma vez que um agente usou uma saída de ferramenta para tomar uma decisão, manter a saída completa oferece valor decrescente enquanto consome contexto significativo.

O mascaramento de observação substitui saídas de ferramentas verbosas por referências compactas. A informação permanece acessível se necessário, mas não consome contexto continuamente.

Seleção de Estratégia de Mascaramento Nem todas as observações devem ser mascaradas igualmente:

Nunca mascarar: Observações críticas para a tarefa atual, observações do turno mais recente, observações usadas em raciocínio ativo.

Considerar mascarar: Observações de 3+ turnos atrás, saídas verbosas com pontos chave extraíveis, observações cujo propósito foi cumprido.

Sempre mascarar: Saídas repetidas, cabeçalhos/rodapés boilerplate, saídas já resumidas na conversa.

Otimização de KV-Cache

Entendendo o KV-Cache O KV-cache armazena tensores de Chave (Key) e Valor (Value) computados durante a inferência, crescendo linearmente com o comprimento da sequência. Armazenar o KV-cache em cache entre requisições que compartilham prefixos idênticos evita a recomputação.

O prefix caching reutiliza blocos de KV entre requisições com prefixos idênticos usando correspondência de blocos baseada em hash. Isso reduz drasticamente o custo e a latência para requisições com prefixos comuns, como prompts do sistema.

Padrões de Otimização de Cache Otimize para caching reordenando elementos de contexto para maximizar acertos de cache. Coloque elementos estáveis primeiro (prompt do sistema, definições de ferramentas), depois elementos frequentemente reutilizados, e elementos únicos por último.

Projete prompts para maximizar a estabilidade do cache: evite conteúdo dinâmico como timestamps, use formatação consistente, mantenha a estrutura estável entre sessões.

Particionamento de Contexto

Particionamento por Sub-Agente

…

Perguntas frequentes

Isso faz a memória da IA ficar maior?

Não, ela não aumenta a memória da IA, mas a faz usar o espaço que já existe de forma mais inteligente.

A IA vai esquecer coisas importantes?

O objetivo é justamente o contrário. A ferramenta foca em guardar o que é essencial e descartar o que é menos importante ou repetitivo, para não perder o fio da meada.

Quando devo usar essa ferramenta?

Use quando a IA parecer confusa com muitas informações, quando as respostas demorarem muito, ou quando você precisar que ela processe textos extensos.

Detalhes

Descrição original do autor

Context optimization extends the effective capacity of limited context windows through strategic compression, masking, caching, and partitioning. The goal is not to magically increase context windows but to make better use of available capacity.

repo: sickn33/agentic-awesome-skills

Popularidade

Estrelas no GitHub
48 mil
Posição no ranking
#2645
Licença
MIT
Atualizada em
15/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas