用途：通过命令行与 Gmail 交互，完成邮件收发、搜索、草稿管理与标签整理。
主要能力：列出和搜索邮件（messages list/get）、标记已读（messages mark-read）、读取完整会话线程（threads get，Google Groups 消息附可分享永久链接）、发送邮件（send，支持抄送、密送、回复线程、从含 YAML frontmatter 的 Markdown 文件发送并将正文转为 HTML 与纯文本多部分）、草稿（drafts list/create/send）、标签（labels list/create），以及配置检查与 OAuth 认证管理（check、auth setup/reset/status）。
安装与用法：依赖 pip install --user google-auth google-auth-oauthlib google-api-python-client keyring pyyaml；用 $SKILL_DIR/scripts/gmail.py check 校验依赖、认证与连通性。认证使用 OAuth 2.0，需创建 ~/.config/agent-skills/google.yaml（或经 auth setup 写入 ~/.config/agent-skills/gmail.yaml）配置 client_id 与 client_secret。命令均以 $SKILL_DIR/scripts/gmail.py 调用，如 messages list --query "is:unread"、send --to ... --subject ... --body ...。
适用场景：批量查看与标记邮件、按 Gmail 搜索语法筛选、回复会话、发送或管理草稿、整理标签。
限制：认证与权限范围错误不可重试，需用户完成浏览器 OAuth 授权；仅限流与 5xx 可短暂等待后重试。各命令读写权限见 permissions.md，搜索语法详见 gmail-queries.md。资料未说明收费与价格信息。