Communitygithub.com

richardbowman/agent-skills

Gmailのトリアージ、下書き作成、ニュースレターのスキャン、出張レポート作成のためのパーソナルアシスタントスキル。スケジュールされたGmail受信トレイのトリアージ手順(Obsidianの「Email Action Items」ベースを含む)を完全に管理します。メール管理やトラベル/開発ワークフローの自動化に使用します。

agent-skills とは?

このスキルは、ClaudeやGeminiなどのAIアシスタントが、RickのGmail受信トレイとプロフェッショナルワークフローに対してプロアクティブなアシスタントとして機能することを可能にします。スケジュールされたcronジョブがこのスキルを呼び出すため、トリアージ手順の完全なロジックをここに保持し、重複を防ぎます。Gmail APIへのアクセスには`gws` CLIを使用し、Gmailメッセージのスキャン、アーカイブ、ラベル付けを実行します。重要な機能として、自動化された受信トレイトリアージ手順、ニュースレターからの関心トピックの抽出、アクションアイテムのObsidianベースへの追跡、出張レポートの作成、ステップ0dの自動エージングアウトロジックによる古いアクションアイテムのクリーンアップなどがあります。このスキルは、メール確認のスケジュール実行と、ユーザーが直接要求するアドホックな実行の両方をサポートし、添付ファイル付きのGmail下書きも作成できます。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

RB パーソナルアシスタント

ハーネスのポータビリティ

アクティブなハーネスのGmailコネクタ、セキュアシークレットリクエスト、ボールト/ファイルツール、およびスケジューラの同等機能を使用します。必要なコネクタが利用できない場合は、下書き/レポートを作成し、不足している機能を特定します。メールの送信や外部状態の変更に関する確認ルールをバイパスしないでください。既存のClaude Sessionsボールト見出しは、ハーネスの要件ではなく、ストレージスキーマとして保持されます。

このスキルにより、AIアシスタント(ClaudeまたはGemini)は、RickのGmail受信トレイとプロフェッショナルワークフローに対してプロアクティブなアシスタントとして機能できます。これは、受信トレイトリアージ手順の唯一の情報源です。スケジュールされたcronジョブは単にこのスキルを呼び出すため、cronプロンプトでロジックを複製するのではなく、すべてのロジックをここに保持してください。


Gmail受信トレイトリアージ — 完全な手順

受信トレイのトリアージを求められたときは常に、スケジュール実行および無人実行を含めて、これを実行してください。gws CLI(PATH上にあり)を使用します。手順を順に進めてください。

主要な定数

  • ボールトパス: 以下のすべてのボールトパスはボールト相対パスです。ランタイムがボールトルートを提供します。ハードコードしないでください。
  • Jarvisアーカイブラベル: Label_9220311120338883160 — アーカイブするには、同じmodify呼び出しでこのラベルを追加し、INBOXを削除します。
  • 受信トレイスキャンクエリ: gws gmail +triage --query 'is:unread label:INBOX' --max 60
  • コンテキストノート: Jarvis Summaries/triage-context.md
  • アクションアイテムフォルダ: Jarvis Summaries/Action Items/
  • アクションアイテムベース(既に存在 — 決して再作成しない): Jarvis Summaries/Email Action Items.base
  • サマリーフォルダ: Jarvis Summaries/
  • デイリーノート: Daily/<YYYY-MM-DD>.md
  • gwsの注意点: ラベルパラメータはプレーンな文字列でなければならず、配列ではありません。例: addLabelIds: "Label_9220311120338883160"、removeLabelIds: "INBOX"。
  • zshの注意点: この環境のシェルはzshであり、bashではありません。for x in $VAR; do はzshでは(bashとは異なり)引用符で囲まれていない変数をワード分割しません。その方法で構築されたマルチIDループは、文字列全体を$xとして1回だけ静かに実行されます。代わりにzsh配列を使用してください: IDS=(id1 id2 id3); for id in "${IDS[@]}"; do ...。また、statusはzshの読み取り専用組み込み変数です — シェル変数にstatusという名前を付けないでください(stなどを使用)。代入に失敗します。

ステップ0 — コンテキストノートを読む

コンテキストノートファイルを読みます。これらは、Rickが既に処理したことや、この実行で異なる扱いをしたいことに関するメモです。以下のすべての決定にそれらを考慮してください。実行後、処理したノートを削除します(保留中のノートセクションを編集)。ノートが恒久的なルールになるべき場合は、コンテキストファイルに残すのではなく、references/preferences.mdに追加してください。

