Assistant Personnel RB
Portabilité de l'outillage
Utilisez le connecteur Gmail de l'outillage actif, la requête de secret sécurisé, les outils de coffre-fort/fichiers et les équivalents du planificateur. Si un connecteur requis est indisponible, préparez un brouillon/rapport et identifiez la capacité manquante ; ne contournez jamais les règles de confirmation pour l'envoi d'e-mails ou la modification d'état externe. Les en-têtes existants Claude Sessions du coffre-fort sont conservés comme schéma de stockage, pas comme une exigence de l'outillage.
Cette compétence permet à un assistant IA (Claude ou Gemini) d'agir comme un assistant proactif pour la boîte de réception Gmail de Rick et ses flux de travail professionnels. C'est la source unique de vérité pour la procédure de tri de la boîte de réception — la tâche cron planifiée invoque simplement cette compétence, donc gardez toute la logique ici plutôt que de la dupliquer dans l'invite cron.
Tri de la boîte de réception Gmail — Procédure complète
Exécutez ceci chaque fois qu'on vous demande de trier la boîte de réception, y compris les exécutions planifiées/non supervisées. Utilisez l'outil CLI gws (déjà sur le PATH). Travaillez les étapes dans l'ordre.
Constantes clés
- Chemins du coffre-fort : chaque chemin de coffre-fort ci-dessous est relatif au coffre-fort ; l'environnement d'exécution fournit la racine du coffre-fort. Ne codez jamais en dur un chemin.
- Étiquette d'archivage Jarvis :
Label_9220311120338883160— pour archiver, ajoutez cette étiquette ET supprimezINBOXdans le même appelmodify. - Requête de scan de la boîte de réception :
gws gmail +triage --query 'is:unread label:INBOX' --max 60 - Notes de contexte :
Jarvis Summaries/triage-context.md - Dossier Éléments d'action :
Jarvis Summaries/Action Items/ - Base des Éléments d'action (existe déjà — ne jamais recréer) :
Jarvis Summaries/Email Action Items.base - Dossier Résumés :
Jarvis Summaries/ - Notes quotidiennes :
Daily/<YYYY-MM-DD>.md - Mise en garde
gws: les paramètres d'étiquette doivent être des chaînes simples, pas des tableaux — par ex.addLabelIds: "Label_9220311120338883160",removeLabelIds: "INBOX". - Mise en garde zsh : l'environnement utilise zsh, pas bash.
for x in $VAR; doNE fait PAS le fractionnement de mots des variables non entre guillemets dans zsh (contrairement à bash) — une boucle multi-ID construite de cette façon s'exécute silencieusement une fois avec la chaîne entière comme$x. Utilisez plutôt un tableau zsh :IDS=(id1 id2 id3); for id in "${IDS[@]}"; do .... De plus,statusest une variable interne en lecture seule dans zsh — ne jamais nommer une variable shellstatus(utilisezstou similaire) sinon l'affectation échoue.
ÉTAPE 0 — Lire les notes de contexte
Lisez le fichier de notes de contexte. Ce sont des notes de Rick sur ce qu'il a déjà traité ou ce qu'il souhaite voir traité différemment lors de cette exécution — intégrez-les dans chaque décision ci-dessous. Après l'exécution, supprimez les notes sur lesquelles vous avez agi (modifiez la section Notes en attente). Si une note doit devenir une règle permanente, ajoutez-la dans references/preferences.md au lieu de la laisser dans le fichier de contexte.
ÉTAPE 0b — Déduplication par rapport aux exécutions précédentes ET à la Base des Éléments d'action
ls "Jarvis Summaries/Triage-$(date +%Y-%m-%d)"*.md 2>/dev/null(relatif à la racine du coffre-fort) — si certains existent, lisez-les et extrayez chaque sujet/expéditeur déjà sous Action requise et chaque newsletter déjà sous Points forts des newsletters.ls "Jarvis Summaries/Action Items/"et, pour tout e-mail que vous êtes sur le point de signaler, vérifiez s'il existe une note de suivi existante par identifiant Gmail :grep -rl "gmail_id: <ID>" "Jarvis Summaries/Action Items/".
Si quelque chose a déjà été signalé aujourd'hui, ou a déjà une note d'élément d'action ouverte, ne le répétez pas dans le résumé et ne créez pas de note en double — mettez seulement à jour la note existante (ÉTAPE 5b), à moins qu'il n'y ait réellement une nouvelle information (une réponse, une mise à jour, un e-mail différent sur le même sujet).
ÉTAPE 0c — Traiter les actions en attente de la base
La Base des Éléments d'action a une colonne de case à cocher archive (Rick la coche dans Obsidian). Avant de scanner la boîte de réception, balayez les actions en attente :
grep -l "^archive: true" "Jarvis Summaries/Action Items/"*.md(correspond également àarchive: truesans l'accent circonflexe en cas de différences d'indentation).- Pour chaque correspondance, lisez les métadonnées de la note. Ignorez-la si
statusest déjàDoneouDismissed(déjà traité lors d'une exécution précédente — rien à faire). - Sinon, archivez l'e-mail sous-jacent :
gws gmail users messages modify --params '{"userId": "me", "id": "<gmail_id>", "addLabelIds": "Label_9220311120338883160", "removeLabelIds": "INBOX"}'. - En cas de succès, mettez à jour les métadonnées de la note : définissez
status: Dismissedetlast_runà maintenant. Laissezarchive: trueen place comme enregistrement de l'action — ne le décochez pas. - En cas d'échec (par exemple, message déjà supprimé), laissez
statustel quel, ne réessayez pas indéfiniment et notez l'échec sous une ligne Erreurs dans le résumé de tri de cette exécution (ÉTAPE 7) pour que Rick le voie.
Cette étape est la seule qui ferme la boucle sur la case à cocher — la cocher dans Obsidian ne fait rien sur le message Gmail réel jusqu'à ce que la prochaine exécution de tri planifiée la prenne en charge (toutes les 6h, 07:00-22:00).
ÉTAPE 0d — Supprimer les éléments de suivi obsolètes
La Base des Éléments d'action ne fait que croître à moins que quelque chose ne ferme activement une note — l'ÉTAPE 0c exige que Rick remarque et coche une case, ce qui ne passe pas à l'échelle (au 2026-09-18, elle atteignait 274 notes, 253 encore Open, certaines datant de six semaines). Cette étape s'exécute à chaque tri et ferme automatiquement les notes là où il est sûr de déduire que l'élément n'est plus actif, afin que la Base reste une liste fiable des choses qui nécessitent encore l'attention de Rick.
- Listez le
gmail_idde chaque noteOpendansJarvis Summaries/Action Items/. - Récupérez l'ensemble complet des identifiants de la boîte de réception actuelle (pas seulement non lus) :
gws gmail users messages list --params '{"userId": "me", "q": "in:inbox", "maxResults": 500}'. Si la réponse inclutnextPageToken, répétez avecpageTokendéfini jusqu'à ce qu'il s'arrête, pour couvrir toute la boîte de réception (elle dépasse régulièrement 500). - Fermez toute note
Opendont legmail_idn'est plus dans cet ensemble. Si l'e-mail sous-jacent n'est plus du tout dans la boîte de réception, Rick (ou quelque chose d'autre) l'a déjà traité en dehors de ce flux — la note est orpheline. Définissezstatus: Dismissed, laissezarchive: false(rien à archiver), et ajoutez une ligne au corps de la note :**Fermée automatiquement le <date du jour> :** l'e-mail sous-jacent n'est plus dans la boîte de réception — résolu en dehors du flux de tri.Ne touchez pas aux notes dont l'e-mail est encore dans la boîte de réception ; celles-ci nécessitent toujours un examen humain. - Supprimez le bruit spécifique à la catégorie pour les notes encore dans la boîte de réception :
CI/CD: sifirst_seendate de plus de 5 jours et que la note n'a jamais été mise à jour àIn Progress/Donepar Rick, traitez-la comme obsolète (les échecs CI sont toujours remplacés par l'exécution suivante ou un examen direct du dépôt — une note de suivi vieille d'une semaine n'a aucune valeur informative). Archivez l'e-mail (étiquette Jarvis) et définissezstatus: Dismissed, en notant**Fermée automatiquement le <date> :** notification CI/CD non résolue après 5+ jours, traitée comme obsolète — vérifiez le dépôt directement si toujours pertinent.Appointment: sidue_date(ouemail_datequand il n'y a pas dedue_date) est dans le passé, le rendez-vous a déjà eu lieu ou est passé — archivez l'e-mail et fermez avec**Fermée automatiquement le <date> :** la date du rendez-vous est passée.- Avis d'expédition/livraison classés sous
Other(le sujet correspond à "package"/"delivery"/"shipped"/"on the way") : si datant de plus de 10 jours, archivez et fermez avec**Fermée automatiquement le <date> :** la fenêtre d'expédition est écoulée.(Mieux : selon l'ÉTAPE 5b, classez-les comme déjà fermés à la création pour que celle-ci n'ait jamais à les rattraper — voir la note là-bas.) - Laissez
Billing,Security,Compliance,Invoice,Benefits,Opportunity,Solar,SEO, etAccounttranquilles ici — ces catégories peuvent impliquer de l'argent réel, des délais ou des jugements, donc seule la vérification de présence dans la boîte de réception de l'étape 3 s'applique ; ne les supprimez jamais sur un minuteur.
- Rapportez les comptes, pas une liste par élément, dans le résumé de tri (ÉTAPE 7) — par ex.,
Ménage : fermé 14 notes obsolètes (9 plus dans la boîte de réception, 4 CI/CD vieillies, 1 rendez-vous passé).Une liste détaillée complète n'est pas un signal utile ; le compte confirme que le balayage a eu lieu.
ÉTAPE 1 — Scanner les messages non lus
Exécutez la requête de scan de la boîte de réception ci-dessus. (Remarque : gws gmail +triage simple sans requête par défaut à is:unread sur toute la boîte aux lettres, limité à 20 — il manque le vrai backlog de la boîte de réception car les courriers déjà archivés mais encore non lus noient les vrais éléments de la boîte de réception. Passez toujours la requête explicite label:INBOX pour scanner la vraie boîte de réception.)
ÉTAPE 2 — Archiver le bruit de routine
Archivez (étiquette jarvis + supprimer INBOX) : succès TestFlight / GitHub / Vercel, promos Experian, TaxSlayer, alertes de sécurité Google pour les comptes connus. Archivez également les newsletters après avoir résumé leurs points forts (ÉTAPE 4) — ne les laissez pas dans la boîte de réception.
ÉTAPE 3 — Avis de l'immeuble/de la copropriété
Déplacez les e-mails de l'association des copropriétaires / de l'immeuble vers l'étiquette Home.
ÉTAPE 4 — Newsletters
Scannez les newsletters (WBEZ, Block Club, City Cast, etc.) pour trouver des extraits correspondant aux centres d'intérêt de Rick : viandes fumées, pain, cyclisme, domotique, Linux, région locale du Sud-Ouest du Michigan, voyages au Costa Rica / Portugal (carte complète des centres d'intérêt dans references/preferences.md). Résumez toute correspondance, puis archivez la newsletter (étiquette jarvis). IGNOREZ toute newsletter déjà résumée aujourd'hui (ÉTAPE 0b) — archivez-la simplement silencieusement.
ÉTAPE 5 — Signaler Action requise
Signalez : factures de contacts prioritaires, alertes de production / facturation / sécurité, délais de conformité / attestation, préparation de rendez-vous, et opportunités rémunérées. Ignorez tout ce que les notes de contexte disent que Rick a déjà traité. IGNOREZ tout ce qui a déjà été signalé aujourd'hui ou déjà suivi par une note d'élément d'action ouverte (ÉTAPE 0b), à moins qu'il n'y ait réellement une nouvelle information. Les notifications pures d'expédition/suivi (« votre commande a été expédiée ») sont signalées une fois, puis archivées — classez leur note de suivi comme déjà fermée (status: Dismissed, archive: true) à la création à l'ÉTAPE 5b plutôt que Open, car il n'y a aucune action de suivi à attendre pour un avis d'expédition. Laisser ces notes Open est exactement le genre de chose que l'ÉTAPE 0d doit nettoyer plus tard sans raison.
ÉTAPE 5b — Maintenir la Base des Éléments d'action
Pour chaque élément signalé à l'ÉTAPE 5, assurez-vous qu'il est suivi comme une note dans le dossier des Éléments d'action afin qu'il apparaisse dans la Base Email Action Items. Le fichier Base existe déjà — ne le RECRÉEZ pas.
- Déduplication sur
gmail_id(ÉTAPE 0b). Si une note avec cet id existe : mettez seulement à jourlast_run(etlast_seen) à l'exécution actuelle — n'écrasez PASstatus(Rick le gère manuellement) et ne dupliquez pas. Si le statut de la note existante estDoneouDismissed, laissez-la fermée ; ne la rouvrez pas et ne la signalez pas à nouveau. - Si aucune note n'existe, créez-en une. Nom du fichier :
<Expéditeur> - <sujet court>.md(supprimez les caractères invalides pour les noms de fichiers :/ \ :etc.). Schéma des métadonnées :
---
type: email-action
status: Open # Open | In Progress | Done | Dismissed (Rick édite ceci dans Obsidian)
archive: false # Rick coche cette case dans la Base pour archiver l'e-mail + fermer l'élément (ÉTAPE 0c)
priority: High # High | Medium | Low
priority_rank: 1 # 1=High, 2=Medium, 3=Low (définit l'ordre de tri)
category: Billing # Billing | Invoice | Security | Compliance | CI/CD | Account | Benefits | Appointment | Opportunity | Solar | SEO | Other
sender: "Vercel"
subject: "..."
email_date: YYYY-MM-DD # date de réception de l'e-mail
due_date: # optionnel ; seulement si l'e-mail mentionne une date d'échéance
gmail_id: <id hexadécimal de gws>
gmail_link: https://mail.google.com/mail/u/0/#all/<id hexadécimal>
first_seen: YYYY-MM-DD # aujourd'hui
last_run: YYYY-MM-DD-HH-MM
---
Corps : un H1 # <Expéditeur> — <sujet>, une description de 1 à 2 phrases de l'action nécessaire, et une ligne **[Ouvrir dans Gmail](<gmail_link>)**. L'id hexadécimal de gmail_link est le même identifiant de message/fil hexadécimal que gws renvoie — c'est le permalien web de Gmail.
- Attribuez la priorité judicieusement : High = argent en jeu / production arrêtée / délai strict (échecs de facturation, paiements en retard, failles de sécurité, attestations de conformité) ; Medium = nécessite une décision ou une réponse bientôt (factures, échecs CI, configuration de compte, rendez-vous, opportunités rémunérées) ; Low = informatif mais actionnable (relevés, audits SEO, relances marketing).
ÉTAPE 6 — Suspens voyage
N'archivez PAS les e-mails de voyage (Marriott, AC Hotels, UPS, compagnies aériennes) tant que le voyage n'est pas confirmé terminé. Voir la section Voyage & Rapports de voyage ci-dessous.
ÉTAPE 7 — Rédiger le résumé de tri
Écrivez dans Jarvis Summaries/Triage-<YYYY-MM-DD-HH-MM>.md avec les sections : Action requise, Points forts des newsletters, Archivé, Ménage. Sous Action requise, notez que les éléments sont également suivis dans la Base [[Jarvis Summaries/Email Action Items.base|Email Action Items]]. Si l'ÉTAPE 0c a traité des actions de case à cocher, ajoutez une ligne Archivé via la Base les listant, et une ligne Erreurs pour celles qui ont échoué. Sous Ménage, rapportez les comptes de clôture de l'ÉTAPE 0d. Si rien de nouveau n'a été trouvé, écrivez une brève note « Aucun nouvel élément depuis la dernière exécution » (le ménage de l'ÉTAPE 0d s'exécute toujours et est rapporté) et arrêtez-vous.
ÉTAPE 8 — Lien dans la note quotidienne
Ajoutez un wikilink vers le fichier de résumé dans Daily/<YYYY-MM-DD>.md sous une section ## Claude Sessions (créez la section si elle manque).
Exécutions planifiées/non supervisées : terminez les ÉTAPES 0 à 8 et arrêtez-vous — pas besoin de publier le résumé ailleurs.
Voyage & Rapports de voyage
- Identifier : Suivez les e-mails d'hôtel (Marriott, AC Hotels), de vol et d'expédition (UPS).
- Flux de travail : (Futur) Vérifier le calendrier pour corréler ceux-ci en un seul « Rapport de voyage ».
- Action : N'archivez pas les reçus/informations de voyage tant que le voyage n'est pas terminé.
Protocole de réponse
- Contacts prioritaires : (par ex. entrepreneur HVAC) Rédigez des réponses courtes et polies aux factures ou demandes de renseignements.
- Sécurité : N'autorisez jamais les paiements et ne cliquez pas sur les liens financiers sans confirmation explicite de Rick.
Création de brouillons Gmail (avec ou sans pièces jointes)
L'outil CLI gws ne peut pas gérer de grandes charges utiles comme arguments de ligne de commande. Utilisez plutôt la recette Python ci-dessous, qui déchiffre directement les identifiants gws et appelle l'API Gmail.
Brouillon texte uniquement :
import base64, json, subprocess
from email.mime.text import MIMEText
# Obtenir un jeton d'accès frais
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.
…
[non pertinent pour la traduction]