inbox-triage

Visão geral do inbox-triage skill

O que o inbox-triage faz

inbox-triage é um inbox-triage skill de automação de fluxo de trabalho de email para conduzir uma revisão estruturada da caixa de entrada a partir de uma base de conhecimento pessoal de emails já existente. Ele pesquisa mensagens recentes, classifica emails usando a sua taxonomia, identifica novos remetentes, recomenda ações, rascunha respostas e registra aprendizados de triagem de volta em ${WORKSPACE}/Email/.

O ponto mais importante para adoção: ele funciona em conjunto com inbox-setup. O inbox-triage skill espera encontrar a base de conhecimento de 7 arquivos criada pelo setup, incluindo email-taxonomy.md, email-patterns.md, blocklist.md, tracker.md, arquivos opcionais de decisão e um diretório triage-log/.

Usuários e fluxos de trabalho ideais

Este skill é indicado para quem quer fazer triagem recorrente de emails de 1 a 3 vezes por dia, ou ter um fluxo confiável de “verificar minha caixa de entrada” sob demanda sem precisar explicar preferências de novo a cada vez. Ele é especialmente útil para founders, consultores, criadores, operadores e profissionais ocupados que recebem uma mistura de oportunidades, conversas em andamento, newsletters, prospecção fria e follow-ups.

Use inbox-triage para Workflow Automation quando o objetivo não for apenas resumir emails, mas apoiar decisões: classificar, recomendar, rascunhar, registrar e atualizar memória.

Principais diferenciais

O diferencial prático é o modelo de automação com segurança em primeiro lugar. O skill cria apenas rascunhos e, explicitamente, nunca envia emails. O repositório inclui references/drafts_only_safety.md e scripts/draft_safety_validator.py, que verifica logs de ação em busca de chamadas de ferramenta com formato de envio.

Ele também inclui auxiliares determinísticos: kb_reader.py valida a base de conhecimento obrigatória antes da triagem, e search_window_calculator.py calcula a janela de busca com base na cadência.

Quando este skill não é a escolha certa

Não instale inbox-triage como um prompt isolado se você ainda não executou inbox-setup ou não criou os arquivos esperados em ${WORKSPACE}/Email/. Ele também não é uma boa opção se você quer envio totalmente autônomo, resumos casuais e pontuais de email, ou um sistema que ignore taxonomia e estilo de resposta específicos do usuário.

Como usar o inbox-triage skill

Contexto de instalação do inbox-triage

Instale o skill a partir do repositório de skills no GitHub com:

npx skills add alirezarezvani/claude-skills --skill inbox-triage

Depois, confirme que seu agente consegue acessar o caminho do skill:

productivity/email/skills/inbox-triage

Antes da primeira execução, inspecione SKILL.md e leia references/kb_file_contract.md, references/drafts_only_safety.md e references/triage_decision_framework.md. Para entender o comportamento de validação, revise scripts/kb_reader.py, scripts/search_window_calculator.py e scripts/draft_safety_validator.py.

Entradas obrigatórias antes do uso

O skill precisa de um workspace que contenha ${WORKSPACE}/Email/. No mínimo, os arquivos obrigatórios são email-taxonomy.md, email-patterns.md, blocklist.md e tracker.md; triage-log/ deve existir como diretório. evaluation-framework.md e rate-card.md melhoram a qualidade das decisões para oportunidades, precificação, VIPs e sinais de aceitar ou recusar.

Se a KB estiver ausente ou malformada, o comportamento esperado é interromper a execução e orientar o usuário a executar /cs:inbox-setup primeiro. Esse comportamento fail-fast evita que o agente invente regras de triagem.

Prompts fortes para acionar bem o skill

Um prompt fraco seria: “Check my email.”

Um prompt mais forte para usar inbox-triage seria: “Run inbox-triage for my normal 2x-daily cadence. Use my existing ${WORKSPACE}/Email/ knowledge base, search only the current window, classify new messages, draft replies but do not send anything, update tracker.md and blocklist.md where appropriate, and give me the report in my preferred format.”

Para execuções sob demanda, inclua a substituição explícita: “Run inbox-triage for the last 24 hours because I missed the morning pass. Do not skip opportunity emails. Draft replies only.”

Fluxo prático para a primeira execução