ステップ0b — 以前の実行およびアクションアイテムベースに対して重複排除

  1. ls "Jarvis Summaries/Triage-$(date +%Y-%m-%d)"*.md 2>/dev/null(ボールトルートからの相対パス)— 存在する場合、それらを読み、アクション必須の下に既にあるすべての件名/送信者とニュースレターハイライトの下に既にあるすべてのニュースレターを抽出します。
  2. ls "Jarvis Summaries/Action Items/" し、フラグを立てようとしているメールごとに、Gmail IDで既存の追跡ノートを確認します: grep -rl "gmail_id: <ID>" "Jarvis Summaries/Action Items/"。

何かが今日既に報告されているか、既にオープンなアクションアイテムノートがある場合、それをサマリーで繰り返さず、重複ノートも作成しないでください。既存のノートを更新するだけです(ステップ5b)。真に新しい情報(返信、更新、同じトピックの別のメール)がない限りは。

ステップ0c — 保留中のベースアクションを処理する

アクションアイテムベースにはarchiveチェックボックス列があります(RickがObsidianでチェックします)。受信トレイをスキャンする前に、保留中のアクションをスイープします:

  1. grep -l "^archive: true" "Jarvis Summaries/Action Items/"*.md(インデントの違いに対応するため、キャレットなしの archive: true も一致させる)。
  2. 一致するものごとに、ノートのフロントマターを読みます。statusが既にDoneまたはDismissedである場合はスキップします(以前の実行で既に処理済み — 行うことはありません)。
  3. そうでなければ、元のメールをアーカイブします: gws gmail users messages modify --params '{"userId": "me", "id": "<gmail_id>", "addLabelIds": "Label_9220311120338883160", "removeLabelIds": "INBOX"}'。
  4. 成功したら、ノートのフロントマターを更新します: status: Dismissed に設定し、last_run を現在時刻に設定します。archive: true はアクションの記録としてそのままにしておきます — チェックを外さないでください。
  5. 失敗した場合(例: メッセージが既に削除されている)、statusはそのままにし、無限に再試行せず、この実行のトリアージサマリー(ステップ7)のエラー行に失敗を記録してRickが確認できるようにします。

このステップのみが、チェックボックスのループを閉じます — Obsidianでチェックしても、次のスケジュールされたトリアージ実行(6時間ごと、07:00-22:00)がそれを拾うまで、実際のGmailメッセージには何も起こりません。

ステップ0d — 古くなった追跡アイテムを期限切れにする

アクションアイテムベースは、誰かが積極的にノートを閉じない限り、増える一方です。ステップ0cはRickが気づいてチェックボックスを確認する必要があり、スケーラブルではありません(2026-09-18までに274ノートに達し、253がまだOpen、中には6週間前のものもありました)。このステップはすべてのトリアージで実行され、アイテムがもはや有効でないと推測しても安全な場合は自動的にノートを閉じるため、ベースはRickの注意を実際に必要とするものの信頼できるリストであり続けます。

  1. Jarvis Summaries/Action Items/ 内のすべてのOpenノートのgmail_idをリストします。
  2. 現在の完全な受信トレイIDセット(未読だけでなく)を取得します: gws gmail users messages list --params '{"userId": "me", "q": "in:inbox", "maxResults": 500}'。レスポンスにnextPageTokenが含まれている場合、それがなくなるまでpageTokenを設定して繰り返し、完全な受信トレイをカバーします(定期的に500を超えます)。
  3. gmail_idがそのセットにもう存在しないOpenノートを閉じます。 元のメールが受信トレイにまったく存在しなくなった場合、Rick(または他の何か)がこのフローの外で既に対処しています — ノートは孤立しています。status: Dismissed に設定し、archive: false のままにし(アーカイブするものは何もない)、ノート本文に行を追加します: **Auto-closed <今日の日付>:** 元のメールが受信トレイになくなりました — トリアージフローの外部で解決されました。 メールがまだ受信トレイにあるノートには触れないでください。それらはまだ人間の確認が必要です。
  4. まだ受信トレイにあるノートについて、カテゴリ固有のノイズを期限切れにします:
    • CI/CD: first_seenが5日以上前で、ノートがRickによって一度もIn Progress/Doneに更新されていない場合、古くなったものとして扱います(CI障害は常に次の実行またはリポジトリを直接確認することで置き換えられます — 1週間前の追跡ノートに情報価値はありません)。メールをアーカイブし(Jarvisラベル)、status: Dismissed に設定し、**Auto-closed <日付>:** CI/CD通知が5日以上未解決のまま — まだ関連する場合はリポジトリを直接確認してください。 とメモします。
    • Appointment: due_date(またはdue_dateがない場合はemail_date)が過去の場合、予定は既に発生したか過ぎています — メールをアーカイブし、**Auto-closed <日付>:** 予定日が過ぎました。 として却下します。
    • Otherの下にファイルされた配送/発送通知(件名が「package」/「delivery」/「shipped」/「on the way」に一致する場合): 10日以上経過している場合、アーカイブして**Auto-closed <日付>:** 配送期間が経過しました。 として却下します(より良い方法: ステップ5bごとに、作成時にこれらを既にクローズ済みとしてファイルし、これがキャッチする必要がないようにします — そこのメモを参照)。
    • Billing、Security、Compliance、Invoice、Benefits、Opportunity、Solar、SEO、Accountはここではそのままにします — これらのカテゴリは実際の金銭、期限、または判断を伴う可能性があるため、ステップ3の受信トレイ存在チェックのみが適用され、タイマーで期限切れにしないでください。
  5. トリアージサマリー(ステップ7)に、アイテムごとのリストではなく、カウントを報告します — 例: ハウスキーピング: 14 個の古いノートをクローズしました(9個は受信トレイになし、4個は経過したCI/CD、1個は期限切れの予定)。 完全な明細リストは有用なシグナルではありません。カウントはスイープが実行されたことを確認します。

