Gmail 自動分類打標籤(Zero Box)
用途
依預定分類規則自動掃描最近 N 小時的未讀郵件,打上對應 Gmail 標籤,讓收件匣達到 Zero Inbox 狀態,不需要每封手動分類。
何時用
- 適合:每日郵件量大(20 封以上)、訂閱多份電子報混在重要信件中、想用標籤系統聚焦重要郵件的使用者。
- 不要用:尚未定義好分類規則時不要用——沒有 labels-rules.md 規則檔,AI 不知道怎麼分;或者你的郵件量本來就少(每天 5 封以下),手動分類更快,不需要這套自動化。
Prompt
text
請執行 Gmail Zero Box 分類流程:
1. 讀取分類規則檔:{{labels-rules.md 路徑}}
規則格式:每行「標籤名稱 | 條件(寄件者/主旨關鍵字/域名)」
2. 用 Gmail MCP 搜尋最近 {{N}} 小時、尚未打標籤的未讀郵件
搜尋條件:newer_than:{{N}}h is:unread -has:userlabels
3. 對每封郵件依規則層級比對(依重要性從高到低):
- 比對成功:打對應標籤(如 client/action/newsletter)
- 多條件同時符合:打最高優先層級的標籤
- 無符合規則:打「未知/待分類」標籤,並 append 到 {{unknowns-log 路徑}}
4. 輸出執行摘要:
已分類 X 封(各標籤明細)/ 新增未知 Y 封(列出寄件者)/ 跳過已處理 Z 封
如果 Gmail MCP 連線失敗,記錄錯誤並提示我手動確認 MCP 連接器狀態。範例 / 變體
- 填好變數:
{{N}}填24(掃過去 24 小時);{{labels-rules.md}}填你的規則檔路徑;{{unknowns-log}}填~/Documents/gmail-unknowns.log。 - 變體(輕量版,只看重要信):把步驟 2 搜尋條件改成只搜「有特定關鍵字的信(如 contract/invoice/urgent)」,縮小範圍,適合已有 Gmail filter 但想補強分類的人。
- 變體(Slack 推送版):在輸出摘要後加「把『client/action』標籤的信件清單推送到 Slack #inbox 頻道」,讓重要信在 Slack 也能看到。
🎯 範例輸出(實測)
在 Claude Code 跑這句、把
{{變數}}填成「N:24;labels-rules.md:~/.claude/gmail-rules.md;unknowns-log:~/Documents/gmail-unknowns.log」的結果:
點開看 AI 實際輸出
步驟 1 — 讀取規則檔
載入 ~/.claude/gmail-rules.md,識別出 6 條規則:
text
client/action | from:@usl.com.tw OR subject:合約 OR subject:發票
client/action | from:@cht.com.tw
newsletter | from:@tldr.tech OR from:@lennysnewsletter.com
bill/finance | subject:請款 OR subject:付款通知 OR from:@ecpay.com.tw
github | from:notifications@github.com
internal | from:@cloud-f1.com步驟 2 — 掃描最近 24 小時未讀未分類郵件
找到 18 封未分類郵件。
步驟 3 — 分類結果
client/action→ 3 封(USL 振川:出貨確認、CHT 培訓合約 PDF、發票請款)newsletter→ 7 封(TLDR AI x4、Lenny x2、The Rundown x1)bill/finance→ 2 封(ECPay 月結通知 x2)github→ 4 封(PR review 通知)- 未知/待分類 → 2 封(已 append 到 ~/Documents/gmail-unknowns.log)
未知清單(新增 2 封)
noreply@calendly.com(主旨:您有新的預約)no-reply@stripe.com(主旨:Stripe payout sent)
執行摘要
已分類 16 封 / 新增未知 2 封 / 跳過已處理 0 封
💡 實測心得:規則檔的寄件者條件用「域名」比「完整 email」穩定,因為大公司可能從不同子網域發信;「未知/待分類」標籤要定期回頭看,把高頻未知寄件者加進規則,分類率會越來越高。
延伸
簡單來說,Zero Box 最重要的前置工作是把分類規則檔整理好——先列出你最常收到的 10 種信(電子報、客戶信、廠商發票、GitHub 通知等),每種定義一個標籤和比對條件,規則檔有了,這個提示語才能發揮效果。
跑通之後,可以把這個流程存成 Skill 配合每日晨報一起觸發,讓你開工時收件匣已經是整理好的狀態。