gws-workflow
作者 googleworkspacegws-workflow 是 gws CLI 的 Google Workspace 自动化层。可用它构建可重复的跨服务工作流，用于会议准备、站会摘要、邮件转任务以及从 Drive 向 Chat 发布通知。请配合共享认证层安装，并在执行前先进行 schema 发现。
该技能得分 68/100，属于值得收录但建议谨慎呈现的类型：它为 Google Workspace 工作流提供了真实可用的命令入口，但目录用户仍需检查 schema 并遵循关联的前置说明，才能更有把握地使用。就安装决策而言，它适合偏工作流自动化的场景，但还不算完全开箱即用。
- 定义了明确的触发与调用模式：`gws workflow <resource> <method> [flags]`，并提供 `gws workflow --help` 和 `gws schema` 用于发现。
- 通过站会报告、会议准备、邮件转任务、周报摘要和文件通知等辅助命令，提供了多个真实的工作流入口。
- 借助共享技能引用提供仓库关联说明以及前置条件/安全指引，相比通用提示词更利于 agent 执行。
- 运行层面的清晰度依赖外部发现：用户必须查看 `gws schema` 才能了解所需参数和 flag 形式，因此执行时仍有一定试错成本。
- 这个仓库片段中没有安装命令、脚本、引用或支持文件，限制了即装即用能力，也不利于覆盖边缘情况。
gws-workflow 技能概览
gws-workflow 的作用
gws-workflow 技能是面向 gws CLI 的 Google Workspace 自动化层。它帮助你在不先猜原始 API 结构的情况下，直接运行跨服务工作流，例如会议准备、站会摘要、邮件转任务，以及从 Drive 到 Chat 的通知发布。
适合谁安装
如果你已经在使用 gws，并且想要的是可重复的运营工作流，而不是一次性的提示词，那么就安装 gws-workflow。它很适合需要把 Gmail、Calendar、Tasks、Drive 和 Chat 串成一个结果的 agent。
它为什么不一样
gws-workflow 技能的核心价值，在于它会先指导你发现可用命令、正确组织输入，再去执行。这个差异很重要，因为工作流失败通常不是核心任务本身有问题，而是缺少参数、资源和方法配错了，或者跳过了 schema 这一步。
如何使用 gws-workflow 技能
安装与前置准备
执行 gws-workflow install 时，请走 CLI 的 skill 安装流程，并先确保共享认证层已经存在。这个技能明确依赖 ../gws-shared/SKILL.md；如果它缺失，先运行 gws generate-skills，这样在你开始调用工作流之前，认证、全局标志和安全规则就都可用了。
先从检查命令开始
最稳妥的 gws-workflow usage 方式是：先读 SKILL.md，再运行 gws workflow --help，然后用 gws schema workflow.<resource>.<method> 查看目标方法。这样能在构建 --params 或 --json 之前，先弄清楚必填参数、类型和默认值，是最安全的发现方式。
把模糊目标改写成可执行提示
像“帮我准备会议”这种泛泛的请求，如果你把资源、期望输出和约束说清楚，技能会更容易执行，比如：“使用 gws workflow calendar.events list 和相关方法，为明天的 1:1 准备一份会议简报，包含参会人、议程背景和关联文档。”目标越具体，agent 选错辅助命令的概率就越低。
先读这些文件
先从 SKILL.md 开始，然后在你的任务符合某个内置工作流时，继续查看 skills/gws-workflow-* 下链接的辅助命令。实际使用中，这意味着先读最贴近你待办事项的辅助技能，再去尝试从顶层指南泛化出做法。
gws-workflow 技能 FAQ
gws-workflow 只适合高级用户吗？
不是。即使你不熟悉 Google Workspace APIs，这个技能也依然有用，因为它会告诉你如何发现命令、检查 schema，而不是默认你已经知道字段名。对新手来说，最大的收益就是老老实实走 schema 这一步，而不是自己硬拼参数。
什么时候不该用 gws-workflow？
如果你只是需要一段自然语言摘要，或者只想做一个不涉及实际 Workspace 操作的手工一次性回复，就不该用它。若你的任务根本不需要执行 gws 命令，这个技能只会增加不必要的开销。
它和通用提示词有什么不同？
通用提示词可以描述结果，但 gws-workflow 是围绕可执行的工作流发现来设计的。它更适合你需要一个可复现的 gws workflow 调用时，尤其是在多个 Google 服务之间联动、方法和标志位都必须准确的场景里。
它适合更广义的 gws-workflow Workflow Automation 用例吗？
可以，但前提是自动化建立在受支持的 gws 资源和方法之上。如果你的工作流需要 Google Workspace APIs 之外的自定义业务逻辑，还是得借助外部脚本或编排。
如何改进 gws-workflow 技能
先把工作流目标说准确
gws-workflow 最好的结果，来自一开始就明确服务、资源和目标产出：“明天客户电话的 Calendar 事件查询”就比“帮我看日历”好得多。这样可以缩小命令搜索空间，也更有可能让第一次输出就能直接用。
写清楚你需要的输出形态
要说明你想要的是摘要、任务、草稿消息，还是结构化的命令调用。例如，“返回一份包含会议、未完成任务和阻塞项的站会摘要”就比“分析我今天的安排”更清晰，辅助技能更容易对准目标。
执行前先核对 schema
常见失败模式之一，是以为某个方法接受的字段和另一个 Google API 一样。只要输入结构不清楚，就运行 gws schema workflow.<resource>.<method>，尤其是在处理 --params 和 --json 时；这样可以减少反复试错，也能避免静默不匹配。
从辅助工作流迭代，不要从零开始
如果第一次尝试太宽泛，就切换到最接近的辅助命令，比如 +meeting-prep 或 +email-to-task，再在此基础上细化。通常这比自己重新发明一个提示词更有效，因为这些路径把工作流意图编码得更直接。