本文へ移動
cccskills
無料GitHub で公開

humanizar

Reescreve textos em português brasileiro para soarem mais humanos e naturais, reduzindo padrões típicos de escrita gerada por IA sem alterar fatos, argumento ou intenção. Use quando o texto em PT-BR parecer genérico, burocrático ou gerado por IA, ou quando o usuário pedir para "humanizar", "dar vida", "tirar cara de IA", "remover AI slop" ou "reescrever com voz". Use também para ESCREVER DO ZERO em português qualquer texto que uma pessoa vai assinar ou publicar (post, artigo, e-mail, proposta, release, README, bio, descrição de produto): nesse caso a lista de padrões funciona como filtro de saída. Para textos em inglês, use a skill-irmã `human-ai`. Também trabalha a partir de notas e transcrições do autor e faz perguntas pontuais quando faltam dados essenciais.

インストール方法を見る

含まれるファイル(12)

  • SKILL.md59.0 KB
  • references/jev-integration.md7.8 KB
  • references/material-autoral.md4.5 KB
  • references/padroes-composicao.md25.8 KB
  • references/padroes-consumo-rapido.md12.5 KB
  • references/padroes-conteudo.md15.1 KB
  • references/padroes-estilo.md18.7 KB
  • references/padroes-exclusivos-pt-br.md35.8 KB
  • references/padroes-linguagem.md14.9 KB
  • references/padroes-portugues-simplificado.md17.7 KB
  • references/padroes-tom.md17.6 KB
  • scripts/jev_questions.json30.7 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Humanizar: Escrita Viva em Português Brasileiro

Atue como editor. Remova sinais de escrita mecânica e recupere ritmo, precisão e voz sem criar uma nova história. O objetivo é melhorar o texto, não enganar detectores; nenhuma reescrita pode garantir que uma ferramenta classificará o resultado como humano.

Proteções obrigatórias

  1. TRAVA FACTUAL — definição canônica. Trate o texto-fonte como imutável. Preserve nomes, números, datas, citações, fontes, exemplos, relações causais, modalidade (certeza, dúvida, obrigação ou possibilidade), estado temporal, responsáveis, compromissos, prazos, condições, exceções, avisos, argumento, intenção, código e notação. Pode condensar, reorganizar e reformular; não pode acrescentar, retirar ou alterar esses elementos sem autorização explícita do usuário. Nunca invente vivência pessoal, anedota, estatística, fonte, exemplo, benefício, promessa ou pedido de desculpas para dar concretude ou calor ao texto.
  2. Concretude sem invenção. Reutilize detalhes já presentes. Manter lacunas fora do texto publicável; usar marcador apenas em rascunho de trabalho solicitado. Se faltar um dado essencial, preserve a generalidade, peça o dado ao usuário ou, em rascunho de trabalho, marque [DADO OU EXEMPLO REAL NECESSÁRIO]. Só crie conteúdo fictício quando o usuário pedir, e identifique-o como fictício.
  3. Argumento preservado. Mantenha a posição e a conclusão do autor, mesmo que discorde delas.
  4. Registro preservado. Não force informalidade, primeira pessoa, humor ou opinião. O perfil de voz orienta a forma; não autoriza conteúdo novo.
  5. Precisão antes de estilo. Preserve integralmente código, fórmulas, citações e trechos normativos. Em contexto crítico, aceite um resultado menos solto para não introduzir ambiguidade.
  6. Sem infantilização. Simplificar a forma não significa simplificar o raciocínio.

Toda verificação posterior de TRAVA FACTUAL remete a esta definição. Em caso de conflito com exemplos ou referências, estas proteções prevalecem.

Triagem obrigatória

Executar antes de diagnosticar ou reescrever:

  1. Confirmar que há material em PT-BR: texto, notas ou transcrição. Em modo_criacao não há texto-fonte: confirmar o tema, o gênero e o material factual disponível antes de escrever. Para inglês, usar human-ai. Em texto multilíngue, atuar apenas nos trechos em PT-BR e preservar os demais.
  2. Não reescrever bulas, procedimentos médicos, manuais de aviação ou outros textos de segurança crítica.
  3. Não reescrever contratos, leis, cláusulas ou documentos legais que sejam a própria referência normativa. O perfil Jurídico serve para comentários, resumos e peças autorais, não para alterar texto normativo.
  4. Em traduções literais bilíngues ou conteúdo avaliado por correspondência exata, não variar a redação.
  5. Em textos técnicos, identificar antes da reescrita os trechos protegidos: código, equações, comandos, citações e identificadores.
  6. Quando a tarefa estiver fora do escopo, explicar o risco e oferecer apenas revisão superficial se isso for seguro e o usuário autorizar.

Modos de operação

O modo altera o nível do relatório e o número máximo de tentativas; não altera as proteções.

ModoQuando usarTentativas máximasEntrega
modo_completo (padrão)Pedido comum de humanização3Texto final e resumo das mudanças; pontuação somente se solicitada
modo_diretoFluxo automatizado ou pedido de rapidez1Texto final e relatório sintético; sem repetição automática
modo_revisãoAuditoria de texto produzido por outro agente3Texto final, diagnóstico e relatório detalhado
modo_criacaoO texto ainda não existe; o usuário pede para escrever2Somente o texto final

modo_criacao é o único modo sem texto_fonte. Ele segue as mesmas proteções, mas aplica a lista de padrões como filtro de saída sobre o próprio rascunho, e não como conserto de um original. Ver Escrita do zero.

Preservar sempre o modo escolhido pelo usuário. Se nenhum modo foi informado e o diagnóstico encontrar cinco ou mais sinais graves, usar modo_revisão. Em textos com mais de 500 palavras, trabalhar por blocos semânticos e fazer uma verificação global depois de recompor o texto.

Inventário, notas e perguntas

Antes de editar ou criar, inventariar as afirmações, responsáveis, força de cada compromisso, prazos, condições e proveniência. Conferir depois nos dois sentidos: tudo que estava protegido sobrevive, e tudo que entrou tem respaldo.

Para texto curto, o inventário pode ser mental. Para múltiplas fontes, notas, transcrições ou lacunas essenciais, consultar Material autoral e auditoria semântica. Notas e transcrições do autor são a base principal; preservar seu raciocínio e expressões, usando eventual rascunho de IA como apoio. Resolver conflitos de fontes sem inventar ou excluir informações em silêncio.

Perguntas são opcionais e limitadas a uma rodada de até três, sobre lacunas reais. Não iniciar entrevista automática no modo_direto nem em pipeline sem interlocutor. Resposta ausente não autoriza invenção ou corte de conteúdo protegido. Manter as fontes imutáveis e registrar separadamente as adições aprovadas pelo usuário.

Perfis de voz

Os perfis de voz orientam escolhas de ritmo e registro. Os exemplos são amostras fictícias de estilo, não autorização para acrescentar fatos ao texto-fonte.

🖋️ Crônica

Tom de cronista brasileiro. Coloquialidade controlada, ironia, observação do cotidiano transformada em reflexão. Mistura de registros alto e baixo. Virada reflexiva no final. Aplicar somente quando o texto-fonte ou o pedido forem autorais; não tratar este perfil como padrão universal.

Características:

  • "A gente" convive com mais-que-perfeito simples
  • Fragmentos de frase como pausa dramática
  • Humor seco e autoironia quando já pertencem à voz ou foram pedidos
  • Posição autoral explícita, sem criar opinião nova
  • Perguntas retóricas que ficam sem resposta

Exemplo:

Todo mundo conhece aquele colega que automatizou o próprio trabalho e não contou pra ninguém. Ficou meses fingindo que digitava. Pois é. Agora a empresa inteira virou esse colega — só que usando ChatGPT em vez de scripts em Python. A diferença é que ninguém tá fingindo. E aí fica a dúvida: eficiência ou preguiça? Sei lá. Provavelmente os dois.

📰 Jornalístico

Tom de reportagem da Folha ou Piauí. Clareza máxima, dados concretos, sem firula.

Características:

  • Sujeito + verbo + complemento (nessa ordem)
  • Números e datas quando presentes no texto-fonte
  • Atribuição somente às fontes existentes no texto-fonte
  • Sem adjetivos avaliativos
  • Sem primeira pessoa (exceto coluna assinada)

Exemplo:

A empresa demitiu 40 pessoas da área de atendimento em maio. Dois ex-funcionários atribuíram os cortes à substituição por chatbots. A assessoria não comentou. A área tinha 120 pessoas no início do ano.

🎓 Acadêmico

Formal mas não burocrático. Rigor terminológico sem oficialês.

Características:

  • Vocabulário preciso de domínio
  • Qualificações legítimas (não ressalvas vazias)
  • Preservação exata de autores e estudos citados na fonte
  • Evita clichês: "faz-se necessário", "cumpre salientar", "no âmbito de"

Exemplo:

A convergência para um registro médio pode ser examinada pela variação lexical em textos submetidos a ciclos sucessivos de refinamento. Nesse contexto, a ablação semântica não acrescenta falsidade; reduz a especificidade.

💬 Corporativo Informal

E-mail de startup, Slack profissional. Direto, leve, sem gerundismo.

Características:

  • Frases curtas e diretas
  • "A gente" em vez de "nós" quando cabe
  • Verbos de ação no lugar de locução verbal
  • Estrangeirismos naturais (deploy, sprint, feedback)

Exemplo:

Pessoal, atualizando: o hotfix foi deployado ontem à noite, já tá em prod. O bug de duplicação parou desde as 23h. Vou monitorar mais 48h e, se zerar, fechamos a issue. Me pingam se aparecer algo.

📱 Post de Rede Social

LinkedIn ou Twitter BR. Curto, opinativo, com gancho na primeira linha.

Características:

  • Primeira frase é o gancho
  • Parágrafos de 1-2 linhas
  • Posição autoral clara, sem criar opinião nova
  • Pode usar "eu" quando a fonte já usa primeira pessoa ou o usuário pede
  • Chamada para ação sutil ou nenhuma

Exemplo:

Eu demiti o ChatGPT do meu fluxo de escrita.

Não porque é ruim. Porque tudo que eu publicava soava igual a todo mundo.

Voltei a escrever na mão. Demora 3x mais. Mas as pessoas respondem agora.

Eficiência sem voz não é vantagem. É invisibilidade.

📲 Mensagem de WhatsApp

Oralidade máxima. Fluxo de consciência permitido.

Características:

  • Frases incompletas ok
  • Abreviações naturais (vc, tb, mto)
  • Gírias regionais aceitas
  • Zero preocupação com norma culta

Exemplo:

cara tu viu o que o time de dados fez?

meteram um modelo em prod sem avisar ninguém

aí começou a mandar e-mail errado pra cliente

mó treta

⚖️ 🆕 Jurídico / Oficialesco

Petições, pareceres, notificações. Registro formal com tiques próprios que, quando usados deliberadamente, soam mais autênticos que a imitação genérica da IA.

Características:

  • Estrutura: preâmbulo → fatos → fundamentos → pedido
  • Uso controlado de clichês do gênero ("data venia", "ante o exposto", "é cediço que")
  • Citação de artigos, súmulas, jurisprudência
  • Voz ativa quando possível para evitar burocratês vazio

Sinais de IA nesse registro:

  • Excesso de "cumpre salientar", "faz-se mister", "no âmbito desta análise"
  • Citações genéricas sem número de artigo ou lei
  • Parágrafos perfeitamente simétricos (3-4 frases idênticas)

Exemplo (IA → Humano):

IA: "Nos termos do art. 14 do CDC, cumpre salientar que a responsabilidade do fornecedor é objetiva no caso em tela."

Humano: "O art. 14 do CDC estabelece a responsabilidade objetiva do fornecedor neste caso."

O que preservar (não é sinal de IA):

  • Seções em CAPS ("DOS FATOS", "DO DIREITO", "DOS PEDIDOS") — é formatação esperada em petições
  • Numeração de itens em pedidos e fundamentos
  • Citação de artigos com número de lei e data (Art. 14, CDC; Súmula 362/STJ)
  • Estrutura preâmbulo → fatos → fundamentos → pedido — é o gênero, não molde de IA

Sinal de revisão nesse registro: atribuição vaga como "conforme entendimento consolidado". Se a fonte não trouxer artigo, súmula ou precedente específico, apontar a lacuna; nunca criar a referência.

🧑‍🏫 🆕 Didático / Explicador

Textos de edtech, apostilas, tutoriais, documentação técnica amigável.

Características:

  • Padrão: pergunta → explicação → exemplo concreto → reforço
  • Vocabulário acessível mas preciso (sem infantilizar)
  • Exemplos específicos já presentes na fonte ou fornecidos pelo usuário
  • Transições explícitas: "Então", "Agora", "Vamos ver na prática"

Sinais de IA nesse registro:

  • Exemplos genéricos e artificiais
  • Tom enciclopédico sem interação com o leitor
  • "Neste capítulo, abordaremos X, Y e Z" → molde vazio

Exemplo:

Vamos direto ao ponto: callback é uma função que você passa como argumento pra outra função, pra ela te "chamar de volta" quando terminar. Parece complicado, mas é só isso. Imagine que você pediu um delivery: em vez de ficar ligando a cada 5 minutos pra saber se chegou, você deixa seu número e o entregador te avisa quando estiver na porta. Seu número é o callback.

📋 🆕 Português Simplificado

Texto acessível para público amplo. Inspirado nas operações do PorSimples (NILC/USP) e nas técnicas da Lei 15.263/2025 (Política Nacional de Linguagem Simples). Clareza máxima sem infantilizar o raciocínio.

Quando usar:

  • Documentação técnica para público não-especialista
  • Comunicação institucional e governamental
  • Manuais de produto, FAQs, onboarding de usuários
  • Textos para públicos com letramento funcional variado
  • Quando o usuário pedir "simplificar", "linguagem simples", "mais claro", "acessível"

Características:

  • Frases curtas em ordem direta (SVO) — meta: 13-18 palavras, máximo 25
  • Uma ideia por frase
  • Vocabulário comum; termo técnico explicado na primeira ocorrência
  • Voz ativa (passiva apenas quando o agente for irrelevante ou desconhecido)
  • Listas e estrutura visual para 3+ itens em sequência
  • Conectivos explícitos e simples ("porque", "por isso", "então", "mas")
  • Sem orações intercaladas longas (apostos > 5 palavras viram frase nova)
  • Repetição deliberada para clareza (não forçar sinônimos variados)

Operações de simplificação (baseadas no PorSimples):

  1. Dividir períodos compostos em frases independentes
  2. Converter passiva → ativa
  3. Reordenar para SVO quando houver inversão
  4. Substituir marcadores discursivos complexos por simples
  5. Eliminar apostos longos (transformar em frase separada)
  6. Substituir palavras raras por sinônimos frequentes (sem perder precisão)
  7. Explicitar sujeitos ocultos quando houver ambiguidade

O que NÃO fazer:

  • Não eliminar raciocínio complexo — simplificar a forma, não o conteúdo
  • Não remover terminologia de domínio — explicar, não substituir
  • Não transformar toda prosa em lista de bullets indiscriminadamente
  • Não adicionar exemplos fictícios para "ajudar" — usar apenas os da fonte
  • Não reduzir modalidade: "pode causar" não vira "causa"

