robcsaszar/prose

Prosa

Dois modos. Detecte o correto antes de fazer qualquer outra coisa.

Detecção de Modo

Modo Redação — o usuário tem um tópico, briefing ou esboço e deseja um novo conteúdo escrito. Modo Revisão — o usuário tem um texto existente e deseja melhorá-lo, humanizá-lo ou avaliá-lo.

Se ambíguo: pergunte — "Você quer que eu escreva um novo conteúdo ou revise/reescreva algo que você já tem?" Se o usuário não responder, o padrão é o Modo Redação.

---

Calibração de Voz

Antes de redigir ou reescrever, peça uma amostra de voz se o usuário não tiver fornecido uma. Para alvos de formato curto (mensagens instantâneas, e-mails com menos de 200 palavras): pule a calibração de voz, a menos que o usuário já tenha fornecido uma amostra.

"Compartilhe de 1 a 3 parágrafos da sua própria escrita que mais pareçam com você. Eu vou igualar seu ritmo de frases, escolha de palavras e hábitos estruturais."

Analise a amostra para:

• Tendência de comprimento de frases (incisiva / analítica / mista)
• Como o texto abre (afirmação primeiro, história primeiro, dados primeiro, contexto primeiro)
• Hábitos de pontuação (parênteses, dois pontos, ponto e vírgula)
• Frases recorrentes ou tiques verbais
• Como o texto termina (princípio, desafio, pergunta em aberto, ação)
• Palavras que nunca usa

Persistindo o perfil. Após analisar uma amostra, ofereça-se para salvar o resultado para que sessões futuras pulem a recalibração: preencha references/voice-profile-template.md e escreva em references/voice-profile.md dentro da pasta da skill (se a pasta for somente leitura, exiba o perfil completo para o usuário salvar). Se references/voice-profile.md já existir, leia-o por completo antes de redigir ou reescrever — ele substitui as convenções padrão (tolerância a travessão, estilo de citação, frases prediletas, registros). Em "aprenda com este texto também": anexe observações datadas ao perfil existente; conflitos são resolvidos em favor da amostra mais recente. Um perfil nunca pode substituir a disciplina factual, a acessibilidade ou as regras NUNCA.

Se não houver amostra e nenhum perfil salvo: prossiga com a voz padrão — veja references/drafting-core.md § "Voz Padrão". Para blog, ensaio, opinião ou escrita pessoal, veja também references/personality-and-soul.md — uma voz padrão limpa ainda pode soar sem alma sem isso. Se o texto for publicado sob o nome do usuário, mencione que a saída não calibrada carrega uma voz padrão genérica e ofereça a calibração — uma vez por conversa, depois abandone o assunto.

---

Modo Redação

Fase 0 — Entenda antes de escrever

Pergunte antes de redigir:

1. O que o leitor precisa fazer ou sentir após a leitura? (determina o meio e a adequação ao público)
2. O que realmente surpreenderia este leitor — o que ele já pensa que sabe que está incompleto?
3. Qual é o trabalho único deste texto — informar, persuadir, instruir, entreter ou converter?
4. Qual registro se encaixa no contexto — formal, casual, técnico, conversacional — e ele permanecerá estável?
5. Linha condutora — um exemplo concreto, caso ou consequência que possa carregar peso real

Se for orientado a tarefas: a resposta ou próxima ação vem primeiro. Se for de formato longo: escolha a linha condutora e uma âncora concreta antes de redigir.

Antes de redigir, pergunte: qual é o exemplo concreto ou consequência que pode carregar esta peça? Se você não consegue nomeá-lo, não está pronto para redigir.

LEITURA OBRIGATÓRIA antes de redigir algo com mais de 200 palavras: → references/drafting-core.md — regras principais e padrões específicos de meio

Para alvos de Documentação ou Criativos, leia também as regras de reescrita daquele canal antes de redigir — ambos suspendem os padrões que se aplicam em todos os outros lugares: → references/channel-rules.md § Documentação / § Criativo

NÃO carregue references/ai-patterns-universal.md durante a redação — é apenas para revisão.

Fase 1 — Redija

Escreva para se adequar ao contexto real, não a um ideal abstrato de "boa escrita".

Princípios ativos:

• Cada parágrafo substancial carrega pelo menos uma âncora concreta (nome próprio, número específico, citação direta, decisão nomeada, detalhe verificável). Para blog, artigo e mídia social. Para IM e e-mail curto: uma âncora por mensagem é suficiente.
• Sem afirmações vagas: "muitos", "vários", "amplas implicações", "mudanças significativas" falham no teste da âncora
• Use palavras simples; repita a palavra comum quando for a palavra certa; prefira verbos a nominalizações
• Mantenha o registro estável; combine o formato com o meio

Fase 2 — Revise

OBRIGATÓRIO: Execute as verificações necessárias após redigir. → references/required-checks.md

Se um shell estiver disponível, execute também o scanner determinístico no rascunho — anti-slop se aplica a novos escritos, não apenas revisões:

python3 scripts/slop-scan.py --channel <medium> draft.md

Todos os scripts e caminhos de referência nesta skill são relativos ao diretório da skill, não ao diretório de trabalho. Instalado como plugin, os dois raramente são os mesmos: resolva scripts/slop-scan.py em relação ao diretório de onde este SKILL.md foi carregado. Trate "arquivo não encontrado" como um problema de caminho para corrigir uma vez, não como "sem shell" — cair para a camada manual silenciosamente descarta toda a passagem determinística.

Corrija detritos incondicionalmente. Verifique cada sinalizador de frase contra as regras de falso positivo antes de alterá-lo (a palavra sinalizada pode simplesmente ser a palavra certa). Anotações de estrutura alimentam o mesmo julgamento que a verificação obrigatória 5.

Se a peça ainda parecer estranha após as verificações necessárias (apenas trabalhos mais longos): → references/long-form-diagnostics.md

Quando exemplos de revisão ajudariam: → references/examples.md

---

Modo Revisão / Humanizar

NÃO carregue references/drafting-core.md durante o Modo Revisão/Humanizar — é apenas para redação.

Etapa 0 — Detecte automaticamente o tipo de conteúdo

Classifique o canal antes de executar qualquer verificação. Informe a detecção no topo da revisão.

E-mail — tem: linha de assunto / fórmula de saudação (Oi Nome, Caro Nome) / pedido explícito + estrutura de despedida mídia social — tem: uma frase por linha em todo o texto / hashtags / CTA de engajamento no final / menos de 3.000 caracteres sem cabeçalhos IM — tem: @menções / referências de canal / tom casual / menos de 500 caracteres / sem saudação ou despedida Documentação — tem: procedimentos numerados / verbos de etapa no imperativo / blocos de código, comandos CLI ou chaves de configuração / tabelas de API, parâmetros ou opções / sem narração em primeira pessoa Criativo — tem: diálogo com pontuação de fala / estrutura de cena, estrofe ou script / narração com personagens nomeados / quebras de linha usadas para ritmo em vez de estrutura de lista Post de blog — tem: cabeçalhos / 3.000+ caracteres de prosa estruturada / múltiplos parágrafos desenvolvidos

Verifique Documentação e Criativo antes de Blog. Ambos têm cabeçalhos e parágrafos desenvolvidos, então um manual ou uma cena corresponderão aos sinais de Blog também, e Blog é o padrão errado para qualquer um deles.

Se um canal corresponder claramente: informe a detecção e prossiga. Se ambíguo (sinais conflitam ou nenhum dispara): pergunte — "Qual é o formato? Post de blog, mídia social, E-mail, IM, Documentação ou Criativo?" Não prossiga até ser respondido.

Etapa 1 — Varredura de padrões de IA

Primeiro passe determinístico. Se um shell estiver disponível, salve o texto em um arquivo e execute:

python3 scripts/slop-scan.py --channel <detectado> file.md

Os nomes dos canais mapeiam para valores de sinalizador: Post de blog → blog, mídia social → social, E-mail → email, IM → im, Documentação → docs, Criativo → creative. Cada canal suprime as regras que seu meio legitima quebrar, portanto passar o errado produz tanto falsos positivos quanto marcas perdidas.

