Communitygithub.com

richardbowman/agent-skills

Habilidade de assistente pessoal para triagem de Gmail, rascunho de respostas, varredura de newsletters por interesses e preparação de relatórios de viagem. Possui o procedimento completo de triagem agendada da caixa de entrada do Gmail (incluindo a Base 'Email Action Items' do Obsidian). Use ao gerenciar e-mails ou automatizar fluxos de trabalho de viagem/desenvolvimento.

O que é agent-skills?

Esta habilidade permite que um assistente de IA (Claude ou Gemini) atue como um assistente proativo para a caixa de entrada de Gmail e fluxos de trabalho profissionais de Rick. Ela define o procedimento completo de triagem de e-mail, incluindo varredura de mensagens não lidas, arquivamento de ruídos de rotina, processamento de notícias de condomínio, extração de destaques de newsletters com base em interesses específicos (carnes defumadas, pão, ciclismo, automação residencial, Linux, sudoeste de Michigan, viagens para Costa Rica/Portugal) e sinalização de itens que exigem ação, como faturas, alertas de segurança e oportunidades pagas. A habilidade também gerencia uma Base de Itens de Ação no Obsidian para rastreamento, com recursos de desduplicação e eliminação automática de notas desatualizadas com base na presença na caixa de entrada e na idade. Além disso, oferece suporte a relatórios de viagem e criação de rascunhos de e-mail via API Gmail. É compatível com ambientes de linha de comando com `gws` CLI e usa um harness ativo para conectores de Gmail e ferramentas de arquivo/agendador.

Funciona com✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/richardbowman/agent-skills/tree/HEAD/rb-personal-assistant

Perguntar na sua IA favorita

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

Documentação

RB Personal Assistant

Portabilidade do Harness

Use o conector Gmail do harness ativo, solicitação de segredo seguro, ferramentas de arquivo/cofre e equivalentes de agendador. Se um conector necessário não estiver disponível, prepare um rascunho/relatório e identifique a capacidade ausente; nunca ignore as regras de confirmação para enviar e-mail ou alterar o estado externo. Os cabeçalhos existentes de Claude Sessions no cofre são retidos como esquema de armazenamento, não como um requisito de harness.

Esta habilidade permite que um assistente de IA (Claude ou Gemini) atue como um assistente proativo para a caixa de entrada de Gmail e fluxos de trabalho profissionais de Rick. É a única fonte da verdade para o procedimento de triagem da caixa de entrada — o cron job agendado simplesmente invoca esta habilidade, portanto, mantenha a lógica completa aqui, em vez de duplicá-la no prompt do cron.


Triagem da Caixa de Entrada do Gmail — Procedimento Completo

Execute isso sempre que solicitado a fazer a triagem da caixa de entrada, incluindo execuções agendadas/não supervisionadas. Use a CLI gws (já no PATH). Execute as etapas em ordem.

Constantes principais

  • Caminhos do cofre: todo caminho de cofre abaixo é relativo ao cofre; o tempo de execução fornece a raiz do cofre. Nunca codifique um.
  • Rótulo de arquivamento Jarvis: Label_9220311120338883160 — para arquivar, adicione este rótulo E remova INBOX na mesma chamada modify.
  • Consulta de varredura da caixa de entrada: gws gmail +triage --query 'is:unread label:INBOX' --max 60
  • Notas de contexto: Jarvis Summaries/triage-context.md
  • Pasta de Itens de Ação: Jarvis Summaries/Action Items/
  • Base de Itens de Ação (já existe — nunca recrie): Jarvis Summaries/Email Action Items.base
  • Pasta de Resumos: Jarvis Summaries/
  • Notas diárias: Daily/<YYYY-MM-DD>.md
  • Ressalva do gws: parâmetros de rótulo devem ser strings simples, não arrays — por exemplo, addLabelIds: "Label_9220311120338883160", removeLabelIds: "INBOX".
  • Ressalva do zsh: o shell deste ambiente é zsh, não bash. for x in $VAR; do NÃO faz divisão de palavras em variáveis não citadas no zsh (ao contrário do bash) — um loop multi-ID construído dessa forma é executado silenciosamente uma vez com a string inteira como $x. Use um array zsh: IDS=(id1 id2 id3); for id in "${IDS[@]}"; do .... Além disso, status é uma variável interna somente leitura do zsh — nunca nomeie uma variável de shell como status (use st ou similar) ou a atribuição falhará.

PASSO 0 — Leia as notas de contexto

