名称： email-summary
描述： 从 Gmail 获取近期邮件并提供简洁摘要。当用户需要查看邮件、获取邮件摘要或检视收件箱时使用。
主页： https://github.com/yourusername/email-summary-skill
user-invocable: true
元数据：
openclaw:
requires:
bins:
- python3
env:
- GMAIL_CREDENTIALS_PATH
os:
- darwin
- linux
- win32

邮件摘要技能

此技能可从您的 Gmail 账户获取近期邮件，并提供基于 AI 的摘要。

工作原理

当调用此技能时，它将执行以下步骤：

1. 使用 Gmail API 进行身份验证：通过 $GMAIL_CREDENTIALS_PATH 路径下的凭证文件完成。
2. 获取近期邮件：默认获取最近 10 封未读邮件。
3. 为每封邮件生成摘要，内容包括：
   - 发件人与主题
   - 邮件正文的关键要点
   - 建议的操作或回复
4. 以清晰易读的格式呈现结果

代理操作指南

当调用此技能时，请按以下步骤操作：

1. 首先，确认环境变量 $GMAIL_CREDENTIALS_PATH 指定的路径下存在 Gmail API 凭证文件。
2. 运行位于 {baseDir}/scripts/fetch_emails.py 的辅助脚本，并传递相应参数：
   - 默认情况：python3 {baseDir}/scripts/fetch_emails.py --count 10
   - 带参数情况：python3 {baseDir}/scripts/fetch_emails.py $ARGUMENTS
3. 解析脚本输出的 JSON 数据。
4. 为每封邮件提供简洁摘要，包括：
   - 发件人：发件人姓名与邮箱地址
   - 主题：邮件主题行
   - 摘要：2-3 句话概括关键要点
   - 建议操作：如回复、归档、标记待跟进等
5. 将所有摘要以格式清晰的列表形式呈现。

使用示例

/email-summary

获取并摘要最近 10 封未读邮件。

/email-summary --count 20

获取并摘要最近 20 封未读邮件。

/email-summary --all

获取并摘要所有未读邮件。

环境要求

使用此技能前，请确保：
- 已配置 Gmail API 凭证
- 环境变量 GMAIL_CREDENTIALS_PATH 指向您的凭证 JSON 文件
- 已安装 Python 3 及所需依赖包（详见 README.md 中的安装指南）