deteccao-inconsistencias-locais-nli
Detecta contradicoes logicas imediatas em paragrafos usando NLI local em tempo real enquanto o autor digita.
SKILL.md.agents/skills/deteccao-inconsistencias-locais-nli/SKILL.md
GitHubdeteccao-inconsistencias-locais-nli
Descrição
A skill deteccao-inconsistencias-locais-nli detecta contradições lógicas imediatas e de negação no micro-contexto (sentença recém-digitada vs. parágrafo anterior) de forma extremamente rápida. Ela utiliza modelos compactos de Reconhecimento de Implicação Textual (NLI - Natural Language Inference) executados localmente para fornecer feedback visual instantâneo no editor enquanto o escritor está digitando.
Quando usar
Gatilhos concretos e observáveis:
- O escritor conclui a redação de um parágrafo no editor de texto (gatilho disparado por tecla
EnterouSpaceapós ponto final). - Ocorre uma pausa na digitação ativa superior a 3 segundos (deteção de idle de teclado).
- O autor solicita explicitamente a checagem rápida do último bloco de texto digitado no painel do editor.
Quando NÃO usar:
- Para auditar a consistência lógica de eventos ao longo de múltiplos capítulos distantes (o processamento de NLI local deve ser restrito à janela imediata de contexto para evitar estouro de memória e latência).
- Em textos contendo descrições abstratas poéticas ou metáforas que não sigam lógica factual/declarativa direta.
Pré-requisitos
- Modelo NLI compacto local:
RoBERTa-large-MNLIdestilado (ex:distilroberta-base-nlirodando via ONNX/WebAssembly ou CPU local). - Limiar de tokenização: texto segmentado em sentenças limpas.
- Dados de entrada: a frase em digitação (Hipótese) e as últimas 500 a 1000 palavras anteriores (Premissa).
Processo (passo a passo executável)
- Extração de Contexto (Premissa): Capturar as últimas 500 a 1000 palavras (janela deslizante) anteriores à posição atual do cursor de digitação no editor. Rótulo:
Premissa. - Extração da Frase Ativa (Hipótese): Capturar a frase ativa em digitação ou o parágrafo recém-concluído. Rótulo:
Hipótese. - Inferência NLI Local:
- Alimentar o par
(Premissa, Hipótese)no modelo NLI local. - Extrair a distribuição de probabilidades softmax para as três classes lógicas:
entailment(acarreta),neutral(neutro), econtradiction(contradiz).
- Alimentar o par
- Validação de Negação Secundária:
- Se a classe
contradictionapresentar score superior a 80% (CONTRADICTION_THRESHOLD = 0.80), acionar uma checagem local baseada em regras regex de antônimos e modificadores de negação (ex: verificar presença de palavras como "não", "nunca", "jamais" combinadas a verbos idênticos presentes na premissa).
- Se a classe
- Gatilho de Sinalização:
- Se o score de contradição for mantido/confirmado pelo filtro secundário, marcar a linha correspondente no editor com um sublinhado ondulado vermelho.
- Apresentar um balão suspenso explicativo com a premissa anterior conflitante e o score da probabilidade NLI.
Parâmetros e configuração
CONTRADICTION_THRESHOLD: Limiar mínimo da probabilidade NLI de contradição para acionar alertas. Padrão:0.80.MAX_CONTEXT_WORDS: Janela de contexto anterior para atuar como premissa. Padrão:800palavras.DEBOUNCE_DELAY_MS: Tempo de espera após parar a digitação para disparar a inferência de forma transparente. Padrão:3000(3 segundos).
Armadilhas e como evitá-las
- Armadilha: Saturação de Atenção Global e Latência: tentar processar o livro completo em modelos locais de NLI causa estouro de memória RAM/VRAM e latências superiores a 10 segundos, quebrando a digitação em tempo real.
Mitigação: Restringir estritamente a janela de premissa a no máximo
1000palavras. Se uma busca global for necessária, delegar a auditoria em lote assíncrona ao fechamento de arquivos.
Critérios de validação (Definition of Done)
- O modelo NLI local atinge acurácia e F1-score de pelo menos 82% em testes sintéticos de pares de frases contraditórias (ex: "Kael estava trancado na torre" vs. "Kael correu livremente pelo jardim").
- A latência de inferência combinada com a renderização visual do editor é inferior a 250ms em ambiente de CPU local.
Fundamentação científica
- de Marneffe, M., Rafferty, A. & Manning, C. (2008) - Finding Contradictions in Text (taxonomia) - EMNLP 2008
- Anônimos (2025) - Straightforward Pipeline for Targeted Entailment and Contradiction Detection - arXiv 2025
- LiteReason (2025) - Lightweight Latent Reasoning for Narrative Tasks - arXiv 2025
Requisitos do projeto relacionados
- RF-46 (reconhecer contradições)
- RF-73 (verificar antes de salvar)
- RF-75 (explicar contradição)
Maturidade e riscos de adoção
Nível: Consolidada. A inferência discriminativa local de NLI em pares curtos de texto é previsível, com arquiteturas leves bem testadas em CPUs via ONNX Runtime.
Exemplos
Entrada:
{
"premissa": "A espada de Kael estava guardada no fundo do baú de ferro no sótão da estalagem.",
"hipotese": "Kael desembainhou sua espada brilhante e golpeou o guarda na taverna."
}
Saída esperada:
{
"is_contradiction": true,
"confidence": 0.89,
"explanation": "Conflito físico detectado: A espada está guardada no baú no sótão, mas o personagem a utilizou imediatamente na taverna."
}
Caso de falha conhecido: Marcar a frase como contradição se um personagem disser em diálogo "eu não tenho espada", interpretando como mentira lógica na premissa, quando é apenas uma fala do enredo.