mcpField
I
inbox-triage

inbox-triage

github.com/maroffo生产力1738 次安装4 周前更新
代码仓库

关于 inbox-triage

inbox-triage 是用于整理 Gmail 未读邮件的工作流技能，可按优先级分类并批量处理邮件。它结合可编辑的匹配规则、归档命令和邮件审阅注意事项。

主要功能

  1. 01将未读邮件分为 P1–P4
  2. 02应用可编辑的优先匹配规则
  3. 03先汇总，再阅读邮件全文
  4. 04批量归档指定优先级邮件
  5. 05支持试运行和操作确认

适用场景

  1. 01整理 Gmail 未读邮件的优先级
  2. 02批量归档低优先级邮件
  3. 03兼顾隐私地处理紧急邮件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/maroffo/claude-forge --skill inbox-triage

安装后在 Claude Code 中输入/inbox-triage确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

pyproject.toml
rules.yaml
src/inbox_triage/
__init__.py
__main__.py
classifier.py
cli.py
formatter.py
models.py
tests/
__init__.py
conftest.py
test_classifier.py
test_cli.py
test_formatter.py
test_models.py

详细介绍

ABOUTME: Gmail 收件箱分流 - 按优先级分类未读邮件并建议操作

ABOUTME: P1-P4 优先级系统，提供用于分类和批量归档的 CLI 工具

收件箱分流技能

**Gmail：**有关账户配置和命令，请参阅 ../_GMAIL.md。

工作流

第 1 步：分类收件箱

将 gog search 的输出通过管道传递给 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（用户可编辑）。匹配第一条规则后即停止：

  1. 发件人邮箱地址完全匹配
  2. 发件人域名匹配（@domain.com）
  3. Gmail 标签匹配
  4. 回退到 Gmail 类别（CATEGORY_PROMOTIONS 等）
  5. 默认值（P3）

规则

  1. 先总结 - 除非用户要求，否则不要阅读完整内容
  2. 尊重隐私 - 未经许可，不要详细阅读私人邮件
  3. 批量操作 - 将相似操作归为一组（例如，归档所有促销邮件）
  4. 确认破坏性操作 - 清空或删除前务必确认
  5. 在浏览器中打开 - 使用 gog gmail url <threadId>，供用户阅读完整邮件

评论

支持 Markdown