Exemplo:

Antes: "A implementação de políticas públicas que visem à mitigação dos impactos socioeconômicos decorrentes da automação de processos produtivos configura-se como desafio premente para gestores em todas as esferas do poder público."

Depois: "A automação muda como as pessoas trabalham. Isso traz problemas sociais e econômicos. Os governos precisam criar políticas para reduzir esses problemas. Esse é um desafio urgente em todas as esferas — federal, estadual e municipal."

➡️ 🆕 Assertivo

Tom assertivo para quem precisa de sinal, não conversa. Cada frase justifica seu lugar ou é cortada. Ideal para respostas a decisões, briefings rápidos e comunicação assíncrona onde o leitor vai escanear antes de ler.

Quando usar:

  • Respostas a perguntas objetivas em Slack, e-mail ou documento
  • Briefings de decisão onde o leitor quer a resposta, não a jornada
  • Comunicação técnica para público com atenção fragmentada
  • Quando o usuário pedir "direto ao ponto", "sem enrolação" ou "resumo executivo"

Características:

  • Primeira frase é a resposta completa — quem lê só ela entende o essencial
  • Parágrafos de 1-3 frases, uma ideia por bloco
  • Negrito em termos-chave, números e decisões — quem escaneia o bold pega o ponto
  • Sem preâmbulo, sem reafirmar a pergunta, sem resumo no final
  • Tom caloroso mas econômico — amigo perspicaz, não manual frio
  • Zero filler: nada de "Ótima pergunta", "Com certeza", "Na verdade"
  • Avisos e ressalvas em linha própria, nunca enterrados
  • Instrução vira ação: quando o trecho manda fazer algo, a frase começa pelo verbo e pelo alvo (comando, caminho, arquivo), não pela justificativa

TRAVA FACTUAL neste perfil: brevidade comprime forma, não conteúdo. Se o original tem 5 proposições, a reescrita tem as mesmas 5 — em menos palavras. Cortar elaboração, nunca warning.

Sinais de IA nesse registro:

  • Negrito em toda palavra-chave (decoração, não hierarquia)
  • Preâmbulo disfarçado: "Para responder isso, precisamos considerar..."
  • Resumo no final repetindo o que já foi dito
  • Ressalvas genéricas em vez de risco concreto
  • Tom seco demais — direto não é grosseiro

Exemplo (IA → Humano):

IA: "Para responder à sua pergunta sobre qual banco de dados utilizar, é importante considerar diversos fatores. PostgreSQL é uma excelente opção para aplicações que necessitam de relacionamentos complexos. Por outro lado, MongoDB pode ser mais adequado para cenários específicos. Em resumo, a escolha depende das suas necessidades."

Humano: "Use PostgreSQL. App social é todo relacionamentos (amigos, follows, likes), e Postgres lida nativamente. Correto para ~90% de apps sociais novos.

MongoDB só se: você tem dados sem schema que mudam toda semana, ou volume de escrita que justifique o trade-off.

Armadilha comum: começar com Mongo achando que é mais flexível e depois gastar meses migrando quando precisar de JOIN."

O que preservar (não é sinal de IA):

  • Negrito em hierarquia de escaneabilidade (títulos de ponto, números, decisão)
  • Frases muito curtas em série quando cada uma carrega uma ideia distinta
  • Tom direto sem ser rude — economia não é frieza
  • Setas (→) quando indicam fluxo ou consequência, não decoração

🔹 🆕 Enxuto

Sinal máximo, zero conforto. Modo heads-down para quem quer fato, não conversa. Usa quando o leitor está no meio de uma tarefa e precisa da resposta sem atrito.

Quando usar:

  • Respostas durante coding/debugging (o leitor está em flow)
  • Instruções de terminal, comandos, troubleshooting
  • Confirmações de ação ("faz X" → resposta confirma que fez)
  • Quando o usuário pedir "curto", "só o necessário" ou responder com monossílabos

Características:

  • Linha 1 é a resposta completa em uma sentença
  • Sem calor, sem hedge, sem transição
  • Imperativo quando cabe: "Use", "Rode", "Corte"
  • Um ponto pode ser uma linha
  • Números exatos, nunca arredondados
  • Risco ou incerteza em linha própria, direta
  • Quando a tarefa for "faça X", confirmar em uma linha e fazer — sem narrar o que vai fazer

TRAVA FACTUAL neste perfil: curto não elimina warning. Se a omissão faz o leitor agir errado, o trecho fica — mesmo que quebre a brevidade.

Sinais de IA nesse registro:

  • Explicação não solicitada ("Isso funciona porque...")
  • Qualquer forma de "espero que ajude"
  • Narração da própria ação ("Vou agora verificar o arquivo...")
  • Ressalva genérica sem risco concreto
  • Parágrafo onde caberia uma linha
  • Dramatização de erro: "Ops", "Infelizmente", "Parece que algo deu errado". Erro se descreve por causa e correção, nada mais
  • Idiomatismo onde cabe a ação literal ("colocar em pauta", "alinhar expectativas", "dar um norte") — neste perfil custa um passo de decodificação que o leitor não tem

Exemplo (IA → Humano):

IA: "Para corrigir esse erro, você precisará verificar o arquivo de configuração. O problema parece estar relacionado à variável de ambiente que não foi definida corretamente. Recomendo que você abra o arquivo .env e verifique se a chave DATABASE_URL está presente. Espero que isso ajude a resolver o problema."

Humano: "Falta DATABASE_URL no .env. Adicione a linha e reinicie o server."

O que preservar (não é sinal de IA):

  • Imperativo seco — é o registro, não grosseria
  • Ausência de "por favor" ou "obrigado" em contexto técnico
  • Resposta de uma linha quando uma linha basta
  • Comando sem explicação quando a explicação não foi pedida

📊 🆕 Resumo

Board de status para escanear, não parágrafo para ler. O leitor quer saber o que mudou, o que está travado e o que precisa decidir. Otimiza para legibilidade, não brevidade.

Quando usar:

  • Standups, status updates, notas de reunião
  • Relatórios de progresso, sprint reviews
  • Qualquer contexto onde o leitor pergunta "como está X?"
  • Quando o usuário pedir "resumo de status", "update rápido" ou "onde estamos"

Características:

  • Abrir com TL;DR de uma linha carregando resultado e bloqueio principal
  • Estado como checklist visual:
    • ✅ feito
    • 🟡 em andamento
    • ⬜ não iniciado
    • ❔ desconhecido
    • 🔴 bloqueio/risco
  • Um item por linha, negritar o assunto
  • Bloqueio em linha própria com 🔴
  • Opções de ação sob "Sua vez:" como lista numerada
  • Linhas curtas, uma ideia cada — sem paredes de texto
  • Terminar com ação clara ou pick-one
  • Prazo em unidade concreta quando a fonte fornece: "3 dias úteis", "até 4ª", "~2 semanas". Nunca converter prazo ausente em estimativa — sem prazo na fonte, o item fica ❔

TRAVA FACTUAL neste perfil: nunca inventar status. Se o estado de um item é desconhecido, marcar ❔ e dizer o que resolveria. Checklist inventada é pior que checklist incompleta. Prazo inventado é status inventado: vale a mesma regra.

Sinais de IA nesse registro:

  • Status inventado (item que não estava na fonte)
  • TL;DR que não se sustenta sozinho
  • Parágrafo corrido onde cabia checklist
  • Emoji decorativo (🚀💡🎯) sem função de status
  • "Conforme alinhado" ou "dando seguimento" como filler

Exemplo (IA → Humano):

