Communitygithub.com

richardbowman/agent-skills

個人助理技能,用於 Gmail 收件匣分類、草擬回覆、掃描新聞信以找出興趣內容,以及準備出差報告。負責完整的排程 Gmail 收件匣分類程序(包括 Obsidian「Email Action Items」基礎資料庫)。在管理電子郵件或自動化工作/開發流程時使用。

agent-skills 是什麼?

這項技能將 AI 代理(如 Claude 或 Gemini)轉變為 Rick 個人 Gmail 收件匣和專業工作流程的主動式助理。它是收件匣分類程序的唯一權威來源,並由一個排程的 cron 任務定期調用(每 6 小時,07:00-22:00),以確保一致且自動化的處理。此技能會仔細掃描未讀郵件,在優先處理需要回覆的重要項目(如帳單、安全警示、機會)之前,先封存例行性干擾郵件(如新聞信、部署成功通知)。它會去重複先前執行和現有待辦事項記錄的項目,並根據興趣關鍵字(如自行車、Linux、旅行)總結新聞信內容。值得注意的是,該技能包含一個強大的自動老化機制,可以智慧地關閉因超出收件匣或超過特定時限而不再相關的待辦事項筆記,從而隨著時間推移保持 Action Items Base 的清潔和可管理性。它支援透過 Python 腳本或 gws CLI 進行 Gmail 操作,並且在創建草稿或修改外部狀態之前,需要明確的使用者確認。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 注意事項: 此環境的 shell 是 zsh,而非 bash。for x in $VAR; do 在 zsh 中不會對未加引號的變數進行單詞分割(不同於 bash) — 以這種方式建構的多 ID 迴圈會靜默執行一次,並將整個字串作為 $x。請改用 zsh 陣列:IDS=(id1 id2 id3); for id in "${IDS[@]}"; do ...。此外,status 是 zsh 的唯讀內建變數 — 切勿將 shell 變數命名為 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 中勾選它不會對實際的 Gmail 郵件產生任何作用,直到下一次排程的分類執行將其拾取(每 6 小時,07:00-22:00)。

步驟 0d — 淘汰過時的追蹤項目

待辦事項基礎資料庫只會不斷增長,除非有人主動關閉筆記 — 步驟 0c 需要 Rick 注意到並勾選一個方塊,這難以擴展(到 2026-09-18 為止,它已達到 274 條筆記,其中 253 條仍為 Open,有些來自六週前)。此步驟在每次分類時執行,並在可以安全推斷項目不再活躍時自動關閉筆記,以使基礎資料庫保持為一個可靠的、實際仍需 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 <today's date>:** underlying email no longer in inbox — resolved outside the triage flow. 不要碰觸其電子郵件仍留在收件匣中的筆記;那些仍然需要人工查看。
  4. 對仍存在於收件匣中的筆記,按類別淘汰特定噪音:
    • CI/CD: 如果 first_seen 是超過 5 天前,並且該筆記從未被 Rick 更新為 In Progress/Done,則將其視為過時(CI 失敗總是會被下一次執行或直接查看 repo 所取代 — 一週前的追蹤筆記沒有任何資訊價值)。封存該電子郵件(Jarvis 標籤)並將 status 設為 Dismissed,註明 **Auto-closed <date>:** CI/CD notice unresolved after 5+ days, treated as stale — check the repo directly if still relevant.
    • Appointment: 如果 due_date(或當沒有 due_date 時的 email_date)是過去時間,則約會已經發生或已過期 — 封存電子郵件並用 **Auto-closed <date>:** appointment date has passed. 將其關閉。
    • 歸類為 Other 的運送/送達通知(主旨包含 "package"/"delivery"/"shipped"/"on the way"):如果超過 10 天,則封存並用 **Auto-closed <date>:** shipping window has elapsed. 將其關閉。(更好:根據步驟 5b,在創建時將這些歸類為已關閉,這樣此步驟就不必再處理它們 — 請參閱那裡的說明。)
    • 將 Billing、Security、Compliance、Invoice、Benefits、Opportunity、Solar、SEO 和 Account 保留在此處 — 這些類別可能涉及真實金錢、截止日期或需要判斷的事項,因此僅對它們應用步驟 3 的收件匣存在檢查;切勿根據計時器將它們淘汰。
  5. 在分類摘要(步驟 7)中報告計數,而不是逐項列出 — 例如:Housekeeping: closed 14 stale notes (9 no longer in inbox, 4 aged CI/CD, 1 past-due appointment). 完整的逐項清單不是有用的信號;計數確認了清查已執行。

步驟 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),除非有真正的新資訊。純粹的運送/追蹤通知("your order has shipped")會被報告一次,然後封存 — 在步驟 5b 中創建時,將其追蹤筆記歸類為已關閉(status: Dismissed,archive: true),而不是 Open,因為運送通知不需要後續操作。將這些保留為 Open 正是步驟 0d 後來必須無理由清理的那種筆記。

步驟 5b — 維護待辦事項基礎資料庫

對於在步驟 5 中標記的每個項目,確保其在待辦事項資料夾中作為筆記被追蹤,以便它出現在Email Action Items基礎資料庫中。基礎資料庫檔案已存在 — 請勿重新建立。

  • 根據 gmail_id 去重(步驟 0b)。如果存在具有該 id 的筆記:僅更新 last_run(和 last_seen)為當前執行 — 請勿覆蓋 status(Rick 手動管理它)且請勿重複。如果現有筆記的狀態是 Done 或 Dismissed,則保持其關閉;不要重新開啟或重新標記它。
  • 如果不存在筆記,則創建一個。 檔案名稱:<Sender> - <short subject>.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: <hex id from gws>
gmail_link: https://mail.google.com/mail/u/0/#all/<hex id>
first_seen: YYYY-MM-DD  # 今天
last_run: YYYY-MM-DD-HH-MM
---

正文:一個 H1 標題 # <Sender> — <subject>,一段 1-2 句的所需動作描述,以及一行 **[Open in Gmail](<gmail_link>)**。gmail_link 的 hex id 與 gws 返回的 hex 郵件/討論串 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 章節下新增一個到摘要檔案的 wikilink(如果缺少該章節則建立)。

排程/無人值守執行:完成步驟 0–8 並停止 — 無需將摘要發佈到其他任何地方。


旅行與行程報告

  • 識別:追蹤酒店(Marriott、AC Hotels)、航班和運送(UPS)電子郵件。
  • 工作流程:(未來)檢查日曆以將這些關聯成一個統一的「行程報告」。
  • 動作:在行程結束之前,請勿封存旅行收據/資訊。

回覆協定

  • 優先聯絡人:(例如 HVAC 承包商)為發票或詢問草擬簡短、有禮貌的回覆。
  • 安全:未經 Rick 明確確認,切勿授權付款或點擊財務連結。

建立 Gmail 草稿(有或無附件)

gws CLI 無法將大型負載作為命令列引數處理。請改用下面的 Python 配方,它會直接解密 gws 憑證並呼叫 Gmail API。

純文字草稿:

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

# Get fresh access token
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.

…

[為翻譯而截斷]

相關技能