O scanner relata marcas mecânicas (detritos, frases formulaicas, tipografia) e métricas de estrutura (monotonia de frases, parágrafos uniformes, confiança uniforme, orçamento de aforismos, execuções de anáfora, parágrafos rotulados ordinalmente, conceitos cunhados, duplicação literal) com saída estável e repetível. Passe --allow <id-regra> para qualquer coisa que o perfil de voz ou meio legitime. Sem shell: aplique references/formula-watchlist.md manualmente como a camada mecânica.

Segundo passe de julgamento. LEITURA OBRIGATÓRIA — marcadores universais primeiro: → references/ai-patterns-universal.md

Depois carregue marcadores específicos de canal: → references/ai-patterns-channels.md

Aplique marcadores universais a TODO o conteúdo. Aplique marcadores específicos de canal apenas para o tipo detectado. Liste cada item sinalizado — acertos do scanner e bandeiras de julgamento — com a citação exata e sua localização.

Etapa 2 — Verificação adversarial

Cada sinalizador da Etapa 1 deve sobreviver a uma defesa antes de entrar no relatório. Para cada sinalizador, argumente o caso mais forte de que é um FALSO POSITIVO, usando as regras "O que NÃO Sinalizar" em ai-patterns-universal.md:

• A frase está dentro de uma citação, título, nome próprio ou um exemplo sendo discutido em vez de usado?
• É claramente a palavra certa aqui, aparecendo uma vez, sem aglomerado de outras marcas ao redor?
• É uma convenção do meio (estrutura em docs, saudações em e-mail) ou explicitamente permitida pelo perfil de voz?
• A sinalização "estrutural" é realmente a forma correta para este gênero (especificação, manual, página de referência)?

Veredito por sinalizador: CONFIRMADO (a defesa falha) ou DISPENSADO (razão de uma linha). Apenas sinalizadores confirmados prossiga. Acertos de detritos (artefatos de chat, placeholders, fragmentos de rastreamento) são sempre confirmados — não há uso legítimo.

Esta etapa existe para proteger a prosa real: editar demais um texto que estava bom é tanto uma falha quanto perder uma marca.

Etapa 3 — Verificação de originalidade

Sinalize se o conteúdo:

• Poderia ter sido escrito por qualquer um com um mecanismo de busca (sem autoridade conquistada, sem experiência específica)
• Não tem experiência em primeira mão, história de cliente ou evidência concreta em nenhum lugar
• Faz o mesmo ponto duas vezes sem adicionar profundidade
• Recicla enquadramento do setor ("o futuro de X é Y")
• Falta o fator "só eu poderia escrever isso"

mídia social extra: sinalize plugs de produto disfarçados de lições; histórias pessoais com takeaways de biscoito da sorte.

Etapa 4 — Pontuação

LEITURA OBRIGATÓRIA para dimensões de pontuação por canal: → references/channel-rules.md

Forneça uma frase de justificativa para cada pontuação. Se a Probabilidade de IA for baixa, mas a dimensão de substância também for baixa — Credibilidade de Domínio (blog/social), Clareza (e-mail/IM), Conclusão de Tarefa (documentação) ou Moderação (criativo) — sinalize explicitamente. Conteúdo limpo, mas oco.

Etapa 5 — Relatório de revisão estruturado

LEITURA OBRIGATÓRIA para estrutura de relatório: → references/review-report-template.md

Relate apenas sinalizadores confirmados; informe a contagem de sinalizadores dispensados em uma linha.

Etapa 6 — Reescrita

Escolha o escopo de edição primeiro (escolha você mesmo se o usuário não definiu um; diga qual você escolheu se isso importar):

• Edição livre (padrão para "humanize isso") — frases vazias são deletadas, não reescritas; o comprimento pode diminuir visivelmente.
• Edição cuidadosa (o texto deve preencher um espaço: documento de cliente, formato fixo) — a estrutura sobrevive; o comprimento permanece entre 80–110% do original.
• Edição mínima (apenas mediante solicitação explícita) — toque apenas em construções inequívocas de IA.

Regras universais de reescrita:

1. Nunca adicione ideias que não estão no original; nunca remova substância
2. Substitua cada frase sinalizada de IA por linguagem natural
3. Varie o comprimento das frases: misture linhas curtas e incisivas com outras mais longas e analíticas
4. Substitua aberturas genéricas por um gancho específico (história, dado, afirmação contrária)
5. Substitua conclusões de resumo por um desafio, princípio ou pergunta em aberto
6. Quebre o ritmo uniforme dos parágrafos: alguns curtos, alguns longos
7. Se exemplos concretos estiverem faltando: deixe [ADICIONE EXEMPLO ESPECÍFICO DA SUA EXPERIÊNCIA] — nunca invente
8. Editar não é verificar fatos: uma afirmação que o texto não suporta não é necessariamente falsa — o autor pode ter dados além do texto. Suavize a redação para o que o texto pode suportar, ou sinalize que a versão pública precisa de comprovantes. Não delete silenciosamente a afirmação como não verificada.

Exceções de canal às regras 3–6. Estas quatro são regras de ritmo de prosa e dois canais não as querem:

• Documentação — não varie o comprimento das frases, quebre o ritmo do parágrafo, substitua uma abertura por um gancho ou transforme um resumo final em uma pergunta em aberto. A forma uniforme é o que torna um procedimento seguível, e uma especificação que termina com uma provocação falhou. As regras 1, 2, 7 e 8 ainda se aplicam.
• Criativo — a regra 5 se inverte: uma linha final que afirma o significado da peça é a marca, então corte-a em vez de substituí-la por um princípio ou desafio. As regras 3 e 6 são decisão do escritor, não sua.

Para blog, ensaio, opinião ou escrita pessoal (não conteúdo enciclopédico, técnico, jurídico ou de referência): LEITURA OBRIGATÓRIA → references/personality-and-soul.md — remover padrões de IA produz prosa limpa; esta seção é o que a faz soar como alguém.

LEITURA OBRIGATÓRIA para regras de reescrita específicas de canal: → references/channel-rules.md

Loop de eliminação. Uma única passagem de reescrita não é o estado final. Itere até que o texto sobreviva tanto a uma verificação determinística quanto a uma adversarial, até 3 rodadas:

1. Reescreva aplicando os sinalizadores confirmados e as regras acima.
2. Re-examine — execute scripts/slop-scan.py na reescrita (mesmo conjunto --allow). Qualquer detrito = corrija imediatamente. Quaisquer novas frases sinalizadas = corrija ou justifique.
3. Acuse — mude de lado: argumente o caso mais forte de que a reescrita ainda é gerada por IA. Verifique especificamente contra as marcas de segunda ordem em references/ai-patterns-universal.md § Parte 5 — uma passagem de limpeza tende a produzi-las: confiança uniforme, um fechamento aforístico em cada parágrafo, "Isso não é X. Isso é Y.", sem folga em lugar nenhum, vulnerabilidade performática (uma admissão que não custa nada ao escritor) e suspense fabricado substituindo os ganchos que você acabou de deletar. Cite a evidência em uma linha cada.
4. Se a acusação tiver fundamento, corrija e repita a partir de 2. Se não tiver, ou após 3 rodadas, pare.

Critérios de saída: scanner relata 0 detritos; sinalizadores restantes do scanner cada um tem uma justificativa de uma linha (convenção do meio ou perfil de voz); a acusação (etapa 3) não encontra nenhuma marca de IA defensável. Pare cedo se o texto for curto (< 200 palavras) — uma rodada geralmente é suficiente.

---

Apêndice: Referências e Scripts

Todas as referências abaixo devem ser lidas em pleno quando solicitado pela skill. Caminhos relativos ao diretório da skill.

• references/drafting-core.md — regras de redação e padrões de meio
• references/channel-rules.md — regras de reescrita por canal
• references/voice-profile-template.md — modelo para perfil de voz
• references/voice-profile.md — perfil de voz salvo
• references/ai-patterns-universal.md — marcadores universais de padrões de IA
• references/ai-patterns-channels.md — marcadores específicos de canal
• references/formula-watchlist.md — lista de frases formulaicas (modo sem shell)
• references/required-checks.md — verificações obrigatórias
• references/long-form-diagnostics.md — diagnóstico para trabalhos longos
• references/review-report-template.md — modelo de relatório de revisão
• references/examples.md — exemplos de revisão
• references/personality-and-soul.md — personalidade e alma para escrita pessoal
• scripts/slop-scan.py — scanner determinístico de IA