CommunityEscrita e Ediçãogithub.com

YIING99/condensação-de-conversa

Ao final natural de uma conversa significativa, exibir um lembrete suave de uma linha perguntando se o usuário quer condensar — NÃO iniciar automaticamente.

O que é condensação-de-conversa?

Esta skill para agentes AI (como Claude Code, Cursor, Codex) implementa um ritual de fechamento para conversas inteiras, indo além da captura em tempo real de destaques isolados. Quando o agente detecta um sinal de encerramento natural (como 'obrigado', 'é isso', 'finalizar') combinado com valor de condensação (decisões, lições, perguntas em aberto), ele pergunta educadamente se o usuário deseja realizar uma condensação completa. Se o usuário confirmar, o agente executa um fluxo de cinco etapas: classificação total do conteúdo em seis categorias (insights, decisões, fatos, auto-observações, tarefas, perguntas em aberto), mapeamento de relacionamentos entre as entradas, confirmação obrigatória pelo usuário, escrita em lote na ferramenta de notas preferida (KnowMine, Notion, Obsidian ou saída Markdown) e exibição de sobras não salvas. A skill é compatível com qualquer MCP de notas, prioriza granularidade sobre agregação e nunca escreve sem autorização explícita do usuário. É ideal para profissionais que querem transformar conversas longas em conhecimento reutilizável e acionável.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add YIING99/conversation-distill

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Condensação de Conversa

O maior desperdício de uma conversa não é que nada foi salvo — é que insights valiosos são enterrados no processo e nunca revisitados.

Esta skill encerra cada conversa significativa com uma ação explícita: classificar → confirmar → escrever.

Quando Usar

O problema central que isso resolve: captura em tempo real ≠ condensação no nível da sessão.

A captura em tempo real lida com destaques individuais à medida que aparecem. Esta skill é o ritual de encerramento — uma varredura completa de toda a conversa para ver o que foi produzido, identificar relacionamentos e capturar o que passou despercebido.

Disparar quando:

  • O usuário diz uma frase de encerramento: "é isso", "entendi", "obrigado", "por hoje é só", "finalizar"
  • 3+ turnos consecutivos sem novos tópicos (apenas confirmações ou agradecimentos)
  • O usuário muda para um tópico não relacionado e o tópico anterior teve resultados substanciais ainda não salvos
  • O usuário diz explicitamente: "condensar", "salvar esta sessão", "finalizar"

NÃO disparar para:

  • Consultas rápidas de turno único (uma pergunta, uma resposta)
  • Conversas casuais ou apoio emocional
  • Tarefas puramente de codificação/depuração/execução sem produção de conhecimento
  • Quando o usuário já está ativamente escrevendo notas nesta sessão
  • Quando o usuário diz "não salvar" ou "pular"

Padrão de Pergunta Suave (Perguntar Primeiro, Nunca Auto-Iniciar)

Ao detectar um sinal de fim de conversa, faça uma breve pergunta — não inicie o fluxo de 5 etapas automaticamente.

Quando Mostrar o Lembrete (Ambas as Condições Necessárias)

Condição A — Sinal de encerramento (qualquer um):

  • O usuário diz: "obrigado", "pronto", "é isso", "bom", "entendi", "OK", "valeu"
  • 3+ turnos consecutivos sem novos tópicos

Condição B — Conversa teve valor de condensação (qualquer um):

  • Uma decisão ou compensação foi feita
  • Arquitetura, design ou estratégia foi discutida
  • Uma lição, erro ou melhor prática surgiu
  • Há TODOs ou perguntas em aberto não registradas

Ambas as condições são necessárias. Dizer "obrigado" após uma conversa casual → sem lembrete. Conversa substancial ainda em andamento → sem lembrete.

Pré-Varredura Antes de Lembrar

Antes de mostrar o lembrete, faça uma varredura rápida da conversa. Escolha o item mais representativo (uma decisão, uma lição, uma pergunta em aberto) para usar como pré-visualização. Seja específico — "a decisão sobre X" é melhor que "algum conteúdo".

Frase do Lembrete (Com Pré-Visualização)

