Ditto

Visão Geral

Ditto extrai apenas as palavras do usuário de logs de sessões de agentes de codificação locais reais e transforma padrões repetidos e suportados em perfis privados de trabalho, design e escrita. Ele mantém recibos de sessão datados, rejeita regras e memória autoradas como evidência de origem e requer aprovação antes que a extração baseada em modelo comece.

Esta habilidade independente roteia um runtime Ditto compatível e já instalado. O roteamento nativo com namespace está disponível através do plugin Ditto upstream.

Quando Usar Esta Habilidade

• Use quando o usuário explicitamente pedir para configurar, executar, atualizar, re-extrair ou aprofundar o Ditto.
• Use quando o usuário quiser um perfil de agente derivado do histórico real de sessões de codificação, em vez de um questionário ou arquivo de regras.
• Use quando o ditto:mine nativo não estiver disponível e o usuário já tiver um runtime Ditto compatível instalado.

Não acione esta habilidade meramente porque a personalização pode ser útil. A extração requer uma solicitação explícita do usuário.

Como Funciona

1. Resolver um runtime instalado

Peça ao usuário o caminho para um runtime Ditto existente e confiável, ou use o plugin upstream nativo quando ele já estiver instalado. Mantenha o caminho exato do executável Python 3 como PYTHON3, o caminho do runtime como DITTO_PY e seu caminho correspondente de MINING_PROMPT.md. Confirme a versão e a origem instaladas antes de usar.

Não baixe ou instale código executável como parte desta habilidade. Se o Ditto não estiver instalado, pare e direcione o usuário para as orientações de instalação upstream; a instalação é uma decisão separada e explícita.

2. Mostrar o plano de extração somente leitura

Extraia apenas sessões reais criadas pelo usuário. Nunca sintetize um perfil a partir de AGENTS.md, CLAUDE.md, arquivos de memória, arquivos de regras ou uma autodescrição digitada.

Execute o pré-voo de qualidade-padrão de histórico completo:

"$PYTHON3" "$DITTO_PY" plugin preflight

Mostre ao usuário a contagem de sessões válidas, tokens de origem pós-deduplicação, tokens de origem selecionados, acertos de cache, chamadas de worker planejadas e chamadas de reducer planejadas. Aguarde a aprovação explícita deste plano exibido antes de qualquer trabalho baseado em modelo.

Se o usuário explicitamente pedir uma prévia rápida, adicione --preview e diga exatamente:

A prévia rápida cria um perfil inicial a partir do histórico selecionado, não o perfil completo.

Nunca apresente a prévia como padrão ou como equivalente ao resultado de histórico completo.

3. Preparar a execução aprovada

Mantenha o approval_hash exibido, então prepare com o modo aprovado exato. Para o plano de histórico completo, execute:

"$PYTHON3" "$DITTO_PY" plugin prepare --approved-plan-hash HASH

Para um plano de prévia rápida aprovado, preserve o modo de prévia explicitamente:

"$PYTHON3" "$DITTO_PY" plugin prepare --preview --approved-plan-hash HASH

Se o hash mudar, mostre o novo plano e obtenha aprovação novamente. Mantenha o run_id retornado, os caminhos de segmento e relatório atribuídos, e pack_path.

4. Extrair e validar evidências

Para cada segmento selecionado não cacheado, execute um worker apenas sobre esse segmento e o contrato por segmento no MINING_PROMPT.md resolvido. Cache cada relatório JSON com plugin cache-report e pare em caso de rejeição.

Execute o reducer mais forte disponível sobre apenas os relatórios validados e o contrato do reducer. Escreva o pacote completo em pack_path, valide-o e ative apenas o pacote validado com plugin activate.

5. Verificar e relatar

Execute plugin status, renderize o cartão do perfil e relate:

• versão ativa e caminho do perfil principal
• domínios ativos e inativos
• tokens de origem selecionados e passes reais de worker/reducer
• reutilização de cache
• caminho do cartão
• qualquer instrução exata de aprofundamento direcionada

Se o host atual já tiver o plugin Ditto nativo, não crie uma instalação de perfil direto concorrente.

Exemplos

Configuração de histórico completo

User: run ditto on my coding history
Agent: resolves the pinned runtime, shows the read-only full-history plan, and
waits for explicit cost approval before starting any mining workers.

Prévia rápida explícita

User: give me a cheap ditto preview first
Agent: runs preflight with --preview, labels it as a starter profile, and waits
for approval of the displayed preview plan.

Melhores Práticas

• Mantenha sessões brutas, caches, recibos e perfis gerados privados por padrão.
• Relate contagens e caminhos exatos observados; nunca estime o faturamento ou a cobertura do provedor.
• Preserve o hash e o modo de aprovação durante toda a execução.
• Pare em caso de falha de validação em vez de ativar um perfil parcial.

…