GWS Slides Skill 技能

技能简介

GWS Slides 是 Google Workspace 官方组织发布的幻灯片操作技能，属于 Skillstore silver 银牌层，质量分 80。它解决的是「用 API 操作 Google Slides 非常繁琐」这个具体障碍：直接调用 Slides API 时，演示文稿、页面、文本样式等对象的层级关系和字段含义都不直观，参数一旦填错就整批失败。该技能把整套命令流程与 schema 探查动作编排好，让 AI 助手先看清可用方法与参数类型，再生成合规的调用，从而稳定完成建稿、拉取、批量改稿这类演示文稿自动化工作。

核心能力

1. 创建指定标题的空白 Google Slides 演示文稿，并返回演示文稿标识符。
2. 按标识符拉取演示文稿的最新版本，获取当前页数与结构状态。
3. 通过 batchUpdate 批量接口下发经过校验的演示文稿改动，一次请求完成多处修改。
4. 发现演示文稿页面层面可用的操作方法，知道哪些能力可以被调用。
5. 用 gws schema 命令查看每个方法的参数、类型与默认值，避免凭感觉猜参数名。
6. 依据文档化的参数与请求体结构，直接生成可执行的 gws CLI 调用。

安装配置

1. 一条命令安装：npx skillstore add googleworkspace/gws-slides，装好后即可在 Claude、Codex、Claude Code 中调用。
2. 需要预先准备 gws 命令行工具，并按其共享认证说明完成 Google 账号登录。
3. 访问权限完全取决于已认证账号对该演示文稿的权限，分享范围不足时接口会直接拒绝。
4. 建议为演示文稿建立统一的命名与目录约定，便于自动化任务定位目标文件。

使用步骤

1. 先做 schema 探查：用 gws schema 查看目标方法支持的参数、类型与默认值，再决定怎么构造请求。
2. 创建演示文稿并记下标识符，若目标文稿已存在则直接使用已有标识符。
3. 拉取最新版本确认当前结构与页面数量，避免在过期快照上改稿。
4. 把相关改动整理成有序的批次，一次 batchUpdate 请求提交，减少往返次数。
5. 提交后重新拉取一次，核对改动是否按预期落地，是否有字段被忽略。
6. 若整批失败，按字段逐条拆开重试，定位到具体是哪一个参数不合法。

适用场景

1. 项目汇报材料准备：批量创建空白演示文稿并同步项目最新状态，便于多角色协同更新。
2. 幻灯片内容自动化修订：把结构化数据渲染进既定版式，按顺序提交经过校验的批量改动。
3. Slides API 集成探索：在真正写集成代码前，先摸清可用资源、方法参数与默认值。
4. 模板化周报月报：固定模板 + 数据填充，批量生成周期性汇报材料。

适用人群

适合 Google Workspace 重度用户、演示文稿自动化需求方，以及希望在 AI 助手里直接操作在线文档而不用手动排版的团队。

工作原理

技能通过 gws 命令行把 Google Slides 的 REST 接口包装成可被 AI 理解的命令族，核心机制是「先探查 schema、再构造请求」。它不猜测参数名，也不把创建接口当作填充内容的捷径——创建只产出空白稿并忽略传入内容，正文必须靠后续 batchUpdate 写入；页面级方法同样要求先完成 schema 探查。安全审计显示 12 项静态发现均为 Markdown 反引号与散文措辞引起的误报，未发现恶意命令构造或数据外传行为。

官方链接

• 技能主页：https://skillstore.io/skills/googleworkspace-gws-slides
• 源码仓库：https://github.com/googleworkspace/cli
• 清单文件：https://skillstore.io/api/skills/googleworkspace-gws-slides/manifest
• 开源许可证：MIT