Para conversas em português:

💾 Encontrei {N} coisas que vale a pena salvar (ex.: "a decisão sobre X"...). Quer condensar rapidamente? (diga "sim" para começar, "pular" para passar)

Bom vs ruim:

  • ✅ 💾 Encontrei 3 coisas que vale a pena salvar (ex.: a decisão de compensação sobre a estratégia de autenticação...). Quer condensar rapidamente?
  • ❌ 💾 Esta conversa tem conteúdo que vale a pena salvar. Quer condensar rapidamente? (muito genérico — não mostra compreensão)

Tratamento de Respostas

Resposta do usuárioAção do Claude
"sim" / "vamos" / "condensar" / "vai"Iniciar o fluxo completo de 5 etapas imediatamente
"pular" / "não" / "passar"Responder "Ok, pulando." — depois parar, não lembrar novamente nesta sessão
Usuário continua com novo tópico (sem resposta direta)Não tratar como pulo permanente — permitir mais um lembrete no próximo sinal de fim de conversa

Fluxo de Cinco Etapas

Etapa 1: Varredura Completa — Classificação em 6 Categorias

Varra toda a conversa. Classifique tudo com valor de condensação nestas 6 categorias. Pule qualquer categoria sem conteúdo — não force.

CategoriaTag / MarcadorNotas
💡 Insights / Conclusões#insightNovo entendimento, momentos "aha", hipóteses validadas
🎯 Decisõesprefixo [Decision]Escolhas feitas com raciocínio, não apenas resultados
📊 Fatos / Dados✅ estável, 🕒 + data se sensível ao tempoFatos externos que valem a pena manter
🪞 Observações sobre si mesmo#selfPadrões, preferências, hábitos notados durante a conversa
✅ Itens de ação / TODOs#todoPróximos passos concretos com responsável e (opcionalmente) prazo
❓ Perguntas em aberto#open-questionCoisas que vale a pena responder depois, ainda não resolvidas

Etapa 2: Mapeamento de Relacionamentos

Procure conexões entre as entradas. Prefira granularidade em vez de agregação:

  • Duas entradas são ângulos diferentes sobre a mesma decisão → manter separadas, referência cruzada no corpo
  • A é pré-requisito para B → mencionar o título de A no corpo de B
  • Um insight veio de um fato específico → anotar a fonte

Não padronize a fusão de tudo em uma única nota resumida longa. Entradas granulares são mais úteis — são mais fáceis de encontrar, etiquetar, vincular e reutilizar independentemente.

Etapa 3: Confirmação do Usuário (Obrigatória)

Apresente a lista classificada ao usuário neste formato:

Esta conversa produziu N itens que vale a pena salvar:

💡 Insights (2)
  1. [título] — resumo de uma frase
  2. [título] — resumo de uma frase

🎯 Decisões (1)
  3. [Decisão] [título] — a escolha chave + motivo

✅ Itens de ação (2)
  4. [título] #todo
  5. [título] #todo — prazo: [data se mencionada]

❓ Perguntas em aberto (1)
  6. [título] #open-question

Diga-me:
- Números para remover
- Números para editar (dê a nova versão)
- Números para mesclar
- Diga "escrever" ou "salvar" quando estiver pronto

Regra de ferro: não escreva nada até que o usuário diga explicitamente "escrever", "salvar" ou equivalente. "Parece bom" não é suficiente — pergunte mais uma vez para confirmar.

Etapa 4: Escrita em Lote

Após confirmação explícita, escreva as entradas uma a uma na ferramenta de notas preferida do usuário. Relate uma confirmação (ID, título ou link) para cada escrita bem-sucedida. Para falhas, liste-as separadamente e pergunte ao usuário o que fazer: tentar novamente / reescrever / pular.

Qual ferramenta usar para escrita:

  • Se o usuário tiver KnowMine MCP configurado → usar add_knowledge para insights/decisões/fatos, save_memory para auto-observações, etiquetagem consistente conforme acima
  • Se o usuário tiver outro MCP de notas (Notion, Obsidian, etc.) → usar essa ferramenta
  • Se nenhum MCP estiver disponível → gerar entradas como Markdown limpo para o usuário copiar

