Skills: Gerenciamento e Injeção de Contexto
Última atualização: 2026-08-31
Uma IA sem contexto é como um viajante sem mapa — por mais capaz que seja, vai se perder.
1. Tipos de contexto
(1) Contexto do projeto
Informações em nível de projeto, normalmente extraídas automaticamente de arquivos de configuração:
Fontes de contexto do projeto
├── package.json / pyproject.toml → Stack tecnológica, versões de dependências
├── .eslintrc / ruff.toml → Regras de estilo de código
├── tsconfig.json → Configuração TypeScript
├── Dockerfile / docker-compose.yml → Ambiente de deploy
├── README.md → Descrição do projeto
└── .gitignore → Regras de exclusão
(2) Contexto da equipe
Convenções e acordos em nível de equipe:
# .claude/team-context.yaml
team:
name: "Equipe de Plataforma"
conventions:
- "Funções não devem exceder 30 linhas"
- "Obrigatório escrever type hints"
- "APIs devem ter documentação Swagger"
stack: "Python + FastAPI + PostgreSQL"
code_owner: "alice"
(3) Contexto da conversa
Informações acumuladas na conversa atual:
O contexto da conversa inclui:
- O que o usuário já disse
- O que a IA já fez
- Arquivos que já foram lidos
- Estado atual do progresso da tarefa
2. Métodos de injeção de contexto
(1) Injeção automática
A plataforma detecta e injeta automaticamente informações do projeto:
---
name: smart-review
context:
auto_inject:
- project_config
- git_diff
- test_results
---
(2) Referência manual
Referencie explicitamente variáveis de contexto nos prompts:
## Regras de revisão
O projeto atual usa {{project.language}}, seguindo estas regras:
- Estilo de código: configuração {{project.linter}}
- Versão alvo do Python: {{project.python_version}}
(3) Montagem de arquivos
Carregue arquivos específicos como contexto:
context:
files:
- path: ".claude/review-rules.md"
description: "Regras de revisão da equipe"
- path: "docs/api-spec.yaml"
description: "Documento de especificação da API"
3. Gerenciamento da janela de contexto
(1) Planejamento de capacidade
Estratégia de alocação da janela de contexto:
Capacidade total: 200K tokens
├── Prompt do sistema: ~2K
├── Prompt do Skill: ~5K
├── Contexto do projeto: ~10K
├── Histórico da conversa: ~50K
├── Saída de ferramentas: ~80K
└── Espaço reservado: ~53K
(2) Recorte baseado em prioridade
Quando o contexto excede os limites, recorte por prioridade:
| Prioridade | Conteúdo | Estratégia de recorte |
|---|---|---|
| 🔴 Não recortável | Prompt do Skill, tarefa atual | Manter |
| 🟡 Comprimível | Histórico da conversa | Manter as N rodadas recentes |
| 🟢 Recortável | Saída antiga de ferramentas, contexto do projeto | Truncar ou resumir |
(3) Estratégia de sumarização
# Dicas de compressão de contexto
1. Conteúdo de arquivos → Manter apenas assinaturas de funções e linhas-chave
2. Saídas longas → Manter resumo + dados-chave
3. Resultados de busca → Manter apenas linhas correspondentes e caminhos
4. Histórico da conversa → Manter registros de decisões, descartar tentativas e erros
4. Contexto na prática
▶ Exemplo: Revisão de código com consciência de contexto
Alice projetou um Skill de revisão que percebe automaticamente o ambiente do projeto:
---
name: context-aware-review
context:
auto_inject:
- project_config
- git_diff
files:
- path: ".claude/team-rules.md"
---
## Revisão adaptativa
Ajuste automaticamente com base na stack tecnológica do projeto:
- Detectado pyproject.toml → Revise pelas convenções Python
- Detectado tsconfig.json → Revise pelas convenções TypeScript
- Detectado arquivo de regras da equipe → Priorize as convenções da equipe
Bob disse: "Um bom Skill não é um checklist genérico — é um assistente inteligente que ajusta automaticamente a estratégia com base no ambiente."
❓ Perguntas Frequentes
P: Contexto demais afeta o desempenho? R: Sim. Contexto mais longo significa respostas mais lentas e custos maiores. Recomenda-se injetar apenas informações necessárias e usar resumos em vez de texto completo. P: Como um Skill pode perceber a stack tecnológica do projeto? R: Use a auto-injeção
project_config, ou peça à IA no prompt para detectar arquivos de configuração primeiro antes de decidir a estratégia de revisão. P: Onde colocar arquivos de convenções da equipe? R: Recomenda-se.claude/team-rules.mdouCONVENTIONS.mdna raiz do projeto, facilitando a descoberta automática pela IA.
📖 Resumo
- Três tipos de contexto: projeto, equipe, conversa
- Três métodos de injeção: injeção automática, referência manual, montagem de arquivos
- Gerenciamento de janela: planejamento de capacidade, recorte por prioridade, compressão por sumarização
- Princípio central: injetar apenas informações necessárias, evitar inchaço de contexto
📝 Exercícios
- Básico (dificuldade⭐): Adicione auto-injeção de contexto do projeto ao seu Skill, observe mudanças no comportamento da IA.
- Intermediário (dificuldade⭐⭐): Crie um arquivo de convenções da equipe e projete um Skill que o referencie como contexto.
- Avançado (dificuldade⭐⭐⭐): Projete uma estratégia de gerenciamento de janela de contexto para uma revisão completa de projeto sob um limite de 128K tokens.
