用途：为 AI 智能体提供 Gmail 的完整增删改查能力，覆盖搜索、读取、撰写、回复、转发和邮件管理。
主要能力：按 Gmail 查询语法搜索邮件（from、to、subject、label、日期范围等）；读取单封邮件正文、头信息与元数据；读取整个会话线程；创建草稿供用户审阅；直接发送邮件；回复发件人；回复全部（发件人 + To + Cc，排除自己）；带归属头转发；移入/移出回收站；列出标签并为邮件增删标签；列出并下载附件。
前置条件：启用 Gmail API 的 Google Cloud 项目，以及 OAuth 2.0 凭据（gcloud ADC 或 credentials.json）。
使用方式：快速安装可执行 uv run ~/.agents/skills/gmail/scripts/setup_workspace.py。手动方式先执行 gcloud auth application-default login --scopes https://mail.google.com/,https://www.googleapis.com/auth/cloud-platform，再运行 uv run skills/gmail/scripts/gmail.py verify 验证；也可将 credentials.json 放入 ~/.gmail_credentials/ 后运行 uv run skills/gmail/scripts/gmail.py setup。常用命令：search --query、read --id、thread --id、draft、send、reply、reply-all、forward、trash/untrash、labels、modify-labels、attachments --output-dir。所有命令输出 JSON，便于解析。
安全与限制：新建邮件优先使用草稿而非直接发送；reply/forward 默认生成草稿，仅显式要求时才加 --send；回收站操作可逆，未提供永久删除；回复与转发使用正确的 In-Reply-To 和 References 头以保证会话归并。