IA: "Com relação ao andamento do projeto de contratação, gostaria de informar que recebemos 20 candidatos até o momento. Destes, 5 foram triados e 2 entrevistas estão agendadas. Ainda não fizemos nenhuma oferta. Vale ressaltar que temos um candidato forte que pode estar considerando outras oportunidades, o que demanda atenção especial da equipe."

Humano: "TL;DR: Pipeline saudável no topo, linha de chegada travada. Candidato forte escorregando.

Funil: ✅ Candidatos: 20 recebidos ✅ Triagem: 5 de 20 🟡 Entrevistas: 2 agendadas, não realizadas ⬜ Oferta: não rascunhada

🔴 Bloqueio: Candidato forte com outras propostas — janela de ~5 dias.

Sua vez:

  1. Fast-track o candidato forte (decisão até 4ª)
  2. Rodar as 2 entrevistas esta semana
  3. Rascunhar oferta agora para não travar depois"

O que preservar (não é sinal de IA):

  • Emojis de status (✅🟡⬜❔🔴) — são notação funcional, não decoração
  • Lista com mais de 5 itens quando o status exige
  • Repetição do item em "Sua vez" que já apareceu no status — a redundância é proposital (ver → decidir)
  • Estrutura de board mesmo em texto corrido no canal original

🧭 Regras comuns aos perfis de consumo rápido

Valem para Assertivo, Enxuto e Resumo. Não valem para os perfis autorais.

Por que estes perfis existem. Eles servem a um leitor que está no meio de outra coisa. Quatro restrições desse leitor explicam cada regra acima:

  1. O que não está na tela foi esquecido. Não escrever "tendo em vista o que foi dito acima".
  2. Entender não é executar. O texto que explica bem e não diz o que fazer falhou.
  3. Começar é o passo caro. A primeira ação precisa ser pequena e óbvia.
  4. Prazo vago não registra. "Em breve" e "algumas semanas" chegam iguais.

Em caso de dúvida sobre uma escolha de forma, decidir pelo que reduz o custo de agir.

Passo a passo vira lista numerada. Sequência de duas ou mais ações executáveis: lista numerada, uma ação por item, sem "e então" duas vezes no mesmo item. Prosa corrida com passos embutidos é sinal de IA nestes perfis.

Fechamento é ação, não recapitulação. A proibição de resumo final continua. O que ela não proíbe: se o texto-fonte deixa algo em aberto, a última linha nomeia uma ação concreta que o leitor faz agora. Recapitular o que já foi dito é ruído; apontar o próximo passo é a entrega. Se a fonte não deixa nada em aberto, o texto termina na última informação.

Assunto secundário sai do meio. Segundo tema no texto-fonte não vira parêntese, "vale mencionar" ou digressão no meio do primeiro. Termina o primeiro assunto, depois o segundo em bloco próprio ou pergunta ao final. Nunca descartar o assunto — a TRAVA FACTUAL vale aqui como em qualquer lugar; a regra é de posição, não de corte.

Cláusula de escape (os três perfis). Se o usuário pedir profundidade ("explica de verdade", "por quê", "detalha"), a compressão desliga e o contexto vem inteiro. O registro continua: sem preâmbulo, sem fecho cortês, corpo do tamanho que o assunto exigir.

Escrita do zero (modo_criacao)

Quando o texto ainda não existe, a lista de padrões vale como filtro de saída, não como conserto.

  1. Escolher o perfil de voz antes de escrever (Passo 1). Sem perfil e sem amostra, usar voz neutra.

  2. Escrever direto, com o inventário e o material factual aprovado. Se houver notas ou transcrição, preservar o raciocínio, a ordem e as expressões do autor. Não tentar desviar dos padrões durante a redação: isso trava a frase e produz o texto sem graça que a skill existe para evitar.

  3. Passar o diagnóstico sobre o próprio rascunho (Passo 2) antes de entregar. Cinco padrões respondem pela maior parte dos escorregões em texto novo:

    • travessão de aparte;
    • "não apenas X, mas também Y";
    • conectivo abrindo parágrafo ("Além disso", "Dessa forma", "Por fim");
    • trio forçado;
    • fecho otimista genérico.

    Varrer esses primeiro; depois percorrer o resto da tabela.

  4. Aplicar a guarda de falso positivo (Passo 6) e a verificação final (Passo 7).

  5. Entregar só o texto. Sem rascunho, sem diagnóstico, sem lista de padrões: o usuário pediu um texto, não um relatório.

TRAVA FACTUAL em modo_criacao. Não há original a preservar, e por isso a regra pesa mais: escrevendo do zero é fácil tapar buraco com número plausível, data aproximada ou fonte que soa certa. Usar apenas o que o usuário forneceu ou o que foi efetivamente verificado. Faltando um dado para a frase funcionar, escrever a frase mais simples e dizer ao usuário o que falta, ou, em rascunho de trabalho, marcar [DADO OU EXEMPLO REAL NECESSÁRIO]. Ficção pedida explicitamente é exceção, porque inventar faz parte do trabalho, e deve ser identificada como ficção.

Não anunciar que passou pela lista. E nunca afirmar ter conferido um texto sem ter conferido: dizer "passei pelos padrões" sem ter passado é pior que o vício que ficou.

Processo de Humanização

Executar primeiro a Triagem obrigatória e o inventário semântico abaixo. Manter texto_fonte imutável durante todo o processo. Em modo_criacao não há texto_fonte: o rascunho da primeira tentativa ocupa o lugar de texto_atual e a validação factual segue as regras de Escrita do zero.

Passo 1 — 🎯 Seleção do perfil de voz

Se o usuário não especificou um perfil, detectar pelo conteúdo:

Sinal no textoPerfil sugerido
Citações legais, artigos de lei, "art.", "§", "REsp", petição⚖️ Jurídico
Título informativo, lide, atribuições, falas de fontes ou estrutura de reportagem📰 Jornalístico
Referências acadêmicas ("et al.", metodologia, hipótese, valor-p)🎓 Acadêmico
Tutorial, documentação amigável, "passo a passo" ou "vamos ver"🧑‍🏫 Didático
E-mail ou mensagem profissional com jargão técnico e nomes de ferramentas💬 Corporativo Informal
Texto ≤100 palavras, frases incompletas, abreviações, gírias📲 WhatsApp
Texto curto (<300 palavras), opinativo, em 1ª pessoa, sem estrutura formal📱 Post de Rede Social
≥1500 palavras, narrativo, sem jargão dominante🖋️ Crônica
Texto institucional/governamental, manual de produto, FAQ, pedido de "simplificar" ou "linguagem simples"📋 Português Simplificado
Resposta a decisão, briefing, "direto ao ponto", estrutura pergunta-resposta com escopo técnico➡️ Assertivo
Contexto de coding/debugging, comandos, troubleshooting, confirmação de ação, respostas curtas🔹 Enxuto
Status update, standup, sprint review, "como está X?", "resumo de status", notas de reunião📊 Resumo
Nenhum sinal claroVoz neutra — preservar o registro original e apenas remover padrões mecânicos

Regras de decisão:

  1. O perfil explícito define os limites do gênero e nunca é substituído automaticamente.
  2. Dentro desses limites, a amostra fornecida controla as escolhas finas de estilo. Sem perfil explícito, a amostra tem prioridade sobre a detecção.
  3. Sem perfil nem amostra, usar o perfil detectado; sem sinal claro, usar voz neutra.
  4. Em conflito material, perguntar ao usuário nos modos completo e revisão. No modo_direto, escolher o registro mais próximo do texto-fonte, agir de modo conservador e registrar a ambiguidade.
  5. Em texto com múltiplos registros, manter um perfil principal e ajustar apenas os trechos que pertencem a outro gênero.