Comece com uma execução seca e supervisionada. Peça ao agente para validar a KB, calcular a janela de busca, listar as categorias planejadas e confirmar que nenhuma ação de envio será usada. Em seguida, permita que ele processe as mensagens, crie rascunhos e produza o relatório de triagem.

Depois do relatório, revise três pontos: emails classificados incorretamente, rascunhos que não soam como você e quaisquer atualizações gravadas em tracker.md ou blocklist.md. Essas correções têm alto impacto porque as próximas execuções dependem da base de conhecimento.

FAQ do inbox-triage skill

O inbox-triage envia emails?

Não. A regra central de segurança é criar apenas rascunhos. O skill foi projetado para rascunhar respostas para revisão do usuário, não para transmiti-las. O validador incluído pode escanear um log de ações de triagem em busca de operações semelhantes a envio, como chamadas de envio do Gmail ou Outlook, e fazer a execução falhar se elas aparecerem.

Por que isso é melhor do que um prompt comum de email?

Um prompt genérico pode resumir emails, mas normalmente não tem memória estável, regras por remetente, janelas por cadência, disciplina de segurança para rascunhos e um framework repetível de recomendação. O inbox-triage skill lê um contrato definido de KB, usa uma taxonomia, aplica decisões TAKE IT / WORTH CONSIDERING / PASS / FLAG FOR REVIEW e registra os resultados.

O inbox-triage é amigável para iniciantes?

Ele é amigável para iniciantes apenas depois do setup. Se você se sente confortável em executar um instalador de skill e permitir que um agente acesse ferramentas de email e arquivos do workspace, a invocação no dia a dia é simples. O bloqueio inicial é a dependência de inbox-setup e da estrutura exata de arquivos em ${WORKSPACE}/Email/.

Quais ecossistemas de email ele pode atender?

O skill foi escrito em torno do comportamento de ferramentas de email, não de um único provedor. A referência de segurança menciona operações no estilo de rascunho para Gmail e Outlook/Microsoft Graph. O sucesso real depende de o seu ambiente de agente ter permissões para pesquisar, ler e criar rascunhos de email sem permissões de envio.

Como melhorar o inbox-triage skill

Melhore os resultados do inbox-triage com arquivos de KB melhores

A forma mais rápida de melhorar o inbox-triage é tornar email-taxonomy.md e email-patterns.md mais específicos. Adicione exemplos de newsletters a ignorar, VIPs a destacar, oportunidades a considerar e conversas que exigem resposta no mesmo dia. Inclua regras de voz, como “curto, cordial, sem pontos de exclamação” ou “incluir preço somente quando perguntarem”.

Se a triagem de oportunidades for importante, mantenha evaluation-framework.md e rate-card.md atualizados. Esses arquivos reduzem recomendações vagas do tipo “talvez” e ajudam os rascunhos a incluir próximos passos concretos, posicionamento de preço ou perguntas de esclarecimento.

Corrija modos de falha comuns

Se o skill estiver criando rascunhos demais, torne os sinais de PASS e as regras de blocklist mais rigorosos. Se ele estiver deixando passar conversas importantes, amplie os sinais de conversas ativas e as entradas de VIPs. Se os rascunhos estiverem genéricos demais, adicione exemplos reais de respostas aceitas e rejeitadas em email-patterns.md.

Se a janela de busca estiver errada, confira os valores de cadência usados por search_window_calculator.py: uma vez por dia usa uma sobreposição mais ampla, enquanto 2x e 3x ao dia usam janelas mais curtas. Para sessões incomuns de recuperação, informe uma substituição explícita em horas.

Itere depois do primeiro relatório

Depois de cada execução, marque quais recomendações estavam corretas, quais rascunhos você enviou depois de editar e quais mensagens deveriam ter sido ignoradas. Peça ao agente para converter esse feedback em atualizações da KB, em vez de tratá-lo como contexto pontual de chat.

Um bom prompt de acompanhamento: “Review the last inbox-triage report. Update my taxonomy so emails like X are classified as PASS, add sender Y to VIP, and adjust my draft style to be shorter for cold outreach. Do not change send safety rules.”

Mantenha segurança e logs aplicáveis

Para uso agendado, mantenha a regra de apenas rascunhos visível nos prompts e logs. Execute ou inspecione draft_safety_validator.py se o seu ambiente oferecer suporte a logs de ação. Mantenha triage-log/ organizado, porque ele fornece a trilha de auditoria do que foi pesquisado, rascunhado, ignorado e aprendido.