context-compression
Ajuda seu agente a lidar com conversas muito longas. Ele comprime o histórico para que o agente não se perca e continue funcionando bem.
O que ela faz
Esta ferramenta ajuda a IA a lembrar de conversas longas, resumindo as partes mais importantes para que ela não se perca. Ela garante que a IA se concentre no que é essencial para completar uma tarefa.
Quando usar
- ✓Quando a conversa com a IA fica muito longa e ela começa a esquecer informações.
- ✓Ao trabalhar com projetos de código grandes que a IA não consegue 'ver' inteiros de uma vez.
- ✓Para criar resumos de conversas que a IA possa consultar depois.
Exemplo do que pedir para a IA
“IA, resuma nossa conversa até agora, focando nas mudanças de arquivos e nas decisões tomadas.”
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
Mensagem pronta para colar
Como funciona
A IA cria resumos estruturados da conversa, guardando informações importantes como intenções, arquivos modificados e próximos passos. Se a conversa ficar muito longa, ela resume a nova parte e junta com o resumo antigo.
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-compressionOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/context-compression/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Estratégias de Compressão de Contexto
Quando as sessões de agentes geram milhões de tokens de histórico de conversas, a compressão se torna obrigatória. A abordagem ingênua é a compressão agressiva para minimizar tokens por solicitação. O alvo de otimização correto é tokens por tarefa: tokens totais consumidos para completar uma tarefa, incluindo custos de re-busca quando a compressão perde informações críticas.
Quando Usar
Ative esta habilidade quando:
- Sessões de agentes excederem os limites da janela de contexto
- Bases de código excederem as janelas de contexto (sistemas de 5M+ tokens)
- Projetando estratégias de sumarização de conversas
- Depurando casos onde agentes "esquecem" quais arquivos modificaram
- Construindo frameworks de avaliação para qualidade de compressão
Conceitos Principais
A compressão de contexto troca economia de tokens contra perda de informação. Três abordagens prontas para produção existem:
Sumarização Iterativa Ancorada: Mantenha resumos estruturados e persistentes com seções explícitas para intenção da sessão, modificações de arquivos, decisões e próximos passos. Quando a compressão é acionada, resuma apenas o trecho recém-truncado e mescle com o resumo existente. A estrutura força a preservação ao dedicar seções a tipos específicos de informação.
Compressão Opaca: Produza representações comprimidas otimizadas para fidelidade de reconstrução. Alcança as maiores taxas de compressão (99%+) mas sacrifica a interpretabilidade. Não é possível verificar o que foi preservado.
Resumo Completo Regenerativo: Gere resumos estruturados detalhados em cada compressão. Produz saída legível mas pode perder detalhes em ciclos de compressão repetidos devido à regeneração completa em vez de mesclagem incremental.
A percepção crítica: a estrutura força a preservação. Seções dedicadas agem como checklists que o sumarizador deve preencher, prevenindo a deriva silenciosa de informação.
Tópicos Detalhados
Por Que Tokens-Por-Tarefa Importa
Métricas tradicionais de compressão visam tokens-por-solicitação. Esta é a otimização errada. Quando a compressão perde detalhes críticos como caminhos de arquivos ou mensagens de erro, o agente precisa re-buscar informações, re-explorar abordagens e desperdiçar tokens recuperando contexto.
A métrica correta é tokens-por-tarefa: tokens totais consumidos do início ao fim da tarefa. Uma estratégia de compressão que economiza 0,5% a mais de tokens mas causa 20% mais custos de re-busca custa mais no geral.
O Problema da Trilha de Artefatos
A integridade da trilha de artefatos é a dimensão mais fraca em todos os métodos de compressão, pontuando 2,2-2,5 de 5,0 em avaliações. Mesmo a sumarização estruturada com seções explícitas de arquivos luta para manter o rastreamento completo de arquivos em sessões longas.
Agentes de codificação precisam saber:
- Quais arquivos foram criados
- Quais arquivos foram modificados e o que mudou
- Quais arquivos foram lidos mas não alterados
- Nomes de funções, nomes de variáveis, mensagens de erro
Este problema provavelmente requer tratamento especializado além da sumarização geral: um índice de artefatos separado ou rastreamento explícito de estado de arquivo no scaffolding do agente.
Seções de Resumo Estruturado
Resumos estruturados eficazes incluem seções explícitas:
## Session Intent
[What the user is trying to accomplish]
## Files Modified
- auth.controller.ts: Fixed JWT token generation
- config/redis.ts: Updated connection pooling
- tests/auth.test.ts: Added mock setup for new config
## Decisions Made
- Using Redis connection pool instead of per-request connections
- Retry logic with exponential backoff for transient failures
## Current State
- 14 tests passing, 2 failing
- Remaining: mock setup for session service tests
## Next Steps
1. Fix remaining test failures
2. Run full test suite
3. Update documentation
Esta estrutura impede a perda silenciosa de caminhos de arquivos ou decisões porque cada seção deve ser explicitamente abordada.
Estratégias de Gatilho de Compressão
Quando acionar a compressão importa tanto quanto como comprimir:
| Estratégia | Ponto de Gatilho | Compromisso |
|---|---|---|
| Limiar fixo | 70-80% de utilização do contexto | Simples, mas pode comprimir muito cedo |
| Janela deslizante | Manter as últimas N turnos + resumo | Tamanho de contexto previsível |
| Baseado em importância | Comprimir primeiro seções de baixa relevância | Complexo, mas preserva o sinal |
| Limite de tarefa | Comprimir em conclusões lógicas de tarefa | Resumos limpos, mas timing imprevisível |
A abordagem de janela deslizante com resumos estruturados fornece o melhor equilíbrio entre previsibilidade e qualidade para a maioria dos casos de uso de agentes de codificação.
Avaliação Baseada em Sonda
…
Perguntas frequentes
Por que 'tokens' são importantes?
Tokens são como palavras ou pedaços de palavras que a IA usa para entender e gerar texto. Conversas longas usam muitos tokens, e esta ferramenta ajuda a reduzir esse número sem perder o essencial.
A IA pode esquecer quais arquivos ela mexeu?
Sim, isso pode acontecer em conversas muito longas. Essa ferramenta tenta manter um registro claro dos arquivos modificados para evitar que a IA se perca.
Qual a melhor forma de usar essa ferramenta?
Use-a quando a conversa estiver ficando longa ou quando precisar que a IA se lembre de detalhes específicos de projetos grandes. Resumos estruturados ajudam a IA a manter o foco.
Detalhes
Descrição original do autor
When agent sessions generate millions of tokens of conversation history, compression becomes mandatory. The naive approach is aggressive compression to minimize tokens per request.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #2635
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
agent-architecture-audit
Faz seu agente verificar se tudo está funcionando corretamente. Ele encontra e conserta problemas em sistemas de IA, garantindo que funcionem como esperado.
affaan-m/ECC
agent-eval
Ajuda seu agente a comparar diferentes ferramentas de programação de IA. Ele mede qual é mais rápido, barato e confiável para realizar tarefas específicas.
affaan-m/ECC
agent-harness-construction
Faz seu agente entender melhor como realizar tarefas. Ele otimiza as ferramentas e instruções que o agente usa para aumentar suas chances de sucesso.
affaan-m/ECC