humanizar

Humanizar (Humanize)

Revisa a prosa de um artigo LaTeX para torná-la mais fácil de ler e com a sonoridade de um autor humano cuidadoso, entregando o resultado como uma cópia separada do arquivo .tex.

O objetivo não é "disfarçar" nada. Rascunhos auxiliados por IA tendem a compartilhar uma textura reconhecível — excesso de sinalização, vocabulário inflado, ritmo uniforme, preenchimento com frases que não carregam informação. Revisores percebem isso, e isso torna os artigos mais difíceis de ler. Um bom editor humano remove essa textura fazendo com que cada frase diga algo específico da forma mais simples que ainda se encaixe no registro de um artigo acadêmico.

O que você não deve alterar

Um artigo é um registro de afirmações. Uma edição de legibilidade que altera uma afirmação é um bug, não uma escolha de estilo. Portanto:

• Deixe o preâmbulo intacto (tudo antes de \begin{document}).
• Nunca edite matemática: $…$ inline, \(…\), matemática em destaque e ambientes matemáticos (equation, align, …) permanecem idênticos byte a byte.
• Mantenha todos os \cite…, \ref/\eqref/\cref, \label, \includegraphics, \input e limites de ambiente. Você pode mover uma citação dentro de uma frase que reestruturar, mas as mesmas chaves ainda devem dar suporte à mesma afirmação.
• Mantenha todos os números na prosa (estatísticas, valores-p, tamanhos amostrais, intervalos) e sua ligação com a quantidade correta.
• Mantenha a força das afirmações. Não transforme "sugere" em "mostra" ou "não diferiu consistentemente" em "foram equivalentes". Hedge calibrado faz parte da ciência; remova apenas hedges empilhados ou vazios ("pode potencialmente", "poderia-se argumentar que talvez").
• Mantenha os termos técnicos do autor. Se o artigo define "regimes operacionais", "zona de segurança", "MRP", use exatamente esses termos. Não troque palavras técnicas por sinônimos — "robusto", "significante", "novel" são adequados quando são técnicos; só se tornam tiques de IA quando usados como decoração.
• Mantenha o idioma e a variante ortográfica (inglês britânico "behaviour/penalises" permanece britânico; português permanece português).
• Não mexa em conteúdos de tabela, comentários %, marcadores \todo{} ou na bibliografia.

Se uma frase não está clara de uma forma que você só pode corrigir adivinhando o que os autores queriam dizer, deixe-a como está e liste-a em seu relatório, em vez de reescrevê-la.

Fluxo de trabalho

1. Identificar o alvo

Pegue o arquivo da mensagem do usuário ou do argumento do comando de barra. Se nenhum for fornecido, infira-o da conversa (o artigo sendo trabalhado, ou o arquivo ativo do editor — get_editor_state se as ferramentas GilzaCode estiverem disponíveis); se vários arquivos .tex forem candidatos (ex.: main6.tex e main7.tex), escolha o rascunho mais recente e diga qual você escolheu. Se o usuário pediu apenas seções específicas, revise apenas essas.

Se o arquivo principal puxa conteúdo com \input/\include, humanize cada arquivo de prosa incluído em seu próprio <nome>_humanizado.tex e aponte as linhas \input da cópia principal para eles.

2. Fazer a cópia

Copie o arquivo para <stem>_humanizado.tex no mesmo diretório (para que figuras, .bib e arquivos de classe ainda sejam resolvidos). Se esse arquivo já existir, pergunte antes de sobrescrever, ou use <stem>_humanizado2.tex se não puder perguntar. Todas as edições vão para a cópia. Nunca escreva no original.

3. Obter um mapa dos problemas

Execute o scanner no original para ver onde os padrões de estilo de IA se concentram:

python <skill-dir>/scripts/ai_scan.py caminho/para/artigo.tex

Ele relata frases sinalizadas com números de linha, densidade de travessões e estatísticas de comprimento de frase por seção. Trate-o como um mapa de calor, não como uma lista de tarefas: um acerto é um lugar para olhar, e muitos acertos são normais no contexto. Remover cada palavra sinalizada enquanto mantém a estrutura da frase intacta produz um texto igualmente mecânico. Leia referencias/padroes.md para o catálogo completo de padrões (inglês e português) e para como corrigir cada tipo — leia-o antes de começar a editar.

