用途:把一次限定范围的邮件审阅转化为明确的邮件服务商操作,并为每封邮件提供回执。计划本身是人类可读的预览;mail_action 没有 dry-run 标志,因此在用户确认具体操作和邮件之前不要调用。
前提:在 Node.js 20 或更高版本上运行 IntentMail;通过 IntentMail OAuth 连接目标 Gmail 或 Outlook 账户;请求生成草稿前需配置 AI 提供商。
认证与隐私:账户须经 mail_auth_start 连接,切勿在聊天中索取 OAuth 凭据或 AI 密钥。服务商操作使用用户的 Gmail 或 Microsoft Graph 令牌,OAuth 令牌与缓存保留在本地。云端 AI 提供商会收到用于生成草稿的内容,Ollama 可保持本地推理。本技能不允许任何发送工具。
工作流:仅在未提供候选邮件时调用 mcp__intentmail__mail_daily_digest,并限定账户、时间窗口和条目数量。展示计划,包含每封本地邮件 ID、主题、请求操作、服务商影响、本地影响和已知可逆性,不要用“全部清理”之类措辞隐藏批量范围。获得对该确切计划的明确确认;范围或操作变更需重新确认。对标记已读/未读、归档、标记/取消标记或移动,逐封调用 mcp__intentmail__mail_action 并记录 newState。回复则调用 mcp__intentmail__mail_draft,它只生成草稿文本,不创建 Gmail/Outlook 草稿也不能发送,返回文本供用户审阅,不得暗示已远程保存。删除请求调用 mcp__intentmail__mail_stage_delete 并设 backupMime: true,用 mcp__intentmail__mail_list_staged 审阅后停止;暂存仅在本地,永久服务商删除未实现也不允许,可用 mcp__intentmail__mail_unstage 取消。逐项报告成功与失败,结果不明确时不要盲目重试。
审批边界:读取可在用户声明范围内构建摘要;每个确切计划确认一次状态标记、归档、标记或移动;本地暂存前确认并展示每封被选邮件。不允许:发送邮件、提交本地删除、服务商删除、扩大批量范围,或声称直接操作会产生审计/回滚回执。
验证:将每个结果的邮件 ID 和操作与已批准计划匹配;直接操作以成功加返回的 newState 作为回执,不要声称所有直接操作都在规则审计日志中;返回前确认生成的草稿文本不含虚构收件人、承诺或附件;用 mail_list_staged 核对暂存数量和 ID,切勿将暂存等同于服务商删除。
输出:返回已批准范围、每封邮件操作、服务商/本地影响、newState 回执、待审阅草稿文本、暂存 ID 与保留期、失败、不明确结果,以及仍需手动在服务商侧完成的步骤。
错误处理:未认证则停止并引导用户走显式 OAuth 流程;服务商结果不明确或部分成功则停止该项并报告,不要假设失败或成功;不支持的发送/删除/退订请求需说明当前边界,合并工具的退订操作目前仅归档,本技能不将其表述为退订;草稿不佳则丢弃输出并要求更正事实或语气,绝不发送或声称存在服务商草稿;暂存项错误则先取消暂存。
示例:对账户 1 展示拟归档的五封新闻邮件,等待确认后逐封归档并报告每个 newState;为邮件 42 生成简洁专业语气的回复文本,不保存不发送,返回草稿及不确定事实供审阅。
资源:操作安全契约;服务商操作实现 src/connectors/email-actions.ts;删除暂存 src/storage/services/deletion-staging.ts。