gws-gmail

gws-gmail 技能概览

gws-gmail 技能能做什么

gws-gmail 技能帮助 agent 通过 gws CLI 发送、读取、回复、转发、分拣并监控 Gmail 邮件。它最适合希望把 Gmail 操作当作工作流步骤来处理，而不是塞进一个泛化聊天提示里的用户。如果你是为 Workflow Automation 使用 gws-gmail skill，那么当任务依赖邮箱状态、邮件线程或实时收件箱监控时，这一层最合适。

适用场景与决策因素

当你需要可重复、且 CLI 行为可预测的 Gmail 操作时，使用 gws-gmail。它很适合收件箱分拣、邮件内容提取、草拟跟进回复和通知流。反过来，如果你只是想临时写一封邮件草稿，并不需要账号访问，或者你还没有配置好 gws 二进制和 Gmail 认证，那么它的价值就会明显下降。

它的不同之处

这个技能围绕 +send、+read、+reply、+triage 和 +watch 这类辅助命令来组织，因此比直接发“API 形态”的原始提示更少猜测成本。它也会指向共享的认证与安全层，所以真正的安装决策不只是“能不能发邮件”，而是“我的环境能不能满足全局 gws 要求”。

如何使用 gws-gmail 技能

安装与前置检查

进行 gws-gmail install 时，请使用技能元数据里给出的 CLI 包路径：npx skills add googleworkspace/cli --skill gws-gmail。在正式依赖它之前，先确认 gws 已安装，并先阅读 ../gws-shared/SKILL.md，因为那个共享文件定义了认证、全局标志和安全规则，会影响每一项 Gmail 操作。

如何写出高质量提示

把 gws-gmail usage 请求当作任务规格说明，而不是一个模糊意图。高质量输入应明确动作、目标邮件或邮箱范围，以及你希望得到的结果。例如：“Use gws-gmail to triage unread mail from the last 24 hours and return sender, subject, and date,” 或者 “Use gws-gmail to reply to the latest thread from Alice with a concise confirmation.”

先读哪些文件与工作流

先从 SKILL.md 开始，再查看你需要的具体操作对应的辅助技能文件：../gws-gmail-send/SKILL.md、../gws-gmail-read/SKILL.md、../gws-gmail-reply/SKILL.md、../gws-gmail-reply-all/SKILL.md、../gws-gmail-forward/SKILL.md、../gws-gmail-triage/SKILL.md 和 ../gws-gmail-watch/SKILL.md。同时使用 gws gmail --help 以及命令形式 gws gmail <resource> <method> [flags]，让你的请求与 CLI 的实际 resource-method 模型对齐。

提升输出质量的实用技巧

选择与任务匹配的辅助命令，不要试图用一个提示包办一切。+read 适合提取内容，+triage 适合收件箱摘要，+watch 适合持续流式接收新邮件。需要更精确时，补充线程上下文、发件人标识、日期范围或标签约束，这样 agent 就不必自己猜邮箱范围。

gws-gmail 技能常见问题

gws-gmail 只是用来发邮件的吗？

不是。gws-gmail skill 覆盖读取、回复、转发、分拣和监控邮件，范围比简单的发信封装更广。如果你的任务是邮箱操作，而不只是写邮件，它就是合适选择。

我需要先把整个 Google Workspace CLI 都装好吗？

需要。这个技能默认 gws 生态以及共享的 gws-shared 前置条件都已经可用。如果这些缺失，单独安装 gws-gmail 还不够，无法顺利使用。

什么情况下不该用这个技能？

如果你只需要一封静态邮件草稿、无法访问邮箱，或者想做的不是 Gmail 工作流，就不要用 gws-gmail。对于超出 Gmail 专属线程处理和邮箱管理范围的任务，它也不是好选择。

对新手友好吗？

友好，但前提是你能给出清晰的邮箱任务。这个命令结构本身很直接，只是 gws-gmail guide 在你已经知道要操作哪个收件人、哪个线程或哪一段收件箱内容时，效果最好。

如何改进 gws-gmail 技能

给技能提供正确的邮箱上下文

最能提升质量的一步，就是明确具体的邮件切片：只看未读、指定日期范围、某个发件人、某个线程或某个标签。对于 gws-gmail usage 来说，“find the last message from support and summarize it” 远比 “check my email” 更好。

用对与任务匹配的辅助命令

常见失败模式是把分拣和回复行为塞进一条含糊指令里。更好的做法是把工作流拆开：先 +triage 或 +read，确认目标后再用 +reply、+forward 或 +send。这样能减少回错对象，也能提高线程准确率。

注意认证与线程约束

如果操作失败，问题往往不在提示词本身，而在提示词之外：共享认证缺失、凭据不可用，或线程标识不完整。只要环境已经完成认证，并且你给出的细节足够让 CLI 定位到正确的邮件或对话，gws-gmail guide 的可靠性就会高很多。