Otimize Logs do Simplicité

Esta habilidade fornece a capacidade de analisar logs do Simplicité de um arquivo bruto .txt, filtrar campos para reduzir ruído e gerar o resultado como JSON estruturado. Isso é crucial para otimizar o tamanho do contexto da IA (economizando ~56% de tokens) e fornecer dados estruturados e previsíveis para solução de problemas.

Quando Usar Esta Habilidade

Use esta habilidade quando precisar:

• Analisar arquivos de log do Simplicité fornecidos pelo usuário no formato .txt.
• Evitar a ingestão de arquivos de log brutos massivos na sua janela de contexto.
• Extrair campos estruturados (como timestamp, level, body) de saídas de log verbosas de várias linhas.

IMPORTANTE: Em vez de ler diretamente um arquivo de log bruto .txt fornecido pelo usuário usando ferramentas de leitura de arquivo, você deve usar um dos scripts de conversão de log (PowerShell ou Python) para analisar o arquivo em formato JSON primeiro, extraindo opcionalmente apenas os campos necessários.

Pré-requisitos

• Acesso ao script PowerShell (/scripts/SimpliciteLog2Json.ps1) ou ao script Python (/scripts/simplicite-log2json.py).

Capacidades Principais

1. Otimização de Contexto

Reduz os tokens consumidos por logs grandes do Simplicité, extraindo apenas os campos de log relevantes (por exemplo, body, timestamp, level) e descartando dados de log estruturais não relevantes (como app, endpoint, contextPath).

2. Suporte a Múltiplas Linhas

Captura corretamente rastreamentos de pilha e erros de várias linhas dentro do campo body da estrutura JSON, o que uma simples busca de texto pode não capturar.

3. Suporte a Stdout

Se nenhum caminho de saída for fornecido para o arquivo JSON (por exemplo, omitindo --output ou -Output), o JSON analisado será impresso diretamente no stdout, permitindo que você canalize a saída para outras ferramentas.

Resumo da Saída

Após o processamento, a ferramenta imprime um resumo no stderr (ou console):

Processed: 123 entries, Skipped: 2 entries

Exemplos de Uso

Exemplo 1: Versão Python (Recomendado)

Converta um arquivo de log para JSON, mantendo apenas os campos mais importantes:

python /absolute/path/to/skills/optimize-simplicite-logs/scripts/simplicite-log2json.py <input.txt> --include timestamp,level,body --output <output.json>

Exemplo 2: Versão PowerShell

/python /absolute/path/to/skills/optimize-simplicite-logs/scripts/SimpliciteLog2Json.ps1 -InputPath "<input.txt>" -Output "<output.json>" -Include "body,timestamp,level"

Após gerar o <output.json>, você pode ler com segurança o arquivo resultante para realizar sua análise.

Diretrizes

1. Sempre Converta Primeiro: Nunca leia diretamente arquivos de log .txt do Simplicité usando ferramentas padrão de leitura de texto. Sempre converta-os para JSON usando os scripts disponíveis.
2. Filtre Campos: Use --include (Python) ou -Include (PowerShell) para restringir os campos ao que é absolutamente necessário para diagnosticar o problema (geralmente timestamp,level,body).
3. Campos Disponíveis: Os campos que você pode filtrar incluem: timestamp, app, level, endpoint, contextPath, event, user, class, function, rowId, body.

Padrões Comuns

Padrão: Solução Rápida de Problemas Contextual

# 1. Run the script to generate a minified JSON output in the current directory
python /absolute/path/to/skills/optimize-simplicite-logs/scripts/simplicite-log2json.py logs.txt --include timestamp,level,body --output logs_minified.json

# 2. Then read logs_minified.json to understand the context.

Limitações

• O analisador depende de um padrão regex fixo que corresponde à saída de log padrão do Simplicité. Se o formato do log foi amplamente personalizado, a análise pode falhar ou degradar.