Leia o arquivo de notas de contexto. Estas são notas de Rick sobre coisas que ele já cuidou ou que deseja que sejam tratadas de forma diferente nesta execução — leve-as em consideração em todas as decisões abaixo. Após a execução, remova todas as notas em que você agiu (edite a seção de Notas Pendentes). Se uma nota deve se tornar uma regra permanente, adicione-a a references/preferences.md em vez de deixá-la no arquivo de contexto.

PASSO 0b — Desduplicar em relação a execuções anteriores E à Base de Itens de Ação

  1. ls "Jarvis Summaries/Triage-$(date +%Y-%m-%d)"*.md 2>/dev/null (relativo à raiz do cofre) — se algum existir, leia-os e extraia todo assunto/remetente já listado em Ação Necessária e toda newsletter já listada em Destaques da Newsletter.
  2. ls "Jarvis Summaries/Action Items/" e, para qualquer e-mail que você esteja prestes a sinalizar, verifique se há uma nota de rastreamento existente pelo id do Gmail: grep -rl "gmail_id: <ID>" "Jarvis Summaries/Action Items/".

Se algo já foi relatado hoje, ou já tem uma nota de item de ação aberta, não o repita no resumo e não crie uma nota duplicada — apenas atualize a nota existente (PASSO 5b), a menos que haja informações genuinamente novas (uma resposta, uma atualização, um e-mail diferente sobre o mesmo tópico).

PASSO 0c — Processar ações pendentes da Base

A Base de Itens de Ação tem uma coluna de caixa de seleção archive (Rick a marca no Obsidian). Antes de escanear a caixa de entrada, procure por ações pendentes:

  1. grep -l "^archive: true" "Jarvis Summaries/Action Items/"*.md (também corresponda a archive: true sem o acento circunflexo em caso de diferenças de indentação).
  2. Para cada correspondência, leia o frontmatter da nota. Pule se status já for Done ou Dismissed (já processado em uma execução anterior — nada a fazer).
  3. Caso contrário, arquive o e-mail subjacente: gws gmail users messages modify --params '{"userId": "me", "id": "<gmail_id>", "addLabelIds": "Label_9220311120338883160", "removeLabelIds": "INBOX"}'.
  4. Em caso de sucesso, atualize o frontmatter da nota: defina status: Dismissed e last_run para agora. Deixe archive: true no lugar como o registro da ação — não o desmarque.
  5. Em caso de falha (por exemplo, mensagem já excluída), deixe status como está, não tente novamente infinitamente e anote a falha sob uma linha Erros neste resumo de triagem (PASSO 7) para que Rick veja.

Esta etapa é a única coisa que fecha o ciclo da caixa de seleção — marcá-la no Obsidian não faz nada na mensagem real do Gmail até que a próxima execução de triagem agendada a pegue (a cada 6h, 07:00-22:00).

PASSO 0d — Eliminar itens rastreados obsoletos

A Base de Itens de Ação só cresce a menos que alguém feche ativamente uma nota — o PASSO 0c exige que Rick perceba e marque uma caixa, o que não escala (em 2026-09-18, havia atingido 274 notas, 253 ainda Open, algumas de seis semanas atrás). Esta etapa é executada em cada triagem e fecha notas automaticamente sempre que for seguro inferir que o item não está mais ativo, para que a Base permaneça uma lista confiável de coisas que realmente ainda precisam da atenção de Rick.

  1. Liste cada gmail_id de nota Open em Jarvis Summaries/Action Items/.
  2. Obtenha o conjunto atual de ids completos da caixa de entrada (não apenas não lidos): gws gmail users messages list --params '{"userId": "me", "q": "in:inbox", "maxResults": 500}'. Se a resposta incluir nextPageToken, repita com pageToken definido até parar, para que toda a caixa de entrada seja coberta (ela rotineiramente excede 500).
  3. Feche qualquer nota Open cujo gmail_id não esteja mais nesse conjunto. Se o e-mail subjacente não estiver mais na caixa de entrada, Rick (ou outra coisa) já lidou com ele fora deste fluxo — a nota é órfã. Defina status: Dismissed, deixe archive: false (nada a arquivar) e anexe uma linha ao corpo da nota: **Auto-fechado em <data de hoje>:** e-mail subjacente não está mais na caixa de entrada — resolvido fora do fluxo de triagem. Não toque em notas cujo e-mail ainda esteja na caixa de entrada; essas ainda precisam de uma olhada humana.
  4. Elimine ruídos específicos de categoria para notas ainda na caixa de entrada:
    • CI/CD: se first_seen for há mais de 5 dias e a nota nunca foi atualizada para In Progress/Done por Rick, trate-a como obsoleta (falhas de CI são sempre substituídas pela próxima execução ou por uma olhada direta no repositório — uma nota de rastreamento de uma semana não tem valor informativo). Arquive o e-mail (rótulo Jarvis) e defina status: Dismissed, anotando **Auto-fechado em <data>:** notificação de CI/CD não resolvida após 5+ dias, tratada como obsoleta — verifique o repositório diretamente se ainda for relevante.
    • Appointment: se due_date (ou email_date quando não houver due_date) estiver no passado, o compromisso já aconteceu ou passou — arquive o e-mail e dispense com **Auto-fechado em <data>:** data do compromisso já passou.
    • Avisos de envio/entrega arquivados sob Other (assunto corresponde a "package"/"delivery"/"shipped"/"on the way"): se tiver mais de 10 dias, arquive e dispense com **Auto-fechado em <data>:** janela de envio expirou. (Melhor: no PASSO 5b, arquive estes como já fechados no momento da criação, para que esta etapa nunca precise pegá-los — veja a nota lá.)
    • Deixe Billing, Security, Compliance, Invoice, Benefits, Opportunity, Solar, SEO e Account em paz aqui — essas categorias podem envolver dinheiro real, prazos ou julgamentos, portanto, apenas a verificação de presença na caixa de entrada do passo 3 se aplica a elas; nunca as elimine por tempo.
  5. Relate contagens, não uma lista por item, no resumo de triagem (PASSO 7) — por exemplo, Limpeza: fechadas 14 notas obsoletas (9 não estão mais na caixa de entrada, 4 CI/CD desatualizadas, 1 compromisso vencido). Uma lista detalhada completa não é um sinal útil; a contagem confirma que a varredura foi executada.

PASSO 1 — Escanear mensagens não lidas

Execute a consulta de varredura da caixa de entrada acima. (Nota: gws gmail +triage simples sem consulta padrão para is:unread em toda a caixa de correio, limitado a 20 — ele perde o backlog real da caixa de entrada porque e-mails já arquivados, mas ainda não lidos, suplantam os itens reais da caixa de entrada. Sempre passe a consulta explícita label:INBOX para que isso escaneie a caixa de entrada real.)

PASSO 2 — Arquivar ruídos de rotina

Arquive (rótulo jarvis + remover INBOX): sucessos do TestFlight / GitHub / Vercel, promoções da Experian, TaxSlayer, Alertas de Segurança do Google para contas conhecidas. Também arquive newsletters após resumir seus destaques (PASSO 4) — não as deixe na caixa de entrada.

PASSO 3 — Avisos de construção/condomínio

Mova e-mails da Associação de Condomínio / prédio para o rótulo Home.

PASSO 4 — Newsletters

Escaneie newsletters (WBEZ, Block Club, City Cast, etc.) em busca de trechos que correspondam aos interesses de Rick: carnes defumadas, pão, ciclismo, automação residencial, Linux, sudoeste de Michigan local, viagens para Costa Rica / Portugal (mapa de interesses completo em references/preferences.md). Resuma qualquer correspondência e, em seguida, arquive a newsletter (rótulo jarvis). PULE qualquer newsletter já resumida hoje (PASSO 0b) — apenas arquive-a silenciosamente.

PASSO 5 — Sinalizar Ação Necessária

Sinalize: faturas de contatos prioritários, alertas de produção / cobrança / segurança, prazos de conformidade / atestação, preparação de compromissos e oportunidades pagas. Pule qualquer coisa que as notas de contexto digam que Rick já cuidou. PULE qualquer coisa já relatada hoje ou já rastreada por uma nota de item de ação aberta (PASSO 0b), a menos que haja informações genuinamente novas. Notificações puras de envio/rastreamento ("seu pedido foi enviado") são relatadas uma vez e depois arquivadas — arquive sua nota de rastreamento como já fechada (status: Dismissed, archive: true) no momento da criação no PASSO 5b, em vez de Open, já que não há ação de acompanhamento para uma notificação de envio esperar. Deixar estas como Open é exatamente o tipo de nota que o PASSO 0d tem que limpar depois, sem motivo.

PASSO 5b — Manter a Base de Itens de Ação

Para cada item sinalizado no PASSO 5, garanta que ele seja rastreado como uma nota na pasta Action Items para que apareça na Base Email Action Items. O arquivo Base já existe — NÃO o recrie.

  • Desduplique por gmail_id (PASSO 0b). Se uma nota com esse id existir: apenas atualize last_run (e last_seen) para a execução atual — NÃO sobrescreva status (Rick o gerencia manualmente) e NÃO duplique. Se o status da nota existente for Done ou Dismissed, deixe-a fechada; não a reabra ou re-sinalize.
  • Se nenhuma nota existir, crie uma. Nome do arquivo: <Remetente> - <assunto curto>.md (remova caracteres inválidos para nomes de arquivo: / \ : etc.). Esquema do frontmatter:
---
type: email-action
status: Open            # Open | In Progress | Done | Dismissed  (Rick edita isso no Obsidian)
archive: false          # Rick marca esta caixa na Base para arquivar o e-mail + fechar o item (PASSO 0c)
priority: High          # High | Medium | Low
priority_rank: 1        # 1=High, 2=Medium, 3=Low  (direciona a ordem de classificação)
category: Billing       # Billing | Invoice | Security | Compliance | CI/CD | Account | Benefits | Appointment | Opportunity | Solar | SEO | Other
sender: "Vercel"
subject: "..."
email_date: YYYY-MM-DD  # data em que o e-mail foi recebido
due_date:               # opcional; apenas se o e-mail declarar uma data de vencimento
gmail_id: <id hexadecimal do gws>
gmail_link: https://mail.google.com/mail/u/0/#all/<id hexadecimal>
first_seen: YYYY-MM-DD  # hoje
last_run: YYYY-MM-DD-HH-MM
---

Corpo: um H1 # <Remetente> — <assunto>, uma descrição de 1–2 frases da ação necessária e uma linha **[Abrir no Gmail](<gmail_link>)**. O id hexadecimal do gmail_link é o mesmo id de mensagem/thread hexadecimal que gws retorna — é o link permanente da web do Gmail.

  • Atribua prioridade de forma sensata: High = dinheiro em risco / produção parada / prazo rígido (falhas de cobrança, pagamentos vencidos, violações de segurança, atestações de conformidade); Medium = precisa de uma decisão ou resposta em breve (faturas, falhas de CI, configuração de conta, compromissos, oportunidades pagas); Low = informativo, mas acionável (extratos, auditorias de SEO, lembretes de marketing).

PASSO 6 — Retenção de viagem

NÃO arquive e-mails de viagem (Marriott, AC Hotels, UPS, companhias aéreas) até que a viagem seja confirmada como encerrada. Veja Relatórios de Viagem e Viagem abaixo.

PASSO 7 — Escrever o resumo de triagem

Escreva em Jarvis Summaries/Triage-<YYYY-MM-DD-HH-MM>.md com as seções: Ação Necessária, Destaques da Newsletter, Arquivados, Limpeza. Em Ação Necessária, observe que os itens também são rastreados na Base [[Jarvis Summaries/Email Action Items.base|Email Action Items]]. Se o PASSO 0c processou alguma ação de caixa de seleção, adicione uma linha Arquivados via Base listando-os e uma linha Erros para qualquer um que falhou. Em Limpeza, reporte as contagens de fechamento do PASSO 0d. Se nada de novo foi encontrado, escreva uma nota breve "Nenhum item novo desde a última execução" (a limpeza do PASSO 0d ainda é executada e relatada) e pare.

PASSO 8 — Vincular na nota diária

Adicione um wikilink para o arquivo de resumo em Daily/<YYYY-MM-DD>.md sob uma seção ## Claude Sessions (crie a seção se estiver faltando).

Execuções agendadas/não supervisionadas: complete os PASSOS 0–8 e pare — não há necessidade de postar o resumo em nenhum outro lugar.


Relatórios de Viagem e Viagem

  • Identificar: Rastreie e-mails de hotel (Marriott, AC Hotels), voo e envio (UPS).
  • Fluxo de trabalho: (Futuro) Verifique o calendário para correlacioná-los em um único "Relatório de Viagem".
  • Ação: Não arquive recibos/informações de viagem até que a viagem tenha terminado.

Protocolo de Resposta

  • Contatos Prioritários: (por exemplo, empreiteiro de HVAC) Rascunhe respostas curtas e educadas para faturas ou consultas.
  • Segurança: Nunca autorize pagamentos ou clique em links financeiros sem confirmação explícita de Rick.

Criando Rascunhos do Gmail (com ou sem anexos)

A CLI gws não pode lidar com grandes cargas úteis como argumentos de linha de comando. Use a receita Python abaixo, que descriptografa as credenciais do gws diretamente e chama a API Gmail.

Rascunho apenas de texto:

import base64, json, subprocess
from email.mime.text import MIMEText

# Obter token de acesso atualizado
from cryptography.hazmat.primitives.ciphers.aead import AESGCM
key = base64.b64decode(subprocess.run(['security', 'find-generic-password', '-s', 'gws-cli', '-w'], capture_output=True, text=True).stdout.

…

[truncado para tradução]

Habilidades Relacionadas