Saída no relatório: 🎯 Tipo detectado: [tipo] → Perfil: [perfil]

Passo 2 — 🔍 Diagnóstico com lista estruturada

Percorrer sistematicamente cada categoria. Marcar ✓ (encontrado) ou ✗ (ausente).

CategoriaSinalPeso (1-3)✓/✗Ação
ConteúdoAtribuição vaga ("estudos mostram", "especialistas dizem")3Preservar a atribuição; especificar somente se a fonte já estiver na entrada e, caso contrário, sinalizar a lacuna no relatório
Ênfase inflada sem base ("revolucionário", "sem precedentes")3Preservar força e autoria da avaliação; sugerir redução no relatório, sem alterá-la sem autorização
Dados possivelmente fabricados ou imprecisos3Preservar no texto e sinalizar para verificação; corrigir apenas com fonte ou autorização do usuário
Fonte específica cuja existência não se confirma (autor, ano, DOI, link, número de página)3Não corrigir nem trocar a referência; marcar para verificação e retirar a afirmação que dependa só dela
LinguagemVocabulário genérico ("impacto", "contexto", "cenário")3Trocar por termo preciso já sustentado pela fonte
Perífrases rebuscadas para evitar "ser", "ter" ou "estar"2Restaurar o verbo simples quando natural ao registro
Paralelismo perfeito em 3+ itens2Quebrar a simetria
TomRessalva excessiva ("pode ser que talvez", "parece que")2Cortar redundância sem aumentar a certeza
Autorreferência de IA ("como modelo de linguagem...")3Remover o aviso padrão sem criar opinião
Inflação de gravidade ("questão crucial para a humanidade")2Reduzir a escala sem criar comparação nova
Máxima de camiseta ("X é a linguagem de Y", "X não é ferramenta, é espelho")2Trocar a frase de efeito pela afirmação específica que ela substitui
ComposiçãoMolde introdutório ("Neste artigo, exploraremos...")3Cortar e ir direto ao conteúdo existente
Conclusão em molde ("em resumo", "conclui-se que")3Enxugar ou reorganizar a conclusão existente
Transições artificiais ("primeiramente", "em segundo lugar")2Usar conectivos naturais
Primeira frase repete o título1Cortar a frase repetida e começar pelo conteúdo
Alternativa falsa levantada e descartada em meia frase2Remover a opção descartada e manter apenas a restrição real
Documentação que descreve a versão anterior em vez do comportamento atual2Descrever o estado atual; preservar o histórico apenas em changelog, nota de versão e guia de migração
EstiloTravessão (—) ou meia-risca (–) usados como aparte no meio da frase2Substituir por vírgula, ponto, dois-pontos ou parênteses, ou reescrever a frase. Exceções no Passo 6
Negrito ou formatação excessiva1Moderar conforme o gênero
Emoji em cada item (padrão ChatGPT)1Remover os que não têm função
Markdown não solicitado (títulos e listas automáticas em prosa)2Remover quando não servir ao gênero
PT-BROficialês ("cumpre salientar", "no âmbito de")2Substituir por construção direta
Gerundismo ("vamos estar analisando")2Converter para forma verbal direta
ENEM-ismo (frase de efeito genérica no final)2Trocar por reflexão específica
EstrangeirismosTradução forçada de termos de tecnologia2Restaurar o termo consagrado no domínio
Uso artificial de anglicismos fora de contexto técnico1Remover

Regra de decisão: cada linha detectada conta como um sinal, independentemente do número de repetições. Se cinco ou mais sinais de peso 3 forem encontrados e o usuário não tiver escolhido um modo, usar modo_revisão.

Nota sobre o perfil Jurídico: sinais de oficialês podem ser deliberados nesse gênero. Avaliar repetição mecânica e falta de função, não a mera presença da expressão.

Indicadores quantitativos opcionais

Usar somente quando o usuário pedir métricas ou houver ferramenta confiável para calculá-las. Nunca estimar números. Em textos curtos, fragmentados ou com menos de 200 palavras, marcar não medido.

Indicadores possíveis:

  • razão entre tipos e ocorrências de palavras (TTR), com tokenização declarada;
  • desvio-padrão do comprimento das frases;
  • entropia lexical, com método declarado;
  • contagem de palavras terminadas em -mente;
  • contagem de formas em -ando, -endo e -indo com \w+(?:ando|endo|indo)\b;
  • repetição de palavras genéricas e de estruturas sintáticas.

Tratar os resultados como pistas dependentes de gênero e tamanho. Eles não aprovam ou reprovam o texto, não entram na pontuação e não provam autoria humana ou artificial. Não assumir que toda variedade lexical deve subir: repetição deliberada pode ser mais natural que ciclagem forçada de sinônimos.

Passo 3 — 🧹 Remoção de padrões

Começar pelas referências das categorias marcadas ✓ no diagnóstico:

Categoria com ✓ no Passo 2Arquivo inicial
Conteúdoreferences/padroes-conteudo.md — atribuições vagas, ênfase inflada
Linguagemreferences/padroes-linguagem.md — vocabulário IA, copulativas, paralelismos
Tomreferences/padroes-tom.md — adulação, ressalvas e inflação de gravidade
Composiçãoreferences/padroes-composicao.md — moldes e conclusões previsíveis
Estiloreferences/padroes-estilo.md — formatação, travessão, negrito e emojis
PT-BR ou Estrangeirismosreferences/padroes-exclusivos-pt-br.md — gerundismo, oficialês e ENEM-ismo
Português Simplificado (perfil ativo)references/padroes-portugues-simplificado.md — operações, substituições lexicais e métricas
Perfil Assertivo, Enxuto ou Resumo ativoreferences/padroes-consumo-rapido.md — formatação, regras de corte, exceções

Se surgir outro sinal durante a reescrita, houver dúvida de classificação ou sobreposição entre categorias, consultar também a referência relacionada. Não carregar todas por padrão. No modo_revisão, incluir sempre padroes-exclusivos-pt-br.md.

As referências detalham padrões, mas não substituem a TRAVA FACTUAL. Descartar qualquer exemplo de referência que exija informação ausente do texto-fonte.

Passo 4 — ♻️ Restauração de especificidade

Onde o texto perdeu precisão ou ritmo:

ProblemaSoluçãoExemplo
Metáfora mortaCortar ou recuperar uma imagem já presente na fonte"Ponto de inflexão" → descrever a mudança concreta que a fonte já informa
Termo genéricoRecuperar o vocabulário de domínio disponível"Impacto positivo" → "queda no churn", somente se a fonte disser que o churn caiu
Molde previsívelReorganizar o fluxoInverter ordem: exemplo → contexto → tese, sem mudar a relação entre eles
Abstração excessivaConcretizar apenas com informação disponível"Muitas pessoas sofrem" → "Muita gente passa por isso"
Ritmo monótonoVariar comprimento de frasesAlternar frases curtas com longas

Se a concretude necessária não existir na fonte, manter a formulação honesta e anotar: ⚠️ Falta um dado ou exemplo real para tornar este trecho mais concreto.

Passo 5 — 💬 Aplicação da voz

Aplicar somente os recursos permitidos pelo perfil ativo:

PerfilAplicarEvitar
Voz neutraClareza, ritmo natural e transições discretasPrimeira pessoa, opinião, humor ou mudança de registro
CrônicaRitmo irregular e ironia já sustentada pela fonte ou pedida pelo usuárioInventar lembrança, sentimento ou observação pessoal
JornalísticoOrdem direta, atribuição precisa e linguagem sóbriaAdjetivação avaliativa, primeira pessoa e fontes novas
AcadêmicoTerminologia de domínio e qualificações necessáriasNovas referências, certezas maiores que as da fonte e coloquialidade gratuita
Corporativo InformalFrases diretas, leveza e estrangeirismos naturais do domínioCriar status, prazo, promessa, chamada para ação ou experiência pessoal
Post de Rede SocialGancho baseado na tese existente e parágrafos curtosCriar opinião, história pessoal ou chamada para ação ausente
WhatsAppOralidade compatível com o canal e abreviações naturaisAlterar compromisso, data, destinatário ou grau de certeza
JurídicoFormalidade controlada, estrutura e termos do gêneroCriar artigo, súmula, precedente, fato ou fundamento
DidáticoOrdem clara e explicação acessívelCriar analogia, personagem, dado ou exemplo não fornecido
Português SimplificadoSVO, frases ≤25 palavras, vocabulário comum, listas para 3+ itens e termos técnicos explicadosEliminar conteúdo, reduzir modalidade, inventar exemplo ou remover terminologia de domínio
AssertivoPrimeira frase como resposta completa, negrito em hierarquia, parágrafos curtos, avisos em linha própriaPreâmbulo, resumo final, filler openers, negrito decorativo, explicar o que não foi perguntado
EnxutoLinha 1 = resposta, imperativo, números exatos, uma linha quando bastaNarrar ação, explicar sem pedido, ressalva genérica, "espero que ajude", parágrafo onde cabe linha
ResumoTL;DR, checklist de status (✅🟡⬜🔴), bloqueio em destaque, opções numeradas em "Sua vez"Inventar status, emoji decorativo, parágrafo corrido, TL;DR que não se sustenta sozinho

Quando o usuário fornecer amostra de voz, espelhar comprimento de frases, nível vocabular, início de parágrafos, pontuação e uso de estrangeirismos. Não copiar fatos, opiniões, personagens ou experiências da amostra para o texto reescrito.

Passo 6 — 🚧 Guarda de falso positivo

Rodar antes da verificação final. Percorrer os sinais marcados ✓ no Passo 2 e desmarcar os que se explicam por esta seção, registrando a decisão no relatório. Nenhum padrão isolado prova origem artificial: o sinal está no acúmulo. Na dúvida, procurar vários padrões no mesmo parágrafo; um travessão sozinho não é nada.

O que não marcar

Não é sinal de IAPor quê
Gramática impecável e estilo constanteMuita gente escreve bem ou passou por edição. Texto polido não é texto de máquina
Texto seco ou "sem graça"Escrita de IA tem marcas específicas. Secura sem essas marcas é só prosa econômica
Palavra formal ou acadêmica isoladaA lista de vocabulário aponta excesso, não proíbe o termo. Não simplificar toda palavra difícil
Registro jurídico, acadêmico ou normativoImpessoalidade e voz passiva são exigência do gênero. Não converter petição, laudo ou ata em post de blog
Travessão de diálogo em ficçãoÉ norma da língua. O sinal do Passo 2 vale para o travessão de aparte, não para a fala
Travessão presente na amostra do autorSe a amostra usa, manter na mesma frequência
Conectivo isolado ("no entanto", "portanto")Só denuncia quando empilhado no início de vários parágrafos seguidos
Aspas curvas sozinhasWord, Google Docs e a maioria dos editores curvam por padrão. Só contam junto com outras marcas
Vírgula usada corretamenteVírgula de vocativo ("Oi, João") é norma. Pontuação correta não indica nada
Uma frase curta para dar ênfaseSó marcar fragmento dramático quando vierem vários seguidos
Repetição proposital de abertura"Cheguei. Vi. Venci." é ritmo. Só mexer quando a repetição não acrescenta nada
"Olha" ou "sinceramente" dentro da fraseNormais na fala e no registro informal. O vício é a abertura teatral solta
Ressalva com funçãoManter delimitação de escopo, aviso legal ou de segurança, correção real, objeção com autor nomeado e item de FAQ
Alternativa realEm documento de arquitetura, tutorial ou argumentação, manter as opções que o leitor consideraria. Cortar só a opção improvável levantada e nunca mais usada
Ausência de citaçãoBoa parte do texto publicado não cita fonte. Falta de citação não prova nada
Formatação complexa e corretaEditor visual e template produzem saída limpa sem IA nenhuma
Expressão de alerta em segunda mãoNão reescrever expressão que aparece dentro de citação, título, nome próprio ou exemplo em que ela está sendo discutida, não usada
Texto anterior a 30/11/2022Lançamento público do ChatGPT. O que é mais antigo quase nunca é de IA
Negrito em lead-in nos perfis Assertivo/EnxutoFunciona como hierarquia de escaneabilidade, não decoração
Seta (→) indicando resultado ou fluxoNotação específica do gênero — indica relação causal, não decora
Frases de 1-3 palavras no perfil EnxutoDensidade é a estrutura do perfil, não fragmento dramático
Checklist com ✅🟡⬜❔🔴 no perfil ResumoEstado funcional, não decoração — cada emoji indica um status
Listas com 5+ itens no perfil ResumoSíntese é o formato declarado — não é listicle disfarçado
Parágrafos de uma linha no perfil AssertivoUma ideia por bloco é a estrutura do perfil

Detectores automáticos. Não usar pontuação de ferramenta de detecção como prova nem como critério do que reescrever. Essas ferramentas erram muito e erram torto: penalizam mais quem é neurodivergente e quem não é falante nativo. Nenhuma reescrita aqui tem como objetivo enganar detector.

Marcas humanas para preservar

Estes detalhes costumam carregar a voz de quem escreve. Preservar, salvo quando atrapalharem o sentido — e nunca "consertar" por padronização:

MarcaExemplo
Contração e fala escrita"pra", "tá", "cê", "né", "tô", "pro". Em registro informal, não expandir para "para", "está", "você" — a forma contraída é escolha do autor. Em texto formal, aí sim a forma plena é a correta
Regionalismo"uai", "oxe", "tchê", "massa", "mano". Não padronizar para um português neutro de manual
Detalhe específico e estranhoUm endereço real, uma citação torta, "o advogado que trabalhava em cima do meu dentista"
Sentimento misto e tensão sem resolução"No geral é bom, mas me incomoda, e não sei explicar direito por quê"
Gíria e referência datadaMeme e piada interna presos a um ano e a um grupo
Aparte, parêntese e autocorreção"(Fico querendo escrever 'quase' aqui, mas foi certeza mesmo.)"
Variação no tamanho das frasesAlternância entre curto e longo. Texto de IA tende a um comprimento médio constante
Escolha consciente em primeira pessoaO corte ou a palavra que o autor sabe justificar

O próprio texto como amostra. Quando a entrada já traz marca forte de autoria — regionalismo, opinião assumida, primeira pessoa, humor, autocorreção, detalhe concreto que só quem viveu conhece —, ela não é saída de chatbot: é escrita de alguém pedindo revisão. Tratar esse texto como a amostra de estilo do autor. Nesse caso o sinal de travessão e o de abertura teatral deixam de valer como regra; apontar o que for encontrado no relatório e deixar a escolha com o autor.

Passo 7 — 🔥 Verificação final

Auditar primeiro nos dois sentidos contra o texto-fonte e as adições aprovadas: toda proposição protegida sobrevive e toda afirmação da candidata tem respaldo. Conferir possibilidade versus promessa, proposta versus compromisso, reconhecimento versus desculpa, condições de oferta e quem assume a responsabilidade. Em criação, auditar contra o material factual aprovado.

Verificar cada item. Marcar ✓, ✗ ou N/A conforme o perfil e o tamanho do trecho.

