Google Workspace Agent Skills
让 Agent 通过 gws 技能安全调用 Gmail、Drive、Calendar、Docs、Sheets 和 Chat 等 Workspace 服务。
技能说明
适合办公自动化和个人生产力。仓库同时包含只读查询与发送、上传、写入等有副作用的技能；需要 Google OAuth，使用发送邮件、上传文件或修改日历等动作前必须确认权限和目标。
关于此技能
官方 Google Workspace CLI 与 Agent Skills 集合，通过 gws 统一调用 Gmail、Calendar、Drive、Docs、Sheets、Chat、Meet、Tasks 和工作流命令。
核心能力
Workspace 服务覆盖
提供 Gmail、Calendar、Drive、Docs、Sheets、Chat、Meet、Tasks 等服务技能。
常用工作流
提供收件箱整理、日历议程、会议准备、邮件转任务、文件公告和周报等助手流程。
Model Armor 支持
README 提供通过 Model Armor 对提示和响应进行清理的可选配置。
适用场景
只读办公查询
例如用 gws gmail +triage 查看未读邮件摘要，或用 Calendar agenda 查看日程。
跨服务自动化
把邮件、日历、Drive 和 Sheets 连接成可重复的工作流。
使用步骤
- 01
第一步：安装
运行 npm install -g @googleworkspace/cli 安装 gws，并按需运行 gws auth setup 完成 Google OAuth。
- 02
第二步：选择技能
按需加载 skills/gws-*，先从只读技能开始。
- 03
第三步：确认权限
发送邮件、上传文件、写入文档或修改日历前，核对账号、目标和 OAuth 范围。
- 04
第四步：执行并复核
运行 gws 命令，检查 JSON/NDJSON 结果和实际 Workspace 状态。
常见问题
只读技能和写入技能一样吗？+
不一样。gws-gmail-triage 明确是只读，但仓库也提供发送邮件、上传 Drive、写 Docs 和创建日历事件的技能。
需要 API 密钥吗？+
README 以 Google OAuth 和凭据文件/环境变量为主；具体权限由 Google 账号授权范围决定。
安全吗？+
仓库有 SECURITY.md，安全问题通过 Google 的 g.co/vulnz 报告；实际使用仍应遵循最小权限并逐次确认副作用操作。
npm install -g @googleworkspace/cli && gws auth setup