unslop — Remova Padrões de Escrita de IA via CLI

Visão Geral

unslop é uma ferramenta CLI que pós-processa texto para remover padrões de escrita de IA programaticamente. Ao contrário de habilidades que pedem ao agente para evitar "AI-ismos", o unslop funciona como uma etapa determinística de pipeline: envie texto, receba texto limpo. Use-o como uma passagem final antes de confirmar documentos, publicar posts ou enviar qualquer conteúdo gerado por IA para produção.

O flag --deterministic torna a saída reproduzível — a mesma entrada sempre produz a mesma saída. O flag --stdin lê da entrada padrão (stdin), permitindo a composição de pipelines no shell.

Quando Usar Esta Habilidade

• Quando você tem texto gerado por IA pronto para publicar e quer uma passagem final de limpeza.
• Ao trabalhar em um pipeline de shell onde a qualidade do texto precisa ser aplicada automaticamente.
• Ao escrever hooks de commit ou etapas de CI que validam o conteúdo antes que ele seja enviado.
• Quando você precisa de normalização de texto reproduzível em várias execuções.

Configuração

Instale uma vez:

pipx install unslop
# or
uv tool install unslop

Verifique:

unslop --version

Como Funciona

Etapa 1: Envie Texto Através do unslop

Limpeza padrão (pode variar ligeiramente entre execuções):

echo "This leverages cutting-edge AI to deliver robust solutions." | unslop --stdin

Limpeza determinística (mesma entrada → mesma saída a cada execução):

echo "This leverages cutting-edge AI to deliver robust solutions." | unslop --stdin --deterministic

Etapa 2: Use em Pipelines de Shell

Envie a saída de qualquer comando através do unslop:

cat draft.md | unslop --stdin --deterministic > clean.md

Ou encadeie com outras ferramentas:

cat draft.md | unslop --stdin --deterministic | pbcopy   # macOS: copy clean text to clipboard

Etapa 3: Integre em Hooks de Commit ou CI

Adicione a um hook de pré-commit ou etapa de CI para impor portões de qualidade em qualquer conteúdo gerado antes que ele seja enviado:

# In .git/hooks/pre-commit or a CI script
CONTENT=$(cat docs/changelog.md)
CLEANED=$(echo "$CONTENT" | unslop --stdin --deterministic)
if [ "$CONTENT" != "$CLEANED" ]; then
  echo "Changelog contains AI writing patterns. Run: cat docs/changelog.md | unslop --stdin --deterministic > docs/changelog.md"
  exit 1
fi

Exemplos

Exemplo 1: Limpe um Documento Rascunho

cat blog-post-draft.md | unslop --stdin --deterministic > blog-post-final.md

Exemplo 2: Limpeza Inline Durante a Escrita

# Write content, pipe through unslop, write result back
cat README.md | unslop --stdin > README.clean.md && mv README.clean.md README.md

Exemplo 3: Valide Antes de Submeter um PR

# Check if any generated docs need cleanup
for f in docs/*.md; do
  ORIGINAL=$(cat "$f")
  CLEANED=$(echo "$ORIGINAL" | unslop --stdin --deterministic)
  [ "$ORIGINAL" != "$CLEANED" ] && echo "Needs cleanup: $f"
done

Melhores Práticas

• ✅ Use --deterministic em CI e automação para garantir saída reproduzível.
• ✅ Execute no rascunho final, não em iterações intermediárias.
• ✅ Combine com a habilidade avoid-ai-writing para orientação no momento da geração e pós-processamento.
• ❌ Não execute em arquivos de código — o unslop visa prosa, não código-fonte.
• ❌ Não pule a revisão após o unslop: a limpeza automatizada pode ocasionalmente alterar o significado; leia a saída.

Limitações

• Processa apenas prosa — não código, JSON ou dados estruturados.
• Não detecta erros factuais ou problemas substantivos de escrita.
• Algumas substituições podem não se encaixar em todos os contextos; revise a saída antes de publicar.
• Requer ferramentas Python como pipx ou uv para instalação CLI autônoma.

Notas de Segurança e Proteção

• O unslop lê da entrada padrão e escreve na saída padrão — sem efeitos colaterais no sistema de arquivos por padrão.
• O modo --deterministic é local e não faz chamadas de API LLM.
• O modo LLM padrão pode usar ANTHROPIC_API_KEY ou o Claude CLI; use --deterministic para arquivos locais sensíveis e portões de CI.
• Seguro para executar em pipelines de CI e hooks de commit quando fixado no modo determinístico.