gws-slides

gws-slides 技能概览

gws-slides 是 googleworkspace/cli 里用于 Google Slides 的技能，借助 gws CLI 读取和写入演示文稿。它最适合需要检查某个 deck、创建新 deck，或在不手动打开浏览器里的 Slides 的情况下做结构化修改的 agent。如果你的任务是“根据提示安全地更新这个演示文稿”，gws-slides 就是合适的起点。

gws-slides 技能的核心价值在于，它把 Slides API 置于命令式工作流中暴露出来，而不是默认认为一段通用提示就能猜对请求结构。这一点很重要，因为演示文稿更新往往对 schema 很敏感：标题、ID、页面资源和批量操作都需要参数正确，否则整个操作可能失败。这个技能也把前置条件说得很明确：你必须先准备好共享的 gws-shared 配置，才能使用认证、全局标志和安全规则。

gws-slides 适合做什么

当你需要基于 API 执行操作，比如创建演示文稿、获取当前状态，或者对页面和其他演示资源进行批量更新时，可以使用 gws-slides 来处理 Slide Decks。它比一次性的文案写作更适合自动化、可重复的编辑流程，以及由 agent 驱动的维护任务。

什么时候它最合适

如果你已经确定要在 Google Workspace CLI 生态里工作，并且能提供具体的 deck ID、标题或编辑目标，那么就应该选择 gws-slides。它特别适合需要确定性修改的场景，而不只是对幻灯片内容给出建议。

需要先了解的主要限制

这个技能本身并不是一个“从零帮你设计演示文稿”的系统。你仍然需要把目标转换成合法的 Slides API 请求；对于超出基础发现之外的任何操作，通常都应该先查看 method schema 再动手。如果你更需要的是视觉排版策略，而不是 API 执行，通用提示词方式可能更省事。

如何使用 gws-slides 技能

正确安装 gws-slides

安装 gws-slides 时，使用仓库提供的 CLI 包流程：npx skills add googleworkspace/cli --skill gws-slides。安装完成后，检查 SKILL.md 里提到的前置条件：../gws-shared/SKILL.md 必须存在，才能正常使用认证和共享规则。如果这个文件缺失，仓库会要求你运行 gws generate-skills。

先读对文件

先从 skills/gws-slides/SKILL.md 开始，再读它引用的共享技能文件。最快的顺序是：

1. SKILL.md：查看命令格式和资源列表。
2. ../gws-shared/SKILL.md：查看认证和安全约束。
3. gws slides --help：查看可用的资源和方法。
4. 在真正发起请求之前，先运行 gws schema slides.<resource>.<method>。

这个顺序能避免最常见的失败方式：把错误的字段发给了一个本来合法的方法。

把模糊目标改写成可执行的提示

高质量的 gws-slides 请求要把 resource、method 和结果说清楚。不要只说“帮我修一下幻灯片”，而应该说：“请用 gws-slides 检查 deck abc123 的 presentations.get 输出，然后给出一个 batchUpdate 方案，把标题改名并更新第一页文字。”要包含 deck 标识、具体修改内容，以及任何约束，例如保留现有布局或避免删除内容。

先从 schema 推导命令

这个技能的工作流是先 schema、后命令。先用 gws schema 找出必填参数、对象结构和默认值，再把你的目标映射到 CLI flags 或请求体。对于 batchUpdate 尤其如此，因为多个操作会一起校验，只要有一个请求对象不合法，整个 batch 都会失败。

gws-slides 技能 FAQ

gws-slides 只适合高级用户吗？

不是。只要能按“先读 schema，再执行”的流程来操作，初学者也能用。这个技能比普通提示词更结构化，但也正是这种结构能减少出错。

gws-slides 和普通提示词有什么区别？

普通提示词只能描述演示文稿应该长什么样。gws-slides 则可以通过 gws 直接检查演示资源，并执行 API 驱动的修改。这让它更适合真正的编辑，但也意味着你必须提供合法的标识符和方法级细节。

什么时候不该用 gws-slides？

如果你只需要创意幻灯片点子、粗略文案，或者一个非技术性的提纲，就不要用 gws-slides。如果你无法访问 Google Workspace CLI 环境，或者没有所需的共享认证配置，它也不适合。

安装前应该检查什么？

先确认你的工作流确实依赖 Google Slides API 操作，并且你能满足前置的 gws-shared 文件要求。如果你的仓库或环境无法满足这个依赖，gws-slides 就会很难稳定使用。

如何改进 gws-slides 技能

给 agent 提供准确的 deck 上下文

最强的 gws-slides 提示词通常会包含 presentation ID、目标 resource 和预期动作。如果这是一个新 deck，就明确说明；如果已经存在，也要说明修改是否必须保留现有幻灯片、顺序或 speaker notes。这样可以减少猜测，并提高第一次命令就有效的概率。

要求具体 API method，而不只是结果

这个技能在你直接点名预期操作时效果最好，比如 presentations.get 或 presentations.batchUpdate。如果你只说“更新这个 deck”，agent 就得自己推断 method，可能会走向不完整的路径。方法明确的请求，通常能得到更好的 gws-slides 用法。

第一次读取后再迭代

更实用的流程是先检查 deck，再根据返回结构收窄需求。第一次输出之后，把提示词进一步聚焦到你真正要改的具体页面、字段或 batch operation。通常这比一开始就把每个幻灯片细节都写死更有效。

留意 batchUpdate 的校验失败

gws-slides 最常见的失败原因，是 batch 里有一个 request object 不合法。为了避免这种情况，应该把 batch 拆小，用 gws schema 核对参数名，只有在确认每个操作都有效之后，再把它们组合起来。