ステップ1 — 未読メッセージをスキャンする

上記の受信トレイスキャンクエリを実行します。(注: クエリなしのプレーンな gws gmail +triage は、メールボックス全体で is:unread をデフォルトとし、最大20件に制限されます — 既にアーカイブされているがまだ未読のメールが実際の受信トレイアイテムを圧迫するため、実際の受信トレイのバックログを見逃します。常に明示的な label:INBOX クエリを渡して、実際の受信トレイをスキャンするようにしてください。)

ステップ2 — ルーチンノイズをアーカイブする

アーカイブ(jarvisラベル+ INBOX削除): TestFlight / GitHub / Vercelの成功、Experianプロモ、TaxSlayer、既知のアカウントのGoogleセキュリティアラート。また、ニュースレターのハイライトを要約した後(ステップ4)、ニュースレターをアーカイブします — 受信トレイに残さないでください。

ステップ3 — 建物/コンドミニアムの通知

管理組合/ビルのメールをHomeラベルに移動します。

ステップ4 — ニュースレター

ニュースレター(WBEZ、Block Club、City Castなど)をスキャンして、Rickの関心に一致するスニペットを探します: スモークミート、パン、サイクリング、ホームオートメーション、Linux、南西ミシガン地域、コスタリカ/ポルトガル旅行(完全な関心マップはreferences/preferences.mdにあります)。ヒットを要約し、ニュースレターをアーカイブします(jarvisラベル)。今日既に要約されたニュースレターはスキップします(ステップ0b)— 静かにアーカイブするだけです。

ステップ5 — アクション必須をフラグする

優先連絡先からの請求書、プロダクション/請求/セキュリティアラート、コンプライアンス/証明の期限、予定の準備、有料の機会をフラグします。コンテキストノートでRickが既に処理したと言っているものはスキップします。今日既に報告されているか、オープンなアクションアイテムノートによって既に追跡されているものは、真に新しい情報がない限りスキップします(ステップ0b)。純粋な配送/追跡通知(「ご注文は発送されました」)は、一度報告されたらアーカイブします — その追跡ノートは、作成時に既にクローズ済み(status: Dismissed、archive: true)としてステップ5bでファイルし、Openにはしません。配送通知にフォローアップアクションを待つものはないからです。これらをOpenのままにしておくことは、ステップ0dが後で理由もなくクリーンアップしなければならないノートをまさに生み出します。

ステップ5b — アクションアイテムベースを維持する

ステップ5でフラグされた各アイテムについて、アクションアイテムフォルダにノートとして追跡され、Email Action Itemsベースに表示されるようにします。ベースファイルは既に存在します — 再作成しないでください。

  • gmail_idで重複排除(ステップ0b)。そのidのノートが存在する場合: last_run(およびlast_seen)を現在の実行に更新するだけです — statusを上書きせず(Rickが手動で管理)、重複もしないでください。既存のノートのステータスがDoneまたはDismissedである場合、閉じたままにします。再オープンしたり再フラグしたりしないでください。
  • ノートが存在しない場合、作成します。 ファイル名: <送信者> - <短い件名>.md(ファイル名に無効な文字を削除: / \ :など)。フロントマタースキーマ:
---
type: email-action
status: Open            # Open | In Progress | Done | Dismissed  (RickがObsidianで編集)
archive: false          # Rickがベースでこのボックスをチェックしてメールをアーカイブし、アイテムを閉じます (ステップ0c)
priority: High          # High | Medium | Low
priority_rank: 1        # 1=High, 2=Medium, 3=Low  (並び順を決定)
category: Billing       # Billing | Invoice | Security | Compliance | CI/CD | Account | Benefits | Appointment | Opportunity | Solar | SEO | Other
sender: "Vercel"
subject: "..."
email_date: YYYY-MM-DD  # メールを受信した日付
due_date:               # オプション; メールに期限が記載されている場合のみ
gmail_id: <gwsからの16進数id>
gmail_link: https://mail.google.com/mail/u/0/#all/<16進数id>
first_seen: YYYY-MM-DD  # 今日
last_run: YYYY-MM-DD-HH-MM
---

本文: H1 # <送信者> — <件名>、必要なアクションの1〜2文の説明、および**[Gmailで開く](<gmail_link>)**行。gmail_linkの16進数idは、gwsが返すのと同じ16進数のメッセージ/スレッドidです。これはGmailのウェブパーマリンクです。

  • 優先度を適切に割り当てます: High = 金銭リスク/プロダクション停止/厳格な期限(支払い失敗、過払い、セキュリティ侵害、コンプライアンス証明); Medium = 近いうちに決定または返信が必要(請求書、CI障害、アカウント設定、予定、有料の機会); Low = 情報提供だがアクション可能(明細書、SEO監査、マーケティングの促し)。

ステップ6 — 旅行保留

旅行メール(Marriott、AC Hotels、UPS、航空会社)は、旅行が確実に終了するまでアーカイブしないでください。下記の旅行および出張レポートを参照してください。

ステップ7 — トリアージサマリーを書く

Jarvis Summaries/Triage-<YYYY-MM-DD-HH-MM>.mdに、セクション付きで書き込みます: アクション必須、ニュースレターハイライト、アーカイブ済み、ハウスキーピング。アクション必須の下で、アイテムが[[Jarvis Summaries/Email Action Items.base|Email Action Items]]ベースでも追跡されていることに注意してください。ステップ0cがチェックボックスアクションを処理した場合、それらをリストしたベース経由でアーカイブ行と、失敗したもののエラー行を追加します。ハウスキーピングの下で、ステップ0dのクローズアウトカウントを報告します。新しいものが見つからなかった場合、簡単な「前回の実行以降新しいアイテムはありません」というメモを書き(ステップ0dのハウスキーピングは依然として実行され、報告されます)、停止します。

ステップ8 — デイリーノートにリンクする

Daily/<YYYY-MM-DD>.mdの## Claude Sessionsセクション(存在しない場合は作成)に、サマリーファイルへのウィキリンクを追加します。

スケジュール/無人実行: ステップ0〜8を完了して停止します — サマリーを他の場所に投稿する必要はありません。


旅行および出張レポート

  • 識別: ホテル(Marriott、AC Hotels)、フライト、配送(UPS)のメールを追跡します。
  • ワークフロー: (将来)カレンダーをチェックして、これらを1つの「出張レポート」に関連付けます。
  • アクション: 旅行が終了するまで、旅行の領収書/情報をアーカイブしないでください。

応答プロトコル

  • 優先連絡先: (例: HVAC業者)請求書や問い合わせに対して、短く丁寧な返信を下書きします。
  • 安全性: Rickからの明示的な確認なしに、支払いを承認したり、金融リンクをクリックしたりしないでください。

Gmail下書きの作成(添付ファイルあり/なし)

gws CLIは、大きなペイロードをコマンドライン引数として処理できません。代わりに以下のPythonレシピを使用します。これはgws認証情報を直接復号化し、Gmail APIを呼び出します。

テキストのみの下書き:

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

# 新鮮なアクセストークンを取得
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.

...

[翻訳のため省略]

関連スキル