SuperAPI AI 工具集

email-project-context

办公与效率

查看项目

更新于 10-15 22:41

技能介绍

用途:读取用户自撰的项目与客户背景(context/projects.md),仅把其中被当前 IntentMail 规则架构支持的部分翻译成可审阅的本地邮件规则,预览确认后再创建,绝不把描述性业务背景静默变成自动化。

前提:IntentMail 运行于 Node.js 20 或更高版本,并已连接账号;工作目录需提供 context/projects.md,或从自带的 context/projects.example.md 模板开始。账号须事先通过 mail_auth_start 连接,不得在对话中索要 OAuth 令牌。

主要能力与边界:mail_create_rule、mail_apply_rule、mail_delete_rule 只改动本地 IntentMail 数据库,当前规则引擎不会把这些动作同步到 Gmail 或 Microsoft Graph。优先级指引只作为 AI 上下文,set_priority 不在当前规则架构中。

使用方式:先用 mcp__intentmail__mail_list_accounts 确定账号,多账号匹配时询问;读取 context/projects.md,缺失时指向示例文件而不自行创建或推断;区分描述性上下文与可执行意图,只翻译规则契约中支持的条件与动作;用 mcp__intentmail__mail_list_rules 检查重复或冲突;以自然语言和精确字段(账号 ID、名称、触发器、AND 组合条件、有序动作、启用状态)呈现每条拟议规则,说明这是文本提案而非工具级 dry-run;获得明确确认后调用 mail_create_rule,除非用户明确批准 on_new_email 或定时行为,否则优先手动触发;创建后列出规则,并用 mail_apply_rule 加 dryRun: true 测试,报告匹配与动作数量但不应用更改;仅在另行确认规则、消息范围、上限和本地缓存影响后,才用 dryRun: false;删除前展示规则 ID 与完整定义并获明确确认,删除不可恢复。

验证与输出:只用架构支持的条件字段、运算符、触发器和动作;确认规则属于目标账号且符合已批准提案;正则保持窄范围并在 dry-run 中有界测试;不得声称提供商侧归档、转发、删除或优先级变更。输出应包含来源上下文行、不支持意图、冲突、精确拟议规则、收到的确认、创建/删除的规则 ID、dry-run 范围、匹配数、将发生的本地动作、错误及下一步用户决策。

错误处理:缺少上下文则停止并指向示例文件;不支持的优先级或转发请求保留为上下文或标记不支持,不合成无效规则;发件人、文件夹或账号含糊时询问确切值;重复/冲突规则展示两者并要求选择;dry-run 失败不得改用 dryRun: false 重试;请求提供商侧自动化时说明仅本地限制,不声称提供商邮箱已变更。

资源:支持的规则契约、上下文模板 context/projects.example.md、规则架构 src/types/rule.ts。