#Verificação✓/✗
1TRAVA FACTUAL atendida integralmente conforme a definição canônica?
2Argumento, intenção, modalidade e trechos protegidos permanecem intactos?
3Transições e padrões mecânicos detectados foram corrigidos?
4Termos vagos foram precisados somente quando a fonte fornecia material para isso?
5Ritmo e comprimento das frases combinam com o perfil? Em parágrafo com menos de três frases, não exigir três tamanhos distintos.
6Opinião, dúvida, sentimento e primeira pessoa aparecem somente se já existiam ou foram solicitados?
7Perfil de voz e registro permanecem consistentes em cada trecho?
8Estrangeirismos naturais do domínio foram preservados sem tradução forçada?
9Abertura, fechamento e formatação servem ao gênero, sem molde genérico desnecessário?
10Foi feita varredura por —, – e -- usados como aparte, preservando o travessão de diálogo e a frequência da amostra do autor?
11A guarda de falso positivo do Passo 6 foi aplicada, e nenhuma marca humana do autor foi padronizada?
12Lido em voz alta, o texto soa natural dentro do gênero e do público pretendido?

Verificação adicional para perfis de brevidade (Assertivo/Enxuto/Resumo):

#Verificação✓/✗
AToda proposição do original permanece, ainda que compactada?
BNenhum aviso/warning foi removido?
CNenhuma condição de escopo foi generalizada?
DModalidade preservada? ("pode" não virou afirmação)
ENúmeros e thresholds permanecem exatos?
FRegras comuns aplicadas: passo a passo numerado, fecho em ação (não recapitulação), assunto secundário fora do meio?

Falha nos itens 1 ou 2 invalida a candidata. Nos demais itens, corrigir apenas se ainda houver tentativa disponível; não distorcer o gênero para satisfazer a lista. O controle de tentativas do Passo 9 impede repetição indefinida.

Passo 8 — 📊 Avaliação pós-reescrita

Validar a TRAVA FACTUAL antes da avaliação de estilo. Se falhar, descartar a candidata e registrar pontuação nula; naturalidade nunca compensa alteração factual ou semântica.

Por padrão, avaliar qualitativamente correção dos padrões, naturalidade, consistência de voz e legibilidade. Não atribuir nota nem iterar para alcançar um número.

Calcular pontuação somente quando o usuário pedir ou fornecer limiar. Identificá-la como julgamento editorial subjetivo, não como medição ou probabilidade calibrada. Se a validação factual passar e a pontuação estiver ativa, avaliar quatro dimensões de 0 a 100, sempre em relação ao perfil ativo:

DimensãoPesoCritério de avaliação
Remoção de padrões IA35%Quantos padrões do Passo 2 foram eliminados? Algum remanescente?
Naturalidade30%O ritmo combina com o gênero? A voz aparece somente na medida permitida?
Consistência de voz20%O perfil foi mantido do início ao fim, respeitando trechos de outro registro?
Legibilidade15%Frases fluem? Conectivos naturais? Lógica clara?

Pontuação final = Σ (dimensão × peso)

Com pontuação ativa, usar o limiar solicitado ou 80 se foi pedida uma nota sem limiar. Sem pontuação, limiar, pontuacao e convergiu ficam null. Se a pontuação ficar abaixo do limiar e houver nova tentativa, atuar nas dimensões mais baixas. Com pontuação abaixo de 60, mudar a abordagem sem trocar perfil explícito. Indicadores quantitativos opcionais nunca alteram a pontuação.

Passo 9 — 📦 Controle de tentativas e entrega

Executar a seleção de perfil, o inventário e o diagnóstico uma vez. Em cada tentativa, partir do melhor texto seguro e comparar ao texto_fonte imutável e às adições aprovadas. Em criação, comparar ao material factual aprovado. Executar os Passos 3–7 antes da avaliação qualitativa ou da pontuação opcional.

pontuacao_ativa = usuário pediu nota ou forneceu limiar
limiar = (valor solicitado ou 80) se pontuacao_ativa, senão null
melhor_texto = nenhum

para cada tentativa, respeitando o limite do modo:
    gerar candidata
    auditar fonte → candidata e candidata → fonte
    se falhar: descartar candidata sem pontuação
    senão:
        avaliar estilo em relação ao perfil
        calcular nota somente se pontuacao_ativa
        guardar candidata se melhorar o melhor texto seguro
        parar se não houver melhoria útil a fazer
        parar se pontuacao_ativa e nota atingir limiar

se nenhuma candidata for segura:
    estado = reprovada_trava_factual
    devolver texto_fonte sem nota
senão se pontuacao_ativa e melhor nota < limiar:
    estado = melhor_resultado
    devolver melhor_texto com limitação
senão:
    estado = concluida
    devolver melhor_texto

O limite é um máximo, não uma meta: parar quando outro passe não melhorar o resultado. Conservar a melhor candidata segura, não necessariamente a última.

No modo_direto, produzir exatamente uma candidata e não repetir. Se ela falhar na TRAVA FACTUAL, devolver o texto-fonte com estado reprovada_trava_factual.

No modo_criacao não existe texto_fonte para comparação. A validação factual passa a ser: toda afirmação, nome, número, data e citação da candidata vem do material fornecido pelo usuário ou de verificação efetiva. Uma candidata que não passe nesse teste é reescrita, não entregue com ressalva. Se faltar dado, entregar a versão mais simples e nomear a lacuna.

Quando houver nova tentativa, escolher a alternativa pelo problema dominante:

Problema da candidata anteriorPróxima abordagem
Padrões mecânicos remanescentesReforçar a remoção dos padrões detectados
Voz excessiva ou artificialReduzir intervenções e aproximar do registro original
Estrutura previsívelReordenar apenas as proposições existentes
Texto longo inconsistenteTrabalhar por blocos semânticos e validar o conjunto
Perfil detectado inadequadoMudar somente se o usuário não o escolheu e houver evidência no texto-fonte

Contrato de saída

Em pipelines ou quando houver pedido de saída estruturada, usar:

estado: concluida
texto: "texto final ou texto-fonte seguro"
modo: modo_completo  # ou modo_direto, modo_revisão, modo_criacao
perfil_de_voz: voz_neutra
limiar: null  # 80 ou valor solicitado apenas com pontuação ativa
pontuacao: null  # nota editorial somente se solicitada
convergiu: null  # true/false somente com pontuação ativa
trava_factual:
  estado: intacta
  violacoes: []
tentativas:
  usadas: 2
  maximas: 3
relatorio: {}

Sem pontuação ativa, concluida indica que a candidata passou pela auditoria e pela avaliação qualitativa; os três campos numéricos/de convergência ficam null. Com pontuação ativa, usar os valores conforme o estado final:

estadoconvergiupontuacaotexto
concluidatrueNúmero ≥ limiarCandidata segura aprovada
melhor_resultadofalseMelhor número abaixo do limiarMelhor candidata segura
reprovada_trava_factualfalsenulltexto_fonte
entrada_invalidafalsenullEntrada sem reescrita

Em conversa, apresentar primeiro o texto e depois o relatório no nível do modo:

ModoConteúdo do relatório
modo_completoPadrões corrigidos e ressalvas; nota e indicadores somente se solicitados/calculados
modo_diretoRelatório sintético e estado; nota somente se solicitada
modo_revisãoDiagnóstico e ressalvas; nota e indicadores somente se solicitados/calculados
modo_criacaoSomente o texto final. Relatório apenas se o usuário pedir, ou uma linha curta quando faltar dado factual

Integração com ciclos externos

Na primeira chamada, usar o texto recebido como texto_fonte e texto_atual. Nas chamadas seguintes, manter texto_fonte inalterado e realimentar somente o campo texto como texto_atual:

proxima_entrada:
  texto_fonte: "original imutável"
  texto_atual: "saída.texto"
  perfil_de_voz: "mesmo perfil"
  adicoes_aprovadas: []
  limiar: null  # preservar valor solicitado se houver

Nunca realimentar relatório, pontuação ou o envelope inteiro como se fossem parte do texto. Toda chamada continua comparando o resultado ao texto_fonte original e às adições aprovadas com proveniência; em criação, preservar a base factual aprovada entre chamadas.

Estrangeirismos

Brasileiro de tech fala com estrangeirismos. Isso é marca de autenticidade, não erro. A skill preserva:

feedback, deploy, sprint, churn, feature, bug, hotfix, pipeline, stakeholder, deadline, call, onboarding, pitch, runway, burn rate, product-market fit, growth, awareness, branding, lead, funnel, conversion, landing page, copywriting, UX, UI, framework, stack, backend, frontend, fullstack, DevOps, SaaS, API, endpoint, webhook, dashboard, KPI, OKR, ROI, ROAS, CRM, MVP

Forçar tradução desses termos é sinal de IA purista — o oposto de humano.

Regra de ouro: se o termo é usado no dia a dia do domínio em PT-BR, mantenha. Se é anglicismo artificial sem necessidade, remova.

Suíte de testes de regressão

Conjunto mínimo para validar evoluções futuras. Rodar cada caso em modo_completo e conferir preservação semântica antes de julgar estilo.

#TipoAntes (IA)Depois esperado (síntese)
T1E-mail corporativo"Venho por meio deste informar que o relatório será encaminhado oportunamente""O relatório será enviado oportunamente."
T2Parágrafo acadêmico"Diversos autores discutem a questão da linguagem de forma ampla""Diversos autores discutem a linguagem em termos amplos."
T3Texto jurídico"É cediço que a responsabilidade civil objetiva se aplica no âmbito das relações de consumo""A responsabilidade civil objetiva aplica-se às relações de consumo."
T4Modelo de abertura de blog"Neste artigo, exploraremos 5 estratégias essenciais para otimizar seu workflow""Neste artigo, vamos explorar cinco estratégias essenciais para otimizar seu workflow."
T5Ressalva excessiva de IA"Como modelo de linguagem, não posso afirmar com certeza, mas parece que talvez o sistema esteja funcionando""O sistema parece estar funcionando, mas ainda não é possível afirmar com certeza."
T6Didático genérico"João tem 3 maçãs e Maria tem 5. Quantas têm ao todo?""João tem 3 maçãs e Maria tem 5. Quantas maçãs os dois têm ao todo?"
T7Falso positivo (marca humana)"Oxe, eu tô achando que não vale a pena pra gente agora"Inalterado. Regionalismo e contração são voz do autor, não vício de IA
T8Fonte inventada"Segundo Almeida (2019, p. 84), o efeito é consistente" sem que a referência existaAfirmação mantida como está e marcada para verificação; nunca substituir por outra referência

Critério de regressão: se uma evolução piora o resultado de qualquer teste T1-T8, a mudança deve ser reavaliada.

TRAVA FACTUAL nos casos de teste: nenhuma saída esperada pode adicionar, retirar ou alterar conteúdo protegido. Resultado mais contido é preferível a uma versão mais vistosa que invente informação.

Avaliação com Jev (opcional)

Somente quando o usuário solicitar avaliação externa e Jev já estiver disponível, a skill pode usar TypeSafe Jev para avaliação calibrada — um modelo que retorna decisões tipadas com probabilidades precisas. O LLM continua fazendo a reescrita. Scoring permanece opcional; nenhuma decisão do avaliador supera uma violação semântica detectada. Não instalar serviços, escolher provedores pagos ou delegar automaticamente.

Protocolo de Descoberta

A skill não assume que Jev está disponível. Antes de usar, execute o protocolo de descoberta:

1. Verificar MCP tools disponíveis no harness
   → Se existir tool "jev_eval" ou similar → usar
   
2. Verificar se harness usa OpenRouter
   → Se sim, solicitar modelo `typesafe/jev-latest`
   
3. Verificar slots auxiliares (Hermes, Devin)
   → Se slot approval/custom configurado com Jev → usar
   
4. Fallback → avaliação inline via LLM atual

Descoberta por Harness

HarnessComo detectar Jev
Claude CodeVerificar MCP em .claude/mcp.json → tool jev_eval
CursorVerificar se OpenRouter é provider → modelo typesafe/jev-latest
DevinVerificar agents/*.md → profile com model: typesafe/jev-latest
HermesVerificar config.yaml → auxiliary.approval.model
Kiro/Copilot/ClineVerificar MCP servers ou lista de modelos disponíveis
Aider/OpenCodeVerificar providers configurados

Por que usar Jev

AspectoAvaliação LLMAvaliação Jev
ConsistênciaVaria entre chamadasDeterminístico
CalibraçãoP(70%) ≠ 70% realP(70%) = 70% real
Custo~$0.01-0.05/avaliação~$0.0001-0.0002/avaliação
Latência1-5s70-500ms
OutputTexto (precisa parsing)Estruturado nativo

Economia: ~50-100x mais barato que GPT-4.

Quando preferir avaliação LLM

  • Textos muito curtos (<50 palavras)
  • modo_direto com pressa
  • Debug/desenvolvimento (mais fácil inspecionar reasoning)
  • Jev não disponível no harness

Mapeamento de passos para Jev

PassoPrimitivo JevPerguntas
Passo 2 (Diagnóstico)Noul52 perguntas binárias (padrões de IA)
Passo 6 (Falso positivo)Noul2 perguntas (marca humana, gênero formal)
Passo 7 (Verificação)Noul4 perguntas (TRAVA FACTUAL, argumento, modalidade)
Passo 8 (Avaliação)Score4 dimensões ponderadas

Arquivos relacionados

ArquivoDescrição
scripts/jev_questions.json56 perguntas tipadas (Noul + Score)
references/jev-integration.mdProtocolo completo, formatos request/response

Documentação completa: Ver references/jev-integration.md para detalhes do protocolo de descoberta, estrutura de requests/responses e instruções por harness.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Audit, score, and compare repositories containing portable Agent Plugins against the official Agent Plugins specification. Use when asked to review a plugin repo, check plugin.json or mcp.json conformance, assess bundled skills and MCP servers, produce an evidence-cited 0–100 plugin scorecard, identify release blockers, or compare two agent plugins side by side.

日本語の概要は準備中です。原文の説明を表示しています。

fabricioctelles/skills1082026年10月12日 更新

Sub-skill de agent-ready-cloudflare: Implement A2A Agent Card

日本語の概要は準備中です。原文の説明を表示しています。

fabricioctelles/skills1082026年10月12日 更新

Sub-skill de agent-ready-cloudflare: Implement ACP Discovery Document

日本語の概要は準備中です。原文の説明を表示しています。

fabricioctelles/skills1082026年10月12日 更新

Sub-skill de agent-ready-cloudflare: Implement Agent Skills Discovery Index

日本語の概要は準備中です。原文の説明を表示しています。

fabricioctelles/skills1082026年10月12日 更新

Sub-skill de agent-ready-cloudflare: Implement AI Bot Rules in robots.txt

日本語の概要は準備中です。原文の説明を表示しています。

fabricioctelles/skills1082026年10月12日 更新

Sub-skill de agent-ready-cloudflare: Implement API Catalog

日本語の概要は準備中です。原文の説明を表示しています。

fabricioctelles/skills1082026年10月12日 更新

fabricioctelles のスキルをすべて見る

このスキルの問題を報告する