4. Revisar, seção por seção

Leia uma seção (ou alguns parágrafos) de cada vez e edite a cópia com chamadas Edit direcionadas na prosa. Trabalhar parágrafo por parágrafo mantém o LaTeX intacto e permite que você mantenha o argumento da seção em mente.

Para cada parágrafo, pergunte: o que este parágrafo está afirmando, e qual é a maneira mais curta e clara que um autor competente nesta área diria isso? Então:

• Corte o que não carrega informação: metacomentários ("Vale notar que", "Nesta seção, discutiremos"), resumos repetidos ao final de parágrafos, aberturas de aquecimento, intensificadores decorativos.
• Prefira o concreto: substitua uma abstração vaga pela coisa específica ("melhora o desempenho" → "sobrevive 48 passos a mais", se o artigo disser isso em algum lugar próximo; caso contrário, apenas mantenha simples).
• Corrija a estrutura da frase para legibilidade: coloque sujeito e verbo próximos e perto do início; divida frases que carregam três ideias; junte fragmentos curtos que pertencem juntos; mova informações familiares para o início de uma frase e informações novas para o final; transforme nominalizações de volta em verbos ("realizar uma análise de" → "analisar").
• Varie o ritmo como uma pessoa faria — algumas frases curtas, algumas longas — em vez de uma cadência uniforme ou formas de parágrafo uniformes.
• Quebre estruturas formulaicas: tríades forçadas, "não só X mas também Y", contrastes "X, não Y" usados para efeito, revelações com dois pontos ("A resposta é simples: …"), cadeias de travessões e parágrafos que todos abrem com uma palavra de transição.
• Mantenha o que já funciona. Muitas frases em um rascunho decente estão boas. Tocar em todas as frases é, por si só, uma assinatura de IA e aumenta o risco de alterar o significado. Uma boa passagem típica reescreve entre um quinto e metade das frases, concentrando-se onde o scanner e sua leitura encontram problemas.

Títulos de seção, legendas e o resumo são prosa e podem ser editados com o mesmo cuidado; mantenha os títulos curtos e o conteúdo da legenda (o que é plotado, o que os símbolos significam) completo.

5. Verificar integridade

Execute o verificador comparando original e cópia:

python <skill-dir>/scripts/check_integrity.py caminho/para/artigo.tex caminho/para/artigo_humanizado.tex

Ele compara o preâmbulo, segmentos matemáticos, chaves de citação, referências, labels, ambientes, caminhos de gráficos, equilíbrio de chaves e números na prosa. Corrija todo ERROR antes de terminar. Examine cada WARN (geralmente um número ou citação que se moveu ou desapareceu) e restaure-o ou confirme que a alteração é inofensiva. Em seguida, execute novamente ai_scan.py na cópia para confirmar que os pontos críticos esfriaram.

Se um compilador LaTeX estiver disponível (compile_latex do GilzaCode, tectonic, latexmk, pdflatex), compile a cópia para garantir que ela compila. Não gaste muito tempo nisso se o ambiente não tiver compilador — a verificação de integridade já cobre as quebras usuais.

6. Relatar

Termine com um breve relatório na conversa, no idioma do usuário:

• Caminho da cópia humanizada (o original não foi modificado).
• Que tipos de alterações você fez, com 3–5 pares representativos de antes/depois (uma linha cada, aparados).
• Números do scanner antes vs. depois (frases sinalizadas, travessões, comprimento médio da frase) — brevemente.
• Resultado da verificação de integridade.
• Qualquer coisa que você deliberadamente deixou de lado e por quê: passagens que parecem pouco claras ou possivelmente erradas em substância, afirmações que parecem mais fortes que a evidência, terminologia inconsistente. Sinalize estas; não as corrija silenciosamente.

Se o usuário estiver preparando uma revisão para um periódico, ofereça-se para produzir um latexdiff entre o original e a cópia (se latexdiff estiver instalado) para que ele possa revisar as alterações visualmente.