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 removaINBOXna mesma chamadamodify. - 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; doNÃ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 comostatus(usestou 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
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.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:
grep -l "^archive: true" "Jarvis Summaries/Action Items/"*.md(também corresponda aarchive: truesem o acento circunflexo em caso de diferenças de indentação).- Para cada correspondência, leia o frontmatter da nota. Pule se
statusjá forDoneouDismissed(já processado em uma execução anterior — nada a fazer). - Caso contrário, arquive o e-mail subjacente:
gws gmail users messages modify --params '{"userId": "me", "id": "<gmail_id>", "addLabelIds": "Label_9220311120338883160", "removeLabelIds": "INBOX"}'. - Em caso de sucesso, atualize o frontmatter da nota: defina
status: Dismissedelast_runpara agora. Deixearchive: trueno lugar como o registro da ação — não o desmarque. - Em caso de falha (por exemplo, mensagem já excluída), deixe
statuscomo 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.
- Liste cada
gmail_idde notaOpenemJarvis Summaries/Action Items/. - 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 incluirnextPageToken, repita compageTokendefinido até parar, para que toda a caixa de entrada seja coberta (ela rotineiramente excede 500). - Feche qualquer nota
Opencujogmail_idnã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ã. Definastatus: Dismissed, deixearchive: 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. - Elimine ruídos específicos de categoria para notas ainda na caixa de entrada:
CI/CD: sefirst_seenfor há mais de 5 dias e a nota nunca foi atualizada paraIn Progress/Donepor 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 definastatus: 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: sedue_date(ouemail_datequando não houverdue_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,SEOeAccountem 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.
- 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 atualizelast_run(elast_seen) para a execução atual — NÃO sobrescrevastatus(Rick o gerencia manualmente) e NÃO duplique. Se o status da nota existente forDoneouDismissed, 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]