inbox-triage

inbox-triage skill 概览

inbox-triage 的作用

inbox-triage 是一个面向邮件工作流自动化的 skill，可基于现有的个人邮件知识库，执行结构化的收件箱复盘。它会搜索近期邮件，按你的分类体系对消息归类，识别新发件人，推荐处理动作，起草回复，并将本次 triage 中学到的规则写回 ${WORKSPACE}/Email/。

采用它时最重要的一点是：它需要和 inbox-setup 配套使用。inbox-triage skill 依赖 setup 创建的 7 个知识库文件与目录，包括 email-taxonomy.md、email-patterns.md、blocklist.md、tracker.md、可选的决策文件，以及 triage-log/ 目录。

最适合的用户和工作流

这个 skill 适合希望每天固定 1–3 次处理收件箱，或希望随时可靠地执行“帮我检查邮箱”流程、且不想每次都重新说明偏好的用户。它尤其适合创始人、顾问、创作者、运营人员以及忙碌的专业人士——他们的邮箱里往往混有机会线索、进行中的会话、newsletter、冷邮件和跟进事项。

当目标不只是总结邮件，而是需要决策支持时，可以将 inbox-triage 用于 Workflow Automation：分类、推荐、起草、记录，并更新记忆。

关键差异点

它最实际的差异点在于安全优先的自动化模型。这个 skill 只创建草稿，并明确绝不发送邮件。仓库包含 references/drafts_only_safety.md 和 scripts/draft_safety_validator.py，后者会检查 action log 中是否出现类似发送邮件的工具调用。

它还包含确定性的辅助脚本：kb_reader.py 会在 triage 前校验必需的知识库，search_window_calculator.py 会根据执行频率计算回溯搜索窗口。

不适合使用这个 skill 的情况

如果你还没有运行 inbox-setup，也没有创建预期的 ${WORKSPACE}/Email/ 文件，就不要把 inbox-triage 当作独立 prompt 安装使用。若你想要完全自主发送邮件、只是偶尔做一次轻量邮件摘要，或希望系统忽略你的个人分类体系和回复风格，它也不适合。

如何使用 inbox-triage skill

inbox-triage 安装上下文

从 GitHub skill repository 安装该 skill：

npx skills add alirezarezvani/claude-skills --skill inbox-triage

然后确认你的 agent 可以访问 skill 路径：

productivity/email/skills/inbox-triage

首次运行前，先查看 SKILL.md，再阅读 references/kb_file_contract.md、references/drafts_only_safety.md 和 references/triage_decision_framework.md。若要了解校验行为，请检查 scripts/kb_reader.py、scripts/search_window_calculator.py 和 scripts/draft_safety_validator.py。

使用前所需输入

这个 skill 需要一个包含 ${WORKSPACE}/Email/ 的 workspace。至少需要以下文件：email-taxonomy.md、email-patterns.md、blocklist.md 和 tracker.md；同时必须存在 triage-log/ 目录。evaluation-framework.md 和 rate-card.md 可提升机会判断、定价、VIP 和 pass/take 信号的决策质量。

如果 KB 缺失或格式不正确，预期行为是立即停止，并提示用户先运行 /cs:inbox-setup。这种 fail-fast 机制可以防止 agent 凭空编造 triage 规则。

更适合调用该 skill 的高质量 prompt

较弱的 prompt 是：“Check my email.”

更好的 inbox-triage 使用 prompt 是：“Run inbox-triage for my normal 2x-daily cadence. Use my existing ${WORKSPACE}/Email/ knowledge base, search only the current window, classify new messages, draft replies but do not send anything, update tracker.md and blocklist.md where appropriate, and give me the report in my preferred format.”

对于临时按需运行，可以加入覆盖条件：“Run inbox-triage for the last 24 hours because I missed the morning pass. Do not skip opportunity emails. Draft replies only.”

首次运行的实用流程

第一次建议采用受监督的 dry run。让 agent 先校验 KB、计算搜索窗口、列出计划使用的分类，并确认不会使用任何发送动作。之后再让它处理邮件、创建草稿并生成 triage 报告。

拿到报告后，重点检查三件事：被误分类的邮件、听起来不像你的草稿，以及写入 tracker.md 或 blocklist.md 的任何更新。这些修正的杠杆很高，因为后续运行都依赖这个知识库。

inbox-triage skill 常见问题

inbox-triage 会发送邮件吗？

不会。核心安全规则是只生成草稿。这个 skill 的设计目标是为用户审阅起草回复，而不是发送邮件。随附的 validator 可以扫描 triage action log，检查是否存在类似发送的操作，例如 Gmail 或 Outlook 的 send call；一旦出现，就让运行失败。

它比普通邮件 prompt 好在哪里？

通用 prompt 可以总结邮件，但通常缺少稳定记忆、发件人规则、执行频率窗口、草稿安全纪律和可复用的推荐框架。inbox-triage skill 会读取明确的 KB contract，使用分类体系，应用 TAKE IT / WORTH CONSIDERING / PASS / FLAG FOR REVIEW 决策，并记录结果。

inbox-triage 适合新手吗？

完成 setup 之后，它对新手是友好的。如果你能运行 skill installer，并允许 agent 访问邮件工具和 workspace 文件，那么日常调用很简单。最初的门槛在于它依赖 inbox-setup，并且要求精确的 ${WORKSPACE}/Email/ 文件结构。

它支持哪些邮件生态？

这个 skill 是围绕邮件工具行为编写的，而不是绑定某一个服务商。安全参考中提到了 Gmail 和 Outlook/Microsoft Graph 的草稿类操作。实际能否顺利使用，取决于你的 agent 环境是否具备邮件搜索、读取和创建草稿的权限，同时没有发送权限。

如何改进 inbox-triage skill

通过更好的 KB 文件提升 inbox-triage 效果

提升 inbox-triage 最快的方法，是让 email-taxonomy.md 和 email-patterns.md 更具体。加入应跳过的 newsletter 示例、需要优先浮现的 VIP、值得考虑的机会，以及需要当天回复的 thread。也可以加入语气规则，例如“简短、温和、不使用感叹号”，或“只有对方询问时才包含价格”。

如果机会 triage 很重要，请维护 evaluation-framework.md 和 rate-card.md。这些文件能减少含糊的“maybe”建议，并帮助草稿包含具体的下一步、定价立场或澄清问题。

修正常见失败模式

如果这个 skill 生成了过多草稿，请收紧 PASS 信号和 blocklist 规则。如果它漏掉了重要会话，请扩展活跃对话信号和 VIP 条目。如果草稿过于泛泛，请在 email-patterns.md 中加入真实的已接受和已拒绝回复示例。

如果搜索窗口不对，请检查 search_window_calculator.py 使用的执行频率值：每天一次会使用更宽的重叠窗口，而每天 2 次和 3 次会使用较短窗口。对于不常见的补处理场景，请提供明确的小时数覆盖条件。

在首次报告后持续迭代

每次运行后，标记哪些推荐是正确的、哪些草稿你编辑后发送了、哪些邮件本应跳过。让 agent 把这些反馈转化为 KB 更新，而不是只把它当作一次性的聊天上下文。

一个有用的 follow-up prompt 是：“Review the last inbox-triage report. Update my taxonomy so emails like X are classified as PASS, add sender Y to VIP, and adjust my draft style to be shorter for cold outreach. Do not change send safety rules.”

让安全和日志保持可执行

用于定时运行时，请在 prompt 和日志中保持 drafts-only 规则可见。如果你的环境支持 action log，可以运行或检查 draft_safety_validator.py。保持 triage-log/ 有序，因为它提供了审计线索：搜索了什么、起草了什么、跳过了什么，以及学到了什么。