# Google Workspace

> 使用 `google_workspace` 工具安全地访问和操作 Gmail、Drive、Calendar 与 Docs 等 Google Workspace 资源。

- Skill: `ttawdtt/google-workspace` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add ttawdtt/google-workspace`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ttawdtt/google-workspace/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- License: MIT
- Author: ttawdtt (https://skillmd.com/u/ttawdtt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ttawdtt/google-workspace

---


# Google Workspace Skill for DeepAgents

本技能文件向 DeepAgents 说明如何通过 `google_workspace` 工具与用户的 Google 账号交互。

## 能力概览

- 读取 Gmail 邮件列表与邮件内容。
- 读取 Google Drive / Docs / Sheets / Slides 元数据。
- 在写权限开启时，可以执行写操作（例如创建文档、发送邮件等），但需要遵守安全策略。

## 使用约定

1. 所有操作都通过 `google_workspace` 工具完成，使用 `action` 字段区分具体功能：
   - 读能力示例：
     - `auth_status`：检查认证与 scope。
     - `gmail_list` / `gmail_get`：列出或读取邮件。
     - `drive_list`：列出 Drive 文件。
   - 写能力示例（仅在 Aelin 策略允许时使用）：
     - `docs_create`：创建 Google 文档。
     - 后续可能扩展的 `gmail_send`、`calendar_create_event` 等。

2. 在尝试写操作前，应先调用 `auth_status` 检查：
   - 用户是否已登录。
   - 是否具备所需 scope（如 `documents`、`drive` 等）。

3. 写操作需要遵守以下原则：
   - 只在用户明确要求时创建或修改内容（例如「帮我创建一个 Google 文档」）。
   - 文档、事件、邮件的标题与内容应简洁、可读，并用用户的语言回答。

4. 如果出现权限不足或配置错误：
   - 工具会返回 `ok: false` 和 `error` 字段。
   - 应向用户解释无法完成的原因，并给出下一步建议（例如要求用户在本地完成登录）。