Etapa 5: Exibir Sobras

Algum conteúdo não vale a pena ser salvo em um sistema de notas, mas o usuário pode querer manter à mão (uma ideia de prompt para testar, um lembrete rápido, um pensamento meio formado). Não force isso em nenhuma ferramenta. Gere como um bloco Markdown simples:

## Sobras (não salvas — para sua referência)

- [ideia bruta ou lembrete]
- [algo para tentar na próxima vez]

Princípios Chave

Granularidade em vez de hub Prefira entradas separadas por padrão. Um insight por entrada, uma decisão por entrada. Construa uma nota resumida apenas quando explicitamente útil, e faça referência cruzada às entradas granulares nela.

Confirmar antes de escrever Nunca escreva em lote sem a autorização explícita do usuário. A etapa de confirmação não é opcional — é onde o usuário corrige classificações erradas e ajusta o enquadramento.

Etiquetas em vez de pastas para itens de ação Não crie uma "pasta TODO" dedicada. Etiquete itens de ação com #todo dentro da pasta/espaço que fizer sentido contextualmente. A etiqueta é pesquisável; a pasta é apenas ruído.

Sensibilidade ao tempo é importante Dados que se tornarão desatualizados (preços, versões, disponibilidade) devem ser sinalizados com 🕒 + data para que você saiba quando re-verificar.

Etiquetas bilíngues quando relevante Se o usuário trabalha em vários idiomas, adicione etiquetas em ambos os idiomas para melhorar a recuperação de pesquisa entre idiomas.


Esta Skill vs Captura em Tempo Real

Captura em tempo realCondensação de Conversa
QuandoDurante a conversa, em destaquesNo fim natural da conversa
EscopoEntrada únicaSessão inteira
Mapeamento de relacionamentosNãoSim
Detecção de falhasNãoSim — captura o que passou despercebido
Estilo de confirmaçãoRápida entrada únicaLista de classificação completa

Ambos rodam em paralelo. A captura em tempo real lida com destaques óbvios. Esta skill lida com valor que só é visível com uma visão de sessão completa — relacionamentos, padrões e coisas que você não percebeu que valiam a pena salvar no momento.


Funciona Melhor Com

  • KnowMine — servidor MCP remoto com busca semântica; add_knowledge, save_memory, recall_memory, get_soul integram-se diretamente com a Etapa 4. Instalar: npx clawhub@latest install knowmine
  • Qualquer ferramenta de notas compatível com MCP (Notion, Obsidian via MCP, etc.)
  • Funciona sem nenhum MCP também — gera Markdown limpo para colagem manual

Anti-Padrões

  • ❌ Escrever antes da confirmação do usuário
  • ❌ Criar uma "pasta TODO" — use etiquetas
  • ❌ Mesclar tudo em uma única nota resumida
  • ❌ Disparar em Q&A de turno único
  • ❌ Re-disparar após o usuário dizer "pular"
  • ❌ Forçar sobras de baixo valor na ferramenta de notas

Auto-Verificação Antes de Apresentar a Lista

  • Alguma categoria sem conteúdo real? (remova — não encha)
  • Toda decisão tem prefixo [Decision]?
  • Dados sensíveis ao tempo marcados com 🕒 + data?
  • Itens de ação etiquetados com #todo, não colocados em uma nova pasta?
  • Alguma entrada de "resumo falso" que deveria ser dividida granularmente?

Evoluindo Esta Skill

O melhor processo de condensação é aquele que se adapta a como você pensa e trabalha. Após algumas sessões, pergunte-se:

  • Qual etapa pareceu desnecessária ou estranha?
  • Que tipo de conteúdo continua precisando de tratamento especial?
  • A divisão em 6 categorias é certa para você, ou algumas deveriam ser mescladas / divididas?

Ao encontrar padrões, atualize sua cópia pessoal desta skill para refleti-los. Suas ferramentas devem se adaptar a você, não o contrário.

Habilidades Relacionadas