243 lines
7.3 KiB
Markdown
243 lines
7.3 KiB
Markdown
# Modo Eficiência de Tokens
|
||
|
||
Reduz o uso de contexto nas respostas da IA em 30-50% através do modo de eficiência por compressão.
|
||
|
||
## Visão Geral
|
||
|
||
O Modo Eficiência de Tokens utiliza sistemas de símbolos visuais e abreviações para comprimir as respostas do Claude.
|
||
**A qualidade do código gerado e o conteúdo permanecem inalterados**. Apenas o método de explicação é alterado.
|
||
|
||
## Como Usar
|
||
|
||
```bash
|
||
# Ativar modo
|
||
"Responda no Modo Eficiência de Tokens"
|
||
"--uc mode"
|
||
"Modo conciso"
|
||
```
|
||
|
||
## Como Funciona
|
||
|
||
### 1. Sistema de Símbolos
|
||
|
||
#### Lógica e Fluxo
|
||
|
||
| Símbolo | Significado | Exemplo |
|
||
| ------- | -------------------- | ------------------------------------ |
|
||
| → | leva a, causa | `auth.js:45 → 🛡️ risco de segurança` |
|
||
| ⇒ | converte para | `entrada ⇒ saida_validada` |
|
||
| ← | reversão, voltar | `migration ← rollback` |
|
||
| ⇄ | bidirecional | `sync ⇄ remoto` |
|
||
| & | e, combinar | `🛡️ segurança & ⚡ performance` |
|
||
| \| | ou, separador | `react\|vue\|angular` |
|
||
| : | definir, especificar | `escopo: arquivo\|módulo` |
|
||
| » | então, sequência | `build » test » deploy` |
|
||
| ∴ | portanto | `testes ❌ ∴ código quebrado` |
|
||
| ∵ | porque | `lento ∵ algoritmo O(n²)` |
|
||
|
||
#### Status e Progresso
|
||
|
||
| Símbolo | Significado | Uso |
|
||
| ------- | ----------------- | ---------------------------- |
|
||
| ✅ | completo, sucesso | Tarefa concluída normalmente |
|
||
| ❌ | falhou, erro | Ação imediata necessária |
|
||
| ⚠️ | aviso | Revisão recomendada |
|
||
| 🔄 | em andamento | Atualmente ativo |
|
||
| ⏳ | pendente | Agendado para depois |
|
||
| 🚨 | urgente, crítico | Alta prioridade |
|
||
|
||
#### Domínios Técnicos
|
||
|
||
| Símbolo | Domínio | Uso |
|
||
| ------- | -------------- | ------------------------- |
|
||
| ⚡ | Performance | Velocidade, otimização |
|
||
| 🔍 | Análise | Busca, investigação |
|
||
| 🔧 | Configuração | Setup, ferramentas |
|
||
| 🛡️ | Segurança | Proteção, segurança |
|
||
| 📦 | Deploy | Pacote, bundle |
|
||
| 🎨 | Design | UI, frontend |
|
||
| 🏗️ | Arquitetura | Estrutura do sistema |
|
||
| 🗄️ | Banco de Dados | Persistência de dados |
|
||
| ⚙️ | Backend | Processamento do servidor |
|
||
| 🧪 | Testes | Garantia de qualidade |
|
||
|
||
### 2. Sistema de Abreviações
|
||
|
||
#### Sistema e Arquitetura
|
||
|
||
- `cfg` → configuração
|
||
- `impl` → implementação
|
||
- `arq` → arquitetura
|
||
- `perf` → performance
|
||
- `ops` → operações
|
||
- `env` → ambiente
|
||
|
||
#### Processo de Desenvolvimento
|
||
|
||
- `req` → requisitos
|
||
- `deps` → dependências
|
||
- `val` → validação
|
||
- `auth` → autenticação
|
||
- `docs` → documentação
|
||
- `std` → padrões
|
||
|
||
#### Qualidade e Análise
|
||
|
||
- `qual` → qualidade
|
||
- `seg` → segurança
|
||
- `err` → erro
|
||
- `rec` → recuperação
|
||
- `sev` → severidade
|
||
- `opt` → otimização
|
||
|
||
## Exemplos de Comparação
|
||
|
||
### Exemplo 1: Relatório de Erro
|
||
|
||
**Modo Normal (95 caracteres)**
|
||
|
||
```text
|
||
Vulnerabilidade de segurança encontrada na função de validação do usuário na linha 45 do sistema auth.
|
||
```
|
||
|
||
**Token Eficiente (44 caracteres)**
|
||
|
||
```text
|
||
auth.js:45 → 🛡️ vuln seg na val() usuário
|
||
```
|
||
|
||
### Exemplo 2: Status de Build
|
||
|
||
**Modo Normal (118 caracteres)**
|
||
|
||
```text
|
||
Processo de build foi concluído com sucesso. Testes estão sendo executados atualmente, seguidos pelo deploy.
|
||
```
|
||
|
||
**Token Eficiente (38 caracteres)**
|
||
|
||
```text
|
||
build ✅ » teste 🔄 » deploy ⏳
|
||
```
|
||
|
||
### Exemplo 3: Análise de Performance
|
||
|
||
**Modo Normal (105 caracteres)**
|
||
|
||
```text
|
||
Análise de performance revelou processamento lento devido à complexidade do algoritmo O(n²).
|
||
```
|
||
|
||
**Token Eficiente (46 caracteres)**
|
||
|
||
```text
|
||
⚡ perf: lento ∵ O(n²) → otimizar para O(n)
|
||
```
|
||
|
||
## Casos de Uso
|
||
|
||
### ✅ Cenários Efetivos
|
||
|
||
- **Sessões longas de debug**: Manter histórico eficientemente
|
||
- **Revisões grandes de código**: Análise concisa de muitos arquivos
|
||
- **Monitoramento CI/CD**: Atualizações de status em tempo real
|
||
- **Relatórios de progresso de projeto**: Visão geral de múltiplos estados de tarefa
|
||
- **Rastreamento de erros**: Representação visual de cadeias de problemas
|
||
|
||
### ❌ Cenários a Evitar
|
||
|
||
- Explicações para iniciantes
|
||
- Criação de documentação detalhada
|
||
- Definição de requisitos iniciais
|
||
- Comunicação com stakeholders não-técnicos
|
||
|
||
## Exemplos de Implementação
|
||
|
||
### Sessão de Debug
|
||
|
||
```text
|
||
[14:23] breakpoint → vars: {user: null, token: expirado}
|
||
[14:24] step → auth.validate() ❌
|
||
[14:25] check → token.exp < Date.now() ∴ expirado
|
||
[14:26] fix → refresh() → ✅
|
||
[14:27] continue → fluxo principal 🔄
|
||
```
|
||
|
||
### Resultados de Análise de Arquivos
|
||
|
||
```text
|
||
/src/auth/: 🛡️ problemas × 3
|
||
/src/api/: ⚡ gargalo no handler()
|
||
/src/db/: ✅ limpo
|
||
/src/utils/: ⚠️ métodos deprecated
|
||
/tests/: 🧪 cobertura 78%
|
||
```
|
||
|
||
### Status do Projeto
|
||
|
||
```text
|
||
Frontend: 🎨 ✅ 100%
|
||
Backend: ⚙️ 🔄 75%
|
||
Database: 🗄️ ✅ migrado
|
||
Testes: 🧪 ⚠️ 68% (meta: 80%)
|
||
Deploy: 📦 ⏳ agendado
|
||
Segurança: 🛡️ 🚨 1 crítico
|
||
```
|
||
|
||
## Opções de Configuração
|
||
|
||
```javascript
|
||
// Níveis de compressão
|
||
--uc; // Ultra Comprimido: Máxima compressão
|
||
--mc; // Moderadamente Comprimido: Compressão média
|
||
--lc; // Levemente Comprimido: Compressão leve
|
||
|
||
// Específico do domínio
|
||
--dev; // Compressão focada em desenvolvimento
|
||
--ops; // Compressão focada em operações
|
||
--seg; // Compressão focada em segurança
|
||
```
|
||
|
||
## Benefícios
|
||
|
||
1. **Economia de contexto**: Redução de 30-50% nos tokens
|
||
2. **Compreensão visual**: Compreensão intuitiva através de símbolos
|
||
3. **Densidade de informação**: Mais informação no mesmo espaço
|
||
4. **Retenção de histórico**: Manter conversas mais longas no histórico
|
||
5. **Reconhecimento de padrões**: Detecção mais fácil de problemas através de padrões visuais
|
||
|
||
## Observações
|
||
|
||
- Este modo apenas muda o **estilo de resposta da IA**
|
||
- **Qualidade do código** permanece inalterada
|
||
- Pode alternar com "explicar no modo normal" conforme necessário
|
||
- Modo normal recomendado para iniciantes e usuários não-técnicos
|
||
|
||
## Exemplos de Comandos
|
||
|
||
```bash
|
||
# Ativar
|
||
"Modo Eficiência de Tokens ligado"
|
||
"Responder de forma concisa"
|
||
"Analisar com --uc"
|
||
|
||
# Desativar
|
||
"Voltar ao modo normal"
|
||
"Explicar em detalhes"
|
||
"Modo Eficiência de Tokens desligado"
|
||
```
|
||
|
||
## Impacto da Implementação
|
||
|
||
| Item | Impacto |
|
||
| -------------------------- | -------------------- |
|
||
| Qualidade do código gerado | Sem mudança ✅ |
|
||
| Precisão da implementação | Sem mudança ✅ |
|
||
| Funcionalidade | Sem mudança ✅ |
|
||
| Método de explicação da IA | Comprimido 🔄 |
|
||
| Uso de contexto | Redução de 30-50% ⚡ |
|
||
|
||
---
|
||
|
||
💡 **Dica Pro**: Para sessões de trabalho longas, comece com o modo normal para construir entendimento, depois mude para o Modo Eficiência de Tokens para otimizar a eficiência e retenção de contexto.
|