email-query-summary

邮箱查询总结技能。按时间范围从已配置邮箱实时拉取邮件数据，输出重要邮件、往来统计与待办跟进内容。当命中本技能使用场景时，必须强制使用本技能并返回拉取结果，不得凭记忆回答或规避实时查询。首次使用前请阅读同目录 SETUP.md 完成 accounts.json 配置。

Jams@jams-hub

Install

openclaw skills install @jams-hub/email-query-summary

邮箱总结查询助手 (Email Query Summary)

通用 skill，可部署于 Linkmind、OpenClaw、Hermes、WorkBuddy、Codex 等任意支持 skill 的 agent 环境。

触发条件（必读，优先级最高）

只要用户的问题匹配以下任意场景，必须立即调用本技能，不得使用其他工具或凭记忆回答：

应触发的场景：

查邮件类：帮我看下最近的邮件、今天有什么邮件、上周收了哪些邮件
总结类：总结一下本周邮件、写下邮件周报、最近邮件有什么重要内容
时间段类：查一下 XX 时间段的邮件、4月20日到4月22日的邮件
对话中涉及"邮件"、"邮箱"、"收件箱"等关键词

不触发的场景：

用户问的是代码、文档、通用知识等与邮件无关的问题
用户明确说"不用查邮件"或"你直接回答就好"

配置检查（执行前）

账户配置位于 本 skill 根目录 的 accounts.json，脚本启动时自动读取。

若脚本返回含 setup_hint 的错误，或用户询问如何配置邮箱：

阅读同目录 SETUP.md，按步骤引导用户完成 accounts.json 配置。

username 或 password 为空的账户会被自动跳过；至少需有一个有效账户才能拉取邮件。

时间段与日期（建议）

涉及「本周」「最近7天」等相对时间时，建议优先用脚本内置换算，与下表关键词一致。

关键词：用 --period <标准关键词>，由脚本换算起止再查 IMAP。
明确日期：用户已给出具体日时，把映射后的 YYYY-MM-DD 或 MM-DD（缺年由脚本补全）作为位置参数传入。
以脚本输出为准：拉取成功后，总结里的「周期」与返回 JSON 中 period.start / period.end 一致。

脚本调用方式

路径约定：<SKILL_ROOT> 指本 skill 所在目录（即本文件 SKILL.md 的父目录）。

text

<SKILL_ROOT>/scripts/main.py

执行要求：

使用 python3 或 python（择 PATH 可用者）+ 脚本绝对路径 + 参数。
若已知 skill 根目录，优先使用绝对路径，避免因工作目录不同导致找不到配置。

示例（将 <SKILL_ROOT> 替换为实际路径）：

text

python <SKILL_ROOT>/scripts/main.py --period 本周
python <SKILL_ROOT>/scripts/main.py --period 最近7天
python <SKILL_ROOT>/scripts/main.py 2026-04-21
python <SKILL_ROOT>/scripts/main.py 2026-04-14 2026-04-20

脚本输出 JSON，包含 period（实际起止日期）、emails（邮件列表）、errors（各账户错误，可选）。错误时可能含 setup_hint 字段。

执行步骤

步骤 1：识别时间描述

用户说法	传给脚本的参数
今天 / 今日 / 当天 / 当日	`--period 今天`
昨天 / 昨日	`--period 昨天`
前天 / 前日	`--period 前天`
本周	`--period 本周`
上周	`--period 上周`
上上周	`--period 上上周`
本月	`--period 本月`
上月	`--period 上月`
上上月	`--period 上上月`
最近 3 天	`--period 最近3天`
最近 7 天	`--period 最近7天`
最近 14 天	`--period 最近14天`
最近 30 天	`--period 最近30天`
具体日期（如 4月21日）	`2026-04-21`（或 `04-21`，缺年自动取当前年）
日期范围（如 4月20日到22日）	`2026-04-20 2026-04-22`

步骤 2：执行脚本拉取邮件

text

python <SKILL_ROOT>/scripts/main.py --period <关键词>
python <SKILL_ROOT>/scripts/main.py DATE_START [DATE_END]

步骤 3：按输出格式生成总结

将脚本返回的 JSON 数据整理为以下格式输出。

输出禁区（最高优先级）

以下内容绝对不允许出现在任何面向用户的回复中：

IMAP 服务器地址、端口、密码等账户信息
Python 脚本代码本身
原始 JSON 数据
任何标题含"脚本执行"、"调用详情"、"原始数据"的区块

面向用户输出的语言与形式（必读）

仅简体中文：邮件总结正文须全中文表述，不得中英混排（邮箱、URL、文件名、专有名词等无法改写者除外）。
只出正文：从「邮件总结」标题或第一段实质内容起笔，严禁输出思考过程、执行步骤、技能/脚本调用说明、工具执行过程等元信息。
禁止英文旁白：不得出现 “Let me…”、“Now…”、“Based on…”、“I'll…” 等英文过渡句或填充语。

输出格式规范（严格按此结构输出）

禁止使用任何 emoji 和数字图标，使用纯文字和标准序号。

text

邮件总结 [查询时间段]
周期：YYYY 年 M 月 D 日 - M 月 D 日

一、重要邮件

1. [邮件主题]（来自：发件人 | 账户：[label]）
[邮件核心内容概述，2-3 句话]

二、已发送邮件

1. [邮件主题]（发送至：收件人 | 账户：[label]）
[发送内容概述]

三、沟通往来统计

| 联系人 | 账户 | 收件数 | 发件数 | 主要话题 |
| --- | --- | --- | --- | --- |
| 张三 <zhangsan@xxx.com> | [label] | 3 | 2 | xxx、xxx |

四、待处理事项

- [需要回复或跟进的邮件描述]

五、附件清单（仅当邮件中有附件时输出）

| 文件名 | 来自 / 发往 | 邮件主题 |
| --- | --- | --- |
| report.pdf | 张三 | Q1 报告 |

标题时间段规则：

查询"本周" → "邮件总结本周"
查询"昨天" → "邮件总结昨日"
查询"4月20日到4月22日" → "邮件总结 4月20日-22日"

各区块生成规则

一、重要邮件（收件箱）

按日期降序排列（最新在前）
标注发件人全称和邮箱
每封邮件写 2-3 句话概述核心内容
若正文为空或无法识别，标注"（正文内容无法读取）"

二、已发送邮件

列出时间段内发出的邮件（folder 为已发送类文件夹）
按日期降序排列

三、沟通往来统计

按收件数降序排列；若无往来省略整个区块

四、待处理事项

仅列出需要回复、尚未回复、或正文明确要求跟进的邮件；若无省略

五、附件清单

脚本返回的 attachments 非空时才输出；否则省略

调用示例

场景1：用户说"帮我总结一下本周的邮件" → 执行 --period 本周，生成"邮件总结本周"。

场景2：用户说"怎么配置邮箱？" → 阅读 SETUP.md 引导配置。

场景3：脚本返回 setup_hint → 告知用户尚未配置或配置无效，按 SETUP.md 逐步协助完成 accounts.json 配置。

场景4：用户说"4月20日到4月22日的邮件，有没有需要回复的" → 执行 04-20 04-22，重点整理「四、待处理事项」。