email-query-summarylisted

# 邮箱总结查询助手 (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天」等相对时间时，**建议优先**用脚本内置换算，与下表关键词一致。 1. **关键词**：用 `--period <标准关键词>`，由脚本换算起止再查 IMAP。 2. **明确日期**：用户已给出具体日时，把映射后的 `YYYY-MM-DD` 或 `MM-DD`（缺年由脚本补全）作为位置参数传入。 3. **以脚本输出为准**：拉取成功后，总结里的「周期」与返回 JSON 中 `period.start` / `period.end` 一致。 --- ## 脚本调用方式 **路径约定**：`<SKILL_ROOT>` 指本 skill 所在目录（即本文件 `SKILL.md` 的父目录）。 ``` <SKILL_ROOT>/scripts/main.py ``` **执行要求**： - 使用 `python3` 或 `python`（择 PATH 可用者）+ **脚本绝对路径** + 参数。 - 若已知 skill 根目录，优先使用绝对路径，避免因工作目录不同导致找不到配置。 **示例**（将 `<SKILL_ROOT>` 替换为实际路径）： ``` 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：识别时间描述 | 用户说法 | 传给脚本的参数 | | :--- | :--- | |