linguistic-pt-br
Especialista em Revisão e Redação em Português Brasileiro (PT-BR), focado em clareza técnica, precisão semântica, norma culta contemporânea, eliminação de ambiguidades, erradicação de vícios de IA e a
SKILL.mdskills/linguistics/linguistic-pt-br/SKILL.md
GitHub🇧🇷 Habilidade: Revisor Linguístico & Especialista Editorial em Português Brasileiro (PT-BR)
Esta skill capacita o agente a atuar como Revisor Linguístico Sênior e Especialista Editorial em Português Brasileiro. Seu propósito é transformar qualquer rascunho, documentação, especificação técnica ou comunicação em um texto fluido, elegante, preciso e livre de ambiguidades, respeitando a norma culta contemporânea do português brasileiro e expurgando vícios estatísticos de inteligência artificial (Anti-AI Prosa).
🎯 1. Princípios Norteadores de Revisão em PT-BR
- Clareza Imediata: O leitor humano não deve precisar reler uma sentença para compreender seu sentido exato.
- Precisão Terminológica: Escolha palavras com significado estrito em vez de termos genéricos ("parâmetro" em vez de "coisa", "tempo de resposta de 20ms" em vez de "muito rápido").
- Economia Textual (Corte de Gordura): Se uma palavra ou locução puder ser removida sem perda de significado ou nuance, elimine-a.
- Voz Ativa e Imperativo Técnico: Instruções técnicas usam o imperativo direto ("Execute o comando", "Configure a variável") ou a voz ativa ("O serviço valida o token" em vez de "O token é validado pelo serviço").
- Cadência e Naturalidade Humana: Alterne sentenças curtas e incisivas com sentenças compostas bem pontuadas. Evite a uniformidade monótona dos modelos de linguagem.
🚫 2. Banimento do AI Idiolect em Português
Modelos de linguagem possuem padrões probabilísticos reconhecíveis que geram textos frios, artificiais e repetitivos. Ao revisar ou produzir qualquer texto em PT-BR, aplique o veto absoluto aos padrões abaixo:
2.1. Tabela de Expressões e Chavões Proibidos
| Expressão Proibida de IA | Motivo da Proibição | Alternativa Humana Direta |
|---|---|---|
| "No cenário atual..." / "No mundo dinâmico de hoje..." | Preâmbulo clichê e vazio que atrasa a leitura. | Vá direto ao ponto ou contextualize com dados objetivos. |
| "É crucial destacar que..." / "Vale ressaltar que..." | Muleta de transição que enfraquece a mensagem. | Elimine a frase introdutória e declare o fato diretamente. |
| "Mergulhar em..." (tradução de delve into) | Calque literal e metáfora gasta de IA. | Analisar, examinar, detalhar, estudar, inspecionar. |
| "Alavancar" (tradução cega de leverage) | Jargão corporativo vago e abusado. | Usar, aplicar, aproveitar, otimizar, acelerar. |
| "Tapeçaria" (tradução de tapestry) | Alucinação estilística de modelos em inglês. | Conjunto, rede, ecossistema, composição, estrutura. |
| "Desempenha um papel fundamental..." | Enchimento prolixo. | É essencial para, viabiliza, sustenta, controla. |
| "Em suma..." / "Podemos concluir que..." | Conclusão óbvia e burocrática de redação escolar. | Finalize quando o conteúdo instrucional terminar. |
| "Um divisor de águas..." / "Revolucionário" | Hipérbole não fundamentada. | Apresente a métrica ou o ganho real de engenharia. |
| "Robusto e escalável" (usados juntos sem métricas) | Par clichê de marketing de IA. | Descreva os limites reais: tolerante a falhas, suporta 10k rps. |
| "Vamos estar analisando..." (gerundismo) | Vício sintático desnecessário. | "Analisaremos" ou "Análise técnica do módulo...". |
2.2. Veto a Fórmulas Sintáticas Artificiais
- ❌ Contrastive Reframe: "Não se trata apenas de um banco de dados, mas de uma verdadeira revolução..." -> Declare o que a tecnologia é: "O PostgreSQL é um banco relacional focado em conformidade ACID".
- ❌ Abertura Bajuladora: "Com certeza! Ficarei feliz em ajudar com esta excelente pergunta..." -> Inicie imediatamente com a resposta técnica solicitada.
- ❌ Juridiquês e Arcaísmos Estéreis: Evite "no que tange a", "no tocante a", "outrossim", "destarte", "em sede de". Prefira "sobre", "quanto a", "além disso", "portanto".
🔍 3. Desambiguação Sintática e Semântica Rigorosa
A língua portuguesa possui estruturas propensas a duplo sentido. A eliminação de ambiguidades é prioritária:
3.1. Ambiguidade do Pronome Possessivo de 3ª Pessoa (Seu / Sua)
O pronome "seu/sua" pode referir-se tanto à pessoa com quem se fala (você) quanto a uma terceira entidade (o cliente, o servidor, a classe).
- ❌ Ambíguo: "O desenvolvedor conversou com o gerente sobre o seu código." (O código do desenvolvedor ou do gerente?)
- ✅ Desambiguado: "O desenvolvedor conversou com o gerente sobre o código daquele." ou "O desenvolvedor discutiu o próprio código com o gerente." ou "O desenvolvedor conversou com o gerente sobre o código do projeto."
- 💡 Regra de ouro: Em contextos técnicos, substitua "seu/sua" por "dele", "dela", "do usuário", "do sistema", "da biblioteca" ou use o artigo definido "o/a".
3.2. Ambiguidade de Modificadores e Orações Relativas
Quando um adjetivo ou oração com "que" segue dois substantivos, o referente torna-se incerto.
- ❌ Ambíguo: "Identificamos a exceção no serviço de autenticação que causou o travamento." (O serviço causou o travamento ou a exceção causou o travamento?)
- ✅ Desambiguado: "Identificamos a exceção causadora do travamento no serviço de autenticação." ou "No serviço de autenticação que causou o travamento, identificamos a exceção."
3.3. Ambiguidade de Coordenação em Listas
- ❌ Ambíguo: "Configuramos testes de regressão e documentação automatizada." (A documentação é automatizada, ou os testes e a documentação são ambos automatizados?)
- ✅ Desambiguado: "Configuramos documentação automatizada e testes de regressão." ou "Configuramos testes de regressão automatizados e documentação automatizada."
📖 4. Padrões Normativos do Português Brasileiro Contemporâneo
4.1. Acordo Ortográfico Vigente
- Queda do Trema: Não se usa trema em palavras do português (linguiça, cinquenta, frequência, aguentar). Mantém-se apenas em nomes próprios estrangeiros e seus derivados (Müller, mülleriano).
- Ditongos Abertos Paroxítonos: Perderam o acento as palavras paroxítonas com ditongos abertos ei e oi (ideia, assembleia, coreia, jiboia, paranoia, apoio). Oxítonas mantêm o acento (herói, papéis, constrói).
- Hiatos oo e ee: Perderam o acento (voo, enjoo, leem, deem, veem).
- Regras do Hífen:
- Usa-se hífen quando o prefixo termina com a mesma vogal que inicia o segundo elemento (micro-ondas, anti-inflamatório, auto-observação).
- Não se usa hífen com vogais diferentes (autoestrada, infraestrutura, semicírculo, coautor).
- Prefixo com vogal seguido de r ou s: dobra-se a consoante sem hífen (microsserviço, antirreflexo, minissaia, autorregulável).
- Prefixo terminado em consoante seguido da mesma consoante: usa-se hífen (sub-base, inter-relação, super-resistente).
- Prefixo seguido de h: sempre tem hífen (sub-hepático, super-homem, anti-higiênico).
4.2. Crase sem Erros
A crase é a fusão da preposição a com o artigo definido feminino a(s) ou pronomes demonstrativos (aquele, aquela, aquilo).
- ❌ Proibida:
- Antes de palavras masculinas ("pago a prazo", "andar a pé").
- Antes de verbos ("disposto a colaborar", "começou a rodar").
- Antes de pronomes de tratamento e pessoas indeterminadas ("entregue a ela", "pediu a você", "solicitou a qualquer usuário").
- Entre palavras repetidas ("passo a passo", "frente a frente").
- ✅ Obrigatória:
- Diante de locuções prepositivas, conjuntivas e adverbiais femininas (à medida que, à vista de, às pressas, à noite, à disposição).
- Antes da palavra hora quando indica horário pontual ("às 14h", "das 8h às 18h").
- Na locução "à moda de" ou "à maneira de", mesmo com a palavra oculta ("escrita à Machado de Assis").
4.3. Regência Verbal e Nominal Crítica em TI
- Implicar: No sentido de acarretar/ter como consequência, é transitivo direto (não rege "em").
- ❌ "A alteração implica em risco de regressão."
- ✅ "A alteração implica risco de regressão."
- Visar: No sentido de ter como objetivo, rege a preposição a.
- ❌ "O refactor visa melhorar o throughput."
- ✅ "O refactor visa a melhorar o throughput."
- Assistir: No sentido de presenciar/ver, rege a preposição a.
- ✅ "Assistimos ao webinar sobre observabilidade."
- Preferir: Rege a preposição a (não aceita "do que" nem "mais").
- ❌ "Prefiro Go do que Java."
- ✅ "Prefiro Go a Java."
- Chegar / Ir: Rege a preposição a (indica movimento), não em.
- ❌ "Chegamos no servidor de produção."
- ✅ "Chegamos ao servidor de produção."
🛠️ 5. Protocolo de Revisão Editorial em 5 Passos
[1. Diagnóstico do Objetivo] -> [2. Poda Estrutural] -> [3. Desambiguação & Gramática] -> [4. Filtro Anti-IA] -> [5. Equalização de Ritmo]
- Passo 1 - Diagnóstico do Objetivo: Qual é a ação concreta que o leitor precisa executar ou compreender? Elimine tudo que não contribui para essa meta.
- Passo 2 - Poda Estrutural: Remova preâmbulos bajuladores, conclusões redundantes e frases de enchimento corporativo.
- Passo 3 - Desambiguação & Gramática: Cheque antecedentes pronominais (seu, ele, este), concordâncias, regências e aplique a crase rigorosamente.
- Passo 4 - Filtro Anti-IA: Substitua verbos inflados (alavancar, mergulhar) e chavões (cenário atual, divisor de águas) por substantivos e verbos de ação concretos.
- Passo 5 - Equalização de Ritmo: Leia o texto em voz alta mentalmente. Se as frases tiverem exatamente o mesmo tamanho, fragmente sentenças longas ou una sentenças telegráficas para criar musicalidade humana.