inbox-triage について
inbox-triageは、Gmailの未読メールを優先度別に整理し、まとめて処理するワークフロースキルです。編集可能な判定ルールや一括アーカイブのコマンドに加え、メールを確認する際の注意事項も含みます。
主な機能
- 01未読メールをP1〜P4に分類
- 02編集可能な先着ルールの適用
- 03本文を読む前に要約
- 04優先度別の一括アーカイブ
- 05ドライランと実行確認
活用シーン
- 01Gmailの未読メールを優先順位付け
- 02低優先度メールの一括アーカイブ
- 03プライバシーに配慮した緊急メールの確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ maroffo/ claude-forge --skill inbox-triageインストール後、Claude Code で/inbox-triageを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
pyproject.tomlrules.yamlsrc/inbox_triage/__init__.py__main__.pyclassifier.pycli.pyformatter.pymodels.pytests/__init__.pyconftest.pytest_classifier.pytest_cli.pytest_formatter.pytest_models.py詳細
ABOUTME: Gmail の受信トレイのトリアージ - 未読メールを優先度で分類し、アクションを提案
ABOUTME: 分類と一括アーカイブ用の CLI ツールを備えた P1〜P4 の優先度システム
受信トレイのトリアージスキル
Gmail: アカウント設定とコマンドについては、../_GMAIL.md を参照してください。
ワークフロー
ステップ 1:受信トレイを分類する
gog の検索結果を CLI ツールにパイプします。
gog gmail search "is:unread in:inbox" --json --max=30 [email protected] \
| uv run --project ~/.claude/skills/inbox-triage -- inbox-triage classify
優先度別にまとめた Markdown の概要が出力され、状態が /tmp/inbox-triage-state.json に保存されます。
ステップ 2:ユーザーと確認する
CLI の出力をユーザーに提示します。概要には次の内容が含まれます。
- P1 - 緊急:既知の連絡先からの直接のメッセージ、時間的制約のある内容
- P2 - 重要:仕事関連、読む価値のあるニュースレター、個人的なやり取り
- P3 - 通常:一般的な更新情報、通知
- P4 - 優先度低:プロモーション、ソーシャル、システムによるノイズ
ステップ 3:アーカイブする
一括操作には archive サブコマンドを使用します。
# Dry run (shows commands without executing)
uv run --project ~/.claude/skills/inbox-triage -- inbox-triage archive p3 p4
# Execute
uv run --project ~/.claude/skills/inbox-triage -- inbox-triage archive p3 p4 --yes
ステップ 4:残りの項目に対応する
対応が必要な P1/P2 のスレッドについて:
# Open in browser
gog gmail url <threadId>
# Star for follow-up
gog gmail thread modify <threadId> [email protected] --add=STARRED
# Mark as read without archiving
gog gmail thread modify <threadId> [email protected] --remove=UNREAD
分類ルール
ルールは ~/.claude/skills/inbox-triage/rules.yaml にあります(ユーザーが編集できます)。最初に一致したルールが適用されます。
- 送信者のメールアドレスの完全一致
- 送信者のドメイン一致(
@domain.com) - Gmail のラベル一致
- Gmail のカテゴリによるフォールバック(
CATEGORY_PROMOTIONSなど) - デフォルト(P3)
ルール
- まず要約する - 求められない限り、内容全体を読まないでください
- プライバシーを尊重する - 許可なく個人的なメールの詳細を読まないでください
- 一括操作する - 類似のアクションをまとめてください(プロモーションをすべてアーカイブするなど)
- 破壊的な操作は確認する - ゴミ箱への移動や削除の前に、必ず確認してください
- ブラウザーで開く - ユーザーがメール全体を読めるように、
gog gmail url <threadId>を使用してください
コメント
Markdown 対応