SuperAPI AI 工具集

gmail-extract-and-act

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

这是一个把邮箱当作队列而非档案库的工作流技能:从邮件主题、正文和附件中抽取结构化数据,将抽取结果提交到指定仓库,并用 Gmail 标签跟踪线程状态,主题完结后删除原始邮件。

用途与流程:入站邮件先经 triage 扫描分类,再抽取结构化数据(如 CRE 房源、客户项目、租户沟通、税务财务、发票付款等模板字段),通过 legal-scan 后提交到仓库,随后打标签跟踪状态,主题解决即删除邮件;若收到新回复则重新激活为入站状态。

状态模型与删除策略:使用标签 inbox(无标签)、wh-email/extracted、wh-email/awaiting-reply、wh-email/completed、wh-email/noise 表示状态,并用本地状态日志 ~/.hermes/email-state.yaml 作为权威状态记录。completed 线程有 7 天宽限期后删除,noise 立即删除,awaiting-reply 永不自动删除;宽限期内收到新回复则状态回退并重置计时。

路由配置:scripts/email/email-routing.yaml 将发件人域名映射为仓库路径、DELETE 或 REVIEW;抽取脚本按域名匹配规则,DELETE 直接删除、REVIEW 标记待人工审核、仓库路径则抽取并提交。

必要前提:OAuth 令牌位于 ~/.gmail-{account}/credentials.json,客户端凭据位于 ~/.gmail-mcp/oauth-env.json,需配置 gmail-multi-account 技能与 email-routing.yaml。

限制:不得把完整邮件正文存档到仓库,只抽取结构化数据;法律扫描必须在 git add/commit 之前执行;不得自动删除可能收到回复的线程;Gmail 标签区分大小写;OAuth 令牌约每小时过期;首次实施时对不确定的删除应设为 REVIEW。其余细节(如线上服务、收费、平台支持)暂未提供。