gws-tasks

gws-tasks 技能概览

gws-tasks 的作用

gws-tasks 技能帮助你通过 gws CLI 管理 Google Tasks：列出任务清单、创建和更新清单，以及处理清单中的任务。它最适合希望采用命令行工作流来操作 Google Tasks 的用户，而不是依赖一个会猜测 API 行为的泛化提示。

这个技能适合谁

如果你在自动化任务清单操作、编写工作流脚本，或在 Google Workspace 环境中验证任务管理流程，那么就该使用 gws-tasks。当你已经知道自己需要的是 Google Tasks API 这种结构，并希望有一个可靠、可重复的 gws tasks 接口时，它尤其有用。

它为什么重要

gws-tasks for Workflow Automation 的核心价值在于一致性：这个技能会直接给出准确的 resource/method 模式、支持的 tasklist 和 task 操作，以及避免反复试错所需的约束。这让它在输出必须可执行时，比一句含糊的“管理任务”提示更可靠。

如何使用 gws-tasks 技能

安装与前置准备

使用 npx skills add googleworkspace/cli --skill gws-tasks 安装。使用前先阅读 ../gws-shared/SKILL.md，因为这里包含了这个技能所依赖的认证、全局标志和安全规则。如果这个共享文件不存在，先运行 gws generate-skills。

如何为技能组织你的请求

gws-tasks usage 的模式是 gws tasks <resource> <method> [flags]，所以你的提示应清楚写出三件事：目标资源、方法，以及你想要的结果。好的输入包括任务清单名称或 ID、你是在创建、更新、删除还是列出，以及你需要的任何过滤条件或字段限制。

先看哪些内容

先读 SKILL.md，然后检查任何会影响执行的仓库指引：README.md、AGENTS.md、metadata.json，以及相关的 rules/、resources/、references/ 或 scripts/ 目录。在这个仓库里，SKILL.md 是主要事实来源，因此需要解读的额外脚手架并不多。

实用工作流

把一个粗略请求改写成可执行提示的方法，是补上具体标识符和期望输出。例如：“列出我的任务清单，然后在我指定的清单里创建一条名为‘Submit expense report’的任务，并返回精确的命令序列。”这比“帮我处理 Google Tasks”更好，因为它提供了足够上下文，让技能可以选对资源和方法，而不是凭空补细节。

gws-tasks 技能常见问题

gws-tasks 只适用于 Google Tasks API 工作吗？

是的，这就是它的设计定位。gws-tasks 不是通用的生产力助手，而是 Google Workspace CLI 生态中面向任务清单和任务的专用接口。

使用它之前需要很懂 CLI 吗？

不需要非常深入。只要能清楚说明任务清单意图，初学者也可以用 gws-tasks，但仍然需要提供具体信息，例如目标清单、动作，以及相关的 ID 或名称。如果没有这些，技能就无法可靠地选择正确命令。

什么情况下不该用这个技能？

如果你只是需要头脑风暴、轻量级待办整理，或者一次性的自然语言任务摘要，就不该使用 gws-tasks。当你需要的是可命令化的工作流、可复现的操作，或与基于 gws 的自动化集成时，它才是更合适的选择。

它和普通提示有什么不同？

普通提示可能只是宽泛描述任务管理。gws-tasks skill 则绑定了明确的命令结构和共享仓库规则，能减少猜测，让结果更适合真正执行。

如何改进 gws-tasks 技能

给出精确的对象和动作

提升效果最快的方法，就是把任务清单、任务和方法写得足够明确。不要说“帮我清理任务”，而要说“列出所有任务清单，找出名为‘Work’的清单，然后把任务 X 更新为周五截止”。之所以要具体，是因为 gws-tasks 是直接映射到 API resources 和 methods 的。

说明你需要的输出形式

如果你想要的是一条命令、一串命令，还是对所选方法的简短说明，一开始就说清楚。这能帮助技能保持在工作流自动化的实用范围内，而不是返回一段关于 Google Tasks 行为的泛泛描述。

注意常见失败模式

最常见的问题是身份信息不明确：只有清单名称，没有 ID；或者只给了动作，没有目标资源。另一个常见失败点是漏掉共享前置条件，尤其是来自 gws-shared 的认证和全局标志。命令看起来可行但无法顺利运行时，先检查这些内容。

在第一版基础上继续迭代

如果第一版结果接近但不完整，不要重述整个请求，而是补上缺失的约束。加入诸如“使用 patch 语义”“仅限已完成任务”“只针对指定任务清单”之类的细节，下一轮结果就会更窄、更可执行。