anti-distill

Visão geral da skill anti-distill

O que a anti-distill faz

A skill anti-distill é uma skill de reescrita de documentos para transformar um arquivo detalhado de skills de colaborador, guia de trabalho ou documento de persona em uma versão que “parece completa, mas teve o conhecimento central removido”. Na prática, sua função não é resumir genericamente; ela classifica o que é seguro manter, o que deve ser diluído, o que deve ser removido e o que deve ser mascarado, e então reescreve com base nisso.

Para quem a anti-distill é indicada

A anti-distill funciona melhor para quem já escreveu documentação interna de skill e quer uma versão mais limpa para uso externo ou segura para revisão. Ela é especialmente relevante em tarefas de Rewriting envolvendo SKILL.md, work.md, persona.md, SOPs, documentos de handoff ou entradas mistas em Markdown/TXT/PDF. Se você precisa preservar com fidelidade o nível de detalhe de um especialista, esta não é a ferramenta certa.

O que diferencia esta skill anti-distill

O principal diferencial é que a anti-distill usa um fluxo explícito de classificação + reescrita, em vez de depender de um prompt vago do tipo “deixe isso menos específico”. O repositório inclui arquivos de prompt separados para classificação e para diferentes tipos de documento: prompts/classifier.md, prompts/diluter_work.md, prompts/diluter_persona.md e prompts/diluter_general.md. Essa estrutura reduz a margem de adivinhação ao reescrever conhecimento de trabalho versus traços de persona.

Principais trade-offs antes de instalar

A anti-distill reduz a utilidade de forma intencional. Um bom resultado deve continuar estruturalmente crível e tecnicamente não incorreto, mas ficar menos executável, menos específico e menos transferível. Esse é o objetivo. O risco é limpar demais e gerar texto obviamente vazio, ou limpar de menos e deixar passar know-how operacional, limites, caminhos de escalonamento ou lógica de decisão.

Como usar a skill anti-distill

Instale a anti-distill no Claude Code ou OpenClaw

O repositório traz instruções de instalação manual, não um instalador em pacote. No Claude Code, faça o clone em skills do projeto ou globais:

mkdir -p .claude/skills
git clone https://github.com/leilei926524-tech/anti-distill.git .claude/skills/anti-distill

Ou globalmente:

git clone https://github.com/leilei926524-tech/anti-distill.git ~/.claude/skills/anti-distill

Para OpenClaw:

git clone https://github.com/leilei926524-tech/anti-distill.git ~/.openclaw/workspace/skills/anti-distill

Depois, invoque com /anti-distill. Não há dependências extras de Python.

Que tipo de entrada a anti-distill precisa

A skill anti-distill aceita:

• um caminho de arquivo direto
• uma pasta de colleague-skill como colleagues/{slug}/
• conteúdo de documento colado na conversa
• busca de arquivos locais quando você pedir para ela encontrar arquivos de skill

Ela foi pensada para detectar tanto padrões de colleague-skill como work.md + persona.md ou ## Layer 0, quanto documentos genéricos como Markdown, TXT ou PDF. As melhores entradas são documentos com regras concretas, limites, exemplos, ramificações de decisão, pessoas nomeadas, memória de incidentes ou conteúdo do tipo “como realmente fazemos”, porque é aí que a anti-distill agrega mais valor.

Como escrever bons prompts para a anti-distill

Um pedido fraco seria: “limpe esta skill”.

Um prompt de uso da anti-distill mais forte inclui:

• qual arquivo ela deve ler
• de que tipo de documento se trata
• quão agressiva deve ser a limpeza
• quais arquivos de saída você quer

Exemplo:
/anti-distill Read colleagues/zhangsan/. This is a colleague-skill with work and persona content. Use medium cleaning. Keep structure and formatting, but remove concrete thresholds, troubleshooting memory, escalation shortcuts, and highly distinctive behavior cues. Generate a cleaned version plus a private backup of removed knowledge.

Isso funciona melhor porque a lógica do repositório gira em torno da intensidade da limpeza e da identificação de classes de conhecimento de alto valor, como armadilhas, heurísticas de julgamento, conhecimento de rede humana e fluxos de trabalho ocultos.

Melhor fluxo de trabalho e arquivos para ler primeiro

Se você quiser entender a anti-distill antes de confiar nela, leia nesta ordem:

1. README.md para entender a proposta do produto e o modelo de saída
2. INSTALL.md para os caminhos de instalação
3. SKILL.md para gatilhos, regras de ferramentas e fluxo principal
4. prompts/classifier.md para o sistema de rótulos: [SAFE], [DILUTE], [REMOVE], [MASK]
5. o prompt de diluição relevante para o tipo de documento
6. examples/zhangsan_before_after.md para calibrar a qualidade da saída

Na prática, comece com intensidade média, revise o que sobreviveu e depois execute de novo apenas nas partes fracas. Limpeza pesada é mais rápida, mas tem mais chance de produzir aquele texto corporativo genérico e claramente artificial.

FAQ da skill anti-distill

A anti-distill é melhor do que um prompt comum de reescrita?

Na maioria dos casos, sim, se o seu objetivo for degradação controlada em vez de simples paráfrase. Um prompt genérico costuma manter especificidades demais ou apagar estrutura demais. A anti-distill é mais confiável porque separa a classificação da reescrita e tem regras de reescrita específicas por tipo de documento.

A anti-distill serve para iniciantes?

Sim, desde que você se sinta confortável em revisar documentos reescritos. O guia da anti-distill é direto: instalar, invocar, escolher a intensidade e revisar as saídas. A parte mais difícil é o julgamento — saber quais trechos que sobreviveram ainda revelam informação demais. Iniciantes devem comparar a saída com o exemplo de antes/depois incluído antes de usar a skill em arquivos importantes.

Quando você não deve usar a anti-distill?

Não use a anti-distill para documentação pública, onboarding ou qualquer base de conhecimento em que a utilidade operacional importe. Ela também não é uma boa escolha para documentos muito curtos e sem detalhes reais; se a origem já é genérica, a anti-distill tem pouco a melhorar e pode apenas enfraquecer ainda mais o conteúdo.

A anti-distill funciona em repositórios multilíngues e mistos?

Sim. A skill oferece suporte explícito a inglês e chinês e responde no idioma do usuário. Ela também funciona com formatos de arquivo mistos e pode ler imagens ou PDFs por meio do suporte nativo de leitura da ferramenta hospedeira, mas a qualidade ainda depende de quão claramente o documento original expõe know-how concreto.

Como melhorar a skill anti-distill

Dê à anti-distill um material de origem melhor

A anti-distill funciona melhor com texto-fonte rico e específico. Se sua entrada inclui limites exatos, aprendizados de incidentes, critérios reais de decisão, diálogos de exemplo ou caminhos de coordenação com nomes, a skill consegue tomar decisões mais precisas sobre o que manter, diluir ou remover. Se a origem já for vaga, a saída não vai melhorar muito, porque há pouco sinal realmente útil para transformar.

Fique de olho nos principais modos de falha

Os maiores modos de falha da anti-distill são:

• preservar detalhes acionáveis por acidente
• substituir conteúdo demais por obviedades sem sentido
• achatar tanto a voz do texto que o documento passa a soar suspeito
• deixar escapar conhecimento oculto embutido em exemplos ou diálogos

Preste atenção extra a números, ramificações do tipo “se X, então Y”, responsáveis nomeados e explicações em estilo postmortem. Muitas vezes, esses elementos carregam mais valor do que os títulos de seção sugerem.

Melhore os prompts com restrições explícitas de reescrita

Para usar melhor a anti-distill, diga claramente o que deve ser preservado e o que deve ser alvo da limpeza. Boas restrições incluem:

• preservar títulos, listas e a ordem das seções
• manter a terminologia tecnicamente correta
• remover limites concretos, nomes internos e memória de causa raiz
• generalizar exemplos sem mudar a cobertura dos tópicos
• manter a saída com tamanho semelhante

Essas restrições se alinham aos próprios critérios de qualidade do repositório, como retenção de estrutura e comprimento aproximadamente semelhante.

Itere depois da primeira passada

Não trate a primeira execução da anti-distill como versão final. Revise a versão limpa e marque linhas que ainda ensinam julgamento real. Depois, rode novamente apenas nas seções-alvo, por exemplo: “Re-clean only CR 重点 and 经验知识库; these still reveal specific execution standards.” Essa iteração por seção normalmente produz resultados melhores do que mudar o documento inteiro de limpeza média para limpeza pesada de uma vez só.