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

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

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/context-compression/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-compression/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
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-compression

Ou 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.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.

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:

  1. 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.

  2. 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.

  3. 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.

repo: sickn33/agentic-awesome-skills

Popularidade

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

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas