Communitygithub.com

RB Personal Assistant

Persönlicher Assistent für die Gmail-Posteingangsverwaltung, das Verfassen von Antwortentwürfen, das Scannen von Newslettern nach Interessen und die Erstellung von Reiseberichten. Verantwortlich für die vollständige planmäßige Gmail-Posteingangs-Triage (einschließlich der Obsidian "Email Action Items"-Basis).

Was ist RB Personal Assistant?

Der **RB Personal Assistant** Skill befähigt einen KI-Assistenten (Claude oder Gemini) als proaktiven Assistenten für den Gmail-Posteingang und berufliche Arbeitsabläufe. Er ist die einzige Quelle der Wahrheit für die Posteingangs-Triage-Prozedur – der geplante Cron-Job ruft diesen Skill auf, sodass die gesamte Logik hier und nicht im Cron-Prompt dupliziert wird. Der Skill unterstützt Claude Code (und andere agentische Tools) auf macOS und Linux und nutzt das `gws` CLI-Tool zur Gmail-Interaktion sowie Obsidian/Vault-Dateien zur Speicherung von Kontextnotizen, Aktionspunkten und Zusammenfassungen. Der Arbeitsablauf umfasst das Lesen von Kontextnotizen, das Entfernen von Duplikaten, das Scannen ungelesener Nachrichten, das Archivieren von Routine-Rauschen (TestFlight, GitHub, Newsletter-Benachrichtigungen), das Markieren von Aktionen aus Rechnungen, Sicherheitswarnungen und verpassten Chancen, und das Schreiben einer täglichen Triage-Zusammenfassung. Ein wichtiges Merkmal ist die automatische Bereinigung veralteter Aktionspunkte (Staleness-Aging), die die Basis überschaubar hält, indem sie Elemente schließt, deren E-Mail nicht mehr im Posteingang ist oder die älter als 5 Tage sind (CI/CD) bzw. nach ihrem Fälligkeitsdatum. Der Skill behandelt auch Reise-E-Mails (Hotel, Flug, Versand) und erstellt Gmail-Entwürfe über einen Python-Codeblock, um die Einschränkungen des `gws` CLI bei großen Anhängen zu umgehen. Der Assistent antwortet immer auf Deutsch und stellt die Bedürfnisse des Benutzers (Rick) in den Vordergrund, mit starker Betonung auf Datenschutz, Genauigkeit und Sicherheit.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht RB Personal Assistant?

Portabilität nutzen

Nutze den aktiven Harness-Gmail-Connector, die Secure-Secret-Anfrage, Vault-/Dateiwerkzeuge und die entsprechenden Scheduler. Falls ein erforderlicher Connector nicht verfügbar ist, erstelle einen Entwurf/Bericht und identifiziere die fehlende Fähigkeit; umgehe niemals die Bestätigungsregeln zum Senden von E-Mails oder zum Ändern des externen Zustands. Vorhandene Überschriften aus Claude Sessions im Vault werden als Speicherschema beibehalten, nicht als Harness-Anforderung.

Dieser Skill ermöglicht es einem KI-Assistenten (Claude oder Gemini), als proaktiver Assistent für Ricks Gmail-Posteingang und berufliche Arbeitsabläufe zu agieren. Er ist die einzige Quelle der Wahrheit für die Posteingangs-Triage-Prozedur – der geplante Cron-Job ruft einfach diesen Skill auf, also bewahre die gesamte Logik hier und dupliziere sie nicht im Cron-Prompt.


Gmail Posteingangs-Triage – Vollständige Prozedur

Führe dies immer dann aus, wenn eine Triage des Posteingangs angefordert wird, einschließlich geplanter/unbeaufsichtigter Läufe. Verwende das gws CLI (bereits im PATH). Arbeite die Schritte der Reihe nach ab.

Wichtige Konstanten

  • Vault-Pfade: jeder Vault-Pfad unten ist vault-relativ; die Laufzeitumgebung stellt das Vault-Root zur Verfügung. Hartcodiere niemals einen Pfad.
  • Jarvis-Archiv-Label: Label_9220311120338883160 – zum Archivieren füge dieses Label HINZU und entferne INBOX im selben modify-Aufruf.
  • Posteingangs-Scan-Abfrage: gws gmail +triage --query 'is:unread label:INBOX' --max 60
  • Kontextnotizen: Jarvis Summaries/triage-context.md
  • Aktionspunkte-Ordner: Jarvis Summaries/Action Items/
  • Aktionspunkte-Basis (existiert bereits – niemals neu erstellen): Jarvis Summaries/Email Action Items.base
  • Zusammenfassungs-Ordner: Jarvis Summaries/
  • Tägliche Notizen: Daily/<YYYY-MM-DD>.md
  • gws-Hinweis: Label-Parameter müssen einfache Zeichenketten sein, keine Arrays – z. B. addLabelIds: "Label_9220311120338883160", removeLabelIds: "INBOX".
  • zsh-Hinweis: Die Shell dieser Umgebung ist zsh, nicht bash. for x in $VAR; do führt in zsh KEINE Worttrennung für nicht in Anführungszeichen gesetzte Variablen durch (anders als in bash) – eine auf diese Weise aufgebaute Schleife mit mehreren IDs wird einmal still mit der gesamten Zeichenkette als $x ausgeführt. Verwende stattdessen ein zsh-Array: IDS=(id1 id2 id3); for id in "${IDS[@]}"; do .... Außerdem ist status eine schreibgeschützte Built-in-Variable in zsh – nenne niemals eine Shell-Variable status (verwende st oder ähnlich), sonst schlägt die Zuweisung fehl.

SCHRITT 0 – Kontextnotizen lesen

Lese die Kontextnotizen-Datei. Dies sind Notizen von Rick über Dinge, die er bereits erledigt hat oder die in diesem Durchlauf anders behandelt werden sollen – beziehe sie in jede Entscheidung unten mit ein. Entferne nach dem Durchlauf alle Notizen, auf die du reagiert hast (bearbeite den Abschnitt „Ausstehende Notizen"). Wenn eine Notiz eine dauerhafte Regel werden soll, füge sie zu references/preferences.md hinzu, anstatt sie in der Kontextdatei zu belassen.

SCHRITT 0b – Gegen vorherige Läufe UND die Aktionspunkte-Basis deduplizieren

  1. ls "Jarvis Summaries/Triage-$(date +%Y-%m-%d)"*.md 2>/dev/null (relativ zum Vault-Root) – falls vorhanden, lies sie und extrahiere jeden Betreff/Absender, der bereits unter Aktion erforderlich steht, und jeden Newsletter, der bereits unter Newsletter-Highlights steht.
  2. ls "Jarvis Summaries/Action Items/" und überprüfe für jede E-Mail, die du markieren möchtest, ob es bereits eine Tracking-Notiz mit der Gmail-ID gibt: grep -rl "gmail_id: <ID>" "Jarvis Summaries/Action Items/".

Wenn etwas bereits heute gemeldet wurde oder bereits eine offene Aktionspunkt-Notiz existiert, wiederhole es nicht in der Zusammenfassung und erstelle keine doppelte Notiz – aktualisiere nur die vorhandene Notiz (SCHRITT 5b), es sei denn, es gibt wirklich neue Informationen (eine Antwort, ein Update, eine andere E-Mail zum gleichen Thema).

SCHRITT 0c – Ausstehende Aktionen aus der Basis verarbeiten

Die Aktionspunkte-Basis hat eine archive-Kontrollkästchenspalte (Rick markiert sie in Obsidian). Bevor du den Posteingang scanst, durchsuche sie nach ausstehenden Aktionen:

  1. grep -l "^archive: true" "Jarvis Summaries/Action Items/"*.md (stimme auch auf archive: true ohne Caret überein, falls Einrückungsunterschiede vorliegen).
  2. Lies für jede Übereinstimmung das Frontmatter der Notiz. Überspringe sie, wenn der status bereits Done oder Dismissed ist (bereits in einem vorherigen Durchlauf verarbeitet – nichts zu tun).
  3. Archiviere andernfalls die zugrunde liegende E-Mail: gws gmail users messages modify --params '{"userId": "me", "id": "<gmail_id>", "addLabelIds": "Label_9220311120338883160", "removeLabelIds": "INBOX"}'.
  4. Aktualisiere bei Erfolg das Frontmatter der Notiz: setze status: Dismissed und last_run auf jetzt. Lasse archive: true an Ort und Stelle als Aufzeichnung der Aktion – deaktiviere es nicht.
  5. Bei Fehler (z. B. Nachricht bereits gelöscht) lasse den status unverändert, wiederhole nicht endlos und notiere den Fehler unter einer Fehler-Zeile in der Triage-Zusammenfassung dieses Durchlaufs (SCHRITT 7), damit Rick es sieht.

Dieser Schritt ist das Einzige, was den Kreislauf für das Kontrollkästchen schließt – das Aktivieren in Obsidian hat keine Auswirkung auf die tatsächliche Gmail-Nachricht, bis der nächste geplante Triage-Durchlauf es aufgreift (alle 6 Stunden, 07:00-22:00 Uhr).

SCHRITT 0d – Veraltete verfolgte Elemente ausmustern

Die Aktionspunkte-Basis wächst nur, es sei denn, etwas schließt aktiv eine Notiz – SCHRITT 0c erfordert, dass Rick ein Kästchen bemerkt und aktiviert, was nicht skalierbar ist (bis zum 18.09.2026 hatte sie 274 Notizen erreicht, 253 noch Open, einige davon sechs Wochen alt). Dieser Schritt wird bei jeder Triage ausgeführt und schließt Notizen automatisch, wo immer es sicher abgeleitet werden kann, dass das Element nicht mehr aktuell ist, damit die Basis eine zuverlässige Liste der Dinge bleibt, die tatsächlich noch Ricks Aufmerksamkeit benötigen.

  1. Liste alle gmail_ids aller Open-Notizen in Jarvis Summaries/Action Items/ auf.
  2. Rufe den aktuellen vollständigen Satz von Posteingangs-IDs ab (nicht nur ungelesen): gws gmail users messages list --params '{"userId": "me", "q": "in:inbox", "maxResults": 500}'. Wenn die Antwort nextPageToken enthält, wiederhole mit gesetztem pageToken, bis es aufhört, damit der gesamte Posteingang abgedeckt ist (überschreitet regelmäßig 500).
  3. Schließe jede Open-Notiz, deren gmail_id nicht mehr in diesem Satz ist. Wenn die zugrunde liegende E-Mail überhaupt nicht mehr im Posteingang ist, hat Rick (oder etwas anderes) sie bereits außerhalb dieses Ablaufs behandelt – die Notiz ist verwaist. Setze status: Dismissed, lasse archive: false (nichts mehr zu archivieren) und füge eine Zeile zum Notiztext hinzu: **Auto-geschlossen <heutiges Datum>:** zugrunde liegende E-Mail nicht mehr im Posteingang – außerhalb des Triage-Ablaufs erledigt. Bearbeite keine Notizen, deren E-Mail noch im Posteingang ist; diese benötigen noch eine menschliche Prüfung.
  4. Mustere kategoriespezifisches Rauschen für Notizen aus, die noch im Posteingang sind:
    • CI/CD: wenn first_seen mehr als 5 Tage zurückliegt und die Notiz nie von Rick auf In Progress/Done aktualisiert wurde, behandle sie als veraltet (CI-Fehler werden immer durch den nächsten Lauf oder einen direkten Blick ins Repo ersetzt – eine eine Woche alte Tracking-Notiz hat keinen Informationswert). Archiviere die E-Mail (Jarvis-Label) und setze status: Dismissed, mit dem Hinweis **Auto-geschlossen <Datum>:** CI/CD-Meldung nach 5+ Tagen ungelöst, als veraltet behandelt – prüfe das Repo direkt, falls noch relevant.
    • Termin: wenn due_date (oder email_date, wenn kein due_date) in der Vergangenheit liegt, hat der Termin bereits stattgefunden oder ist vorbei – archiviere die E-Mail und verwerfe sie mit **Auto-geschlossen <Datum>:** Termindatum ist überschritten.
    • Versand-/Lieferbenachrichtigungen unter Sonstiges (Betreff enthält "Paket"/"Lieferung"/"versandt"/"unterwegs"): wenn älter als 10 Tage, archiviere und verwerfe mit **Auto-geschlossen <Datum>:** Versandzeitraum ist abgelaufen. (Besser: gemäß SCHRITT 5b diese bei der Erstellung bereits als geschlossen ablegen, damit dies nie einen abfangen muss – siehe Hinweis dort.)
    • Lasse Abrechnung, Sicherheit, Compliance, Rechnung, Leistungen, Gelegenheit, Solar, SEO und Konto hier in Ruhe – diese Kategorien können echtes Geld, Fristen oder Ermessensentscheidungen beinhalten, daher gilt hier nur die Posteingangs-Prüfung aus Schritt 3; mustere sie niemals zeitlich aus.
  5. Melde Anzahlen, keine Einzelliste, in der Triage-Zusammenfassung (SCHRITT 7) – z. B. Haushalt: 14 veraltete Notizen geschlossen (9 nicht mehr im Posteingang, 4 gealterte CI/CD, 1 überfälliger Termin). Eine vollständige detaillierte Liste ist kein nützliches Signal; die Anzahl bestätigt, dass die Bereinigung ausgeführt wurde.

SCHRITT 1 – Ungelesene Nachrichten scannen

Führe die obige Posteingangs-Scan-Abfrage aus. (Hinweis: einfaches gws gmail +triage ohne Abfrage verwendet standardmäßig is:unread im gesamten Postfach, begrenzt auf 20 – es übersieht den tatsächlichen Posteingangs-Rückstand, weil bereits archivierte, aber noch ungelesene Mails die echten Posteingangseinträge verdrängen. Gib immer die explizite label:INBOX-Abfrage an, damit dies den tatsächlichen Posteingang scannt.)

SCHRITT 2 – Routine-Rauschen archivieren

Archiviere (Jarvis-Label + INBOX entfernen): TestFlight / GitHub / Vercel-Erfolge, Experian-Werbung, TaxSlayer, Google-Sicherheitswarnungen für bekannte Konten. Archiviere auch Newsletter, nachdem ihre Highlights zusammengefasst wurden (SCHRITT 4) – belasse sie nicht im Posteingang.

SCHRITT 3 – Bau- / Eigentumswohnungsmitteilungen

Verschiebe E-Mails der Eigentumswohnungsanlage / des Gebäudes in das Label Zuhause.

SCHRITT 4 – Newsletter

Scanne Newsletter (WBEZ, Block Club, City Cast usw.) nach Textstellen, die Ricks Interessen entsprechen: Geräuchertes Fleisch, Brot, Radfahren, Hausautomation, Linux, Region SW Michigan, Costa Rica / Portugal-Reisen (vollständige Interessenkarte in references/preferences.md). Fasse alle Treffer zusammen, archiviere dann den Newsletter (Jarvis-Label). ÜBERSPRINGE jeden Newsletter, der heute bereits zusammengefasst wurde (SCHRITT 0b) – archiviere ihn einfach still.

SCHRITT 5 – Aktion erforderlich markieren

Markiere: Rechnungen von Prioritätskontakten, Produktions-/Abrechnungs-/Sicherheitswarnungen, Compliance-/Zertifizierungsfristen, Terminvorbereitung und bezahlte Gelegenheiten. Überspringe alles, von dem die Kontextnotizen sagen, dass Rick es bereits erledigt hat. ÜBERSPRINGE alles, was heute bereits gemeldet wurde oder bereits von einer offenen Aktionspunkt-Notiz verfolgt wird (SCHRITT 0b), es sei denn, es gibt wirklich neue Informationen. Reine Versand-/Sendungsverfolgungsbenachrichtigungen ("Ihre Bestellung wurde versandt") werden einmal gemeldet, dann archiviert – lege ihre Tracking-Notiz bei der Erstellung in SCHRITT 5b als bereits geschlossen (status: Dismissed, archive: true) an, nicht als Open, da eine Versandbenachrichtigung keine Folgemaßnahme benötigt, auf die gewartet werden muss. Diese als Open zu belassen ist genau die Art von Notiz, die SCHRITT 0d später ohne Grund bereinigen muss.

SCHRITT 5b – Die Aktionspunkte-Basis pflegen

Stelle für jedes in SCHRITT 5 markierte Element sicher, dass es als Notiz im Aktionspunkte-Ordner verfolgt wird, damit es in der Email Action Items-Basis erscheint. Die Basisdatei existiert bereits – erstelle sie NICHT neu.

  • Deduplizierung basierend auf gmail_id (SCHRITT 0b). Wenn eine Notiz mit dieser ID existiert: aktualisiere nur last_run (und last_seen) auf den aktuellen Lauf – überschreibe NICHT den status (Rick verwaltet ihn manuell) und dupliziere NICHT. Wenn der Status der vorhandenen Notiz Done oder Dismissed ist, belasse sie geschlossen; öffne oder markiere sie nicht erneut.
  • Wenn keine Notiz existiert, erstelle eine. Dateiname: <Absender> - <kurzer Betreff>.md (entferne dateinamenungültige Zeichen: / \ : usw.). Frontmatter-Schema:
---
type: email-action
status: Open            # Open | In Progress | Done | Dismissed  (Rick bearbeitet dies in Obsidian)
archive: false          # Rick aktiviert dieses Kästchen in der Basis, um die E-Mail zu archivieren und das Element zu schließen (SCHRITT 0c)
priority: High          # High | Medium | Low
priority_rank: 1        # 1=High, 2=Medium, 3=Low  (bestimmt die Sortierreihenfolge)
category: Billing       # Billing | Invoice | Security | Compliance | CI/CD | Account | Benefits | Appointment | Opportunity | Solar | SEO | Other
sender: "Vercel"
subject: "..."
email_date: YYYY-MM-DD  # Datum des E-Mail-Eingangs
due_date:               # optional; nur wenn die E-Mail ein Fälligkeitsdatum angibt
gmail_id: <hex ID von gws>
gmail_link: https://mail.google.com/mail/u/0/#all/<hex ID>
first_seen: YYYY-MM-DD  # heute
last_run: YYYY-MM-DD-HH-MM
---

Textkörper: eine H1-Überschrift # <Absender> — <Betreff>, eine 1–2-sätzige Beschreibung der erforderlichen Aktion und eine Zeile mit **[In Gmail öffnen](<gmail_link>)**. Die hex ID im gmail_link ist dieselbe hex Nachrichten-/Thread-ID, die gws zurückgibt – es ist der Web-Permalink von Gmail.

  • Priorität sinnvoll zuweisen: High = Geld in Gefahr / Produktion ausgefallen / harte Frist (Zahlungsausfälle, überfällige Zahlungen, Sicherheitsverstöße, Compliance-Zertifizierungen); Medium = erfordert bald eine Entscheidung oder Antwort (Rechnungen, CI-Fehler, Kontoeinrichtung, Termine, bezahlte Gelegenheiten); Low = informativ, aber handlungsrelevant (Kontoauszüge, SEO-Audits, Marketing-Erinnerungen).

SCHRITT 6 – Reise-Haltepunkt

Archiviere KEINE Reise-E-Mails (Marriott, AC Hotels, UPS, Fluggesellschaften), bis die Reise bestätigt beendet ist. Siehe Reise- & Reiseberichterstattung unten.

SCHRITT 7 – Die Triage-Zusammenfassung schreiben

Schreibe nach Jarvis Summaries/Triage-<YYYY-MM-DD-HH-MM>.md mit den Abschnitten: Aktion erforderlich, Newsletter-Highlights, Archiviert, Haushalt. Unter Aktion erforderlich weise darauf hin, dass Elemente auch in der Basis [[Jarvis Summaries/Email Action Items.base|Email Action Items]] verfolgt werden. Wenn SCHRITT 0c Kontrollkästchen-Aktionen verarbeitet hat, füge eine Zeile Über Basis archiviert hinzu, die sie auflistet, und eine Fehler-Zeile für fehlgeschlagene. Unter Haushalt melde die Schließungszahlen aus SCHRITT 0d. Wenn nichts Neues gefunden wurde, schreibe einen kurzen „Keine neuen Elemente seit dem letzten Lauf"-Hinweis (die Haushaltsbereinigung aus SCHRITT 0d läuft trotzdem und wird gemeldet) und beende.

SCHRITT 8 – In der täglichen Notiz verlinken

Füge einen Wikilink zur Zusammenfassungsdatei in Daily/<YYYY-MM-DD>.md unter einem Abschnitt ## Claude Sessions hinzu (erstelle den Abschnitt, wenn er fehlt).

Geplante/unbeaufsichtigte Läufe: führe SCHRITT 0–8 aus und beende – es ist nicht nötig, die Zusammenfassung woanders zu posten.


Reise- & Reiseberichterstattung

  • Identifizieren: Verfolge E-Mails von Hotels (Marriott, AC Hotels), Flügen und Versand (UPS).
  • Ablauf: (Zukunft) Überprüfe den Kalender, um diese zu einem einzigen "Reisebericht" zu korrelieren.
  • Aktion: Archiviere keine Reisebelege/-informationen, bis die Reise abgeschlossen ist.

Antwortprotokoll

  • Prioritätskontakte: (z. B. HVAC-Auftragnehmer) Verfasse kurze, höfliche Antworten auf Rechnungen oder Anfragen.
  • Sicherheit: Autorisieren Sie niemals Zahlungen oder klicken Sie auf Finanzlinks ohne explizite Bestätigung von Rick.

Erstellen von Gmail-Entwürfen (mit oder ohne Anhänge)

Das gws CLI kann keine großen Nutzlasten als Befehlszeilenargumente verarbeiten. Verwende stattdessen das folgende Python-Rezept, das die gws-Anmeldeinformationen direkt entschlüsselt und die Gmail-API aufruft.

Nur-Text-Entwurf:

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

# Aktuelles Zugriffstoken abrufen
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.

…

[gekürzt für die Übersetzung]

Verwandte Skills