Google Tasks 技能用于管理用户的 Google 待办事项，涵盖任务列表、任务详情、创建、更新和完成等操作。所有功能通过命令行工具 hatch_gws_cli tasks <resource> <method> 执行，涉及两个资源：tasklists（任务列表）和 tasks（任务）。因此一个任务命令会出现两次 tasks，例如 hatch_gws_cli tasks tasks list 表示服务为 tasks、资源为 tasks、方法为 list。参数放在 --params 的 JSON 对象中，创建和编辑操作额外提供 --json 请求体。
用途
该技能面向需要以程序化方式操作用户 Google Tasks 的场景，例如查看有哪些待办列表、列出某个列表中的未完成任务、查询某时间段内到期的任务、获取单个任务的完整信息、新增任务、标记完成或重新打开、编辑或改期、移动与嵌套排序，以及管理任务列表本身。
主要能力
查看列表与任务：使用 hatch_gws_cli tasks tasklists list 获取用户的待办列表；使用 hatch_gws_cli tasks tasks list --params '{"tasklist":"@default","showCompleted":false}' 查看某列表的未完成任务，默认列表为 @default。若需包含已完成任务，可设置 "showCompleted":true,"showHidden":true。查询某时间窗口内到期的任务可使用 dueMin 和 dueMax 参数，值为 RFC3339 时间戳。获取单个任务详情或编辑前获取其 ID，使用 hatch_gws_cli tasks tasks get --params '{"tasklist":"@default","task":"<id>"}'。
新增任务：hatch_gws_cli tasks tasks insert --params '{"tasklist":"@default"}' --json '{"title":"Buy groceries","notes":"Milk, eggs","due":"<date>"}'。仅 title 为必填，notes 和 due 在用户提供时添加。
完成或重新打开：标记完成使用 hatch_gws_cli tasks tasks patch --params '{"tasklist":"@default","task":"<id>"}' --json '{"status":"completed"}'；重新打开则将 status 设为 needsAction。
编辑或改期：使用 patch 命令，仅传入需要变更的字段，如 title 或 due。
组织任务：移动、嵌套为子任务或重新排序使用 hatch_gws_cli tasks tasks move，通过 parent 指定父任务、previous 指定同级前一个任务；省略 parent 表示顶层，省略 previous 表示移到顶部。管理列表可使用 tasklists insert、tasklists patch 和 tasklists delete。
删除或清理：删除单个任务使用 tasks delete；将已完成任务从列表常规视图中隐藏（仍可通过 showHidden 检索，并非删除）使用 tasks clear。
使用方式
首次使用前需一次性连接。运行 hatch_gws_cli tasks status，若未连接，将返回的 connect_url 以 Connect Google Tasks 形式发给用户并等待其点击。断开连接运行 hatch_gws_cli tasks disconnect，并将其 disconnect_url 以 Disconnect Google Tasks 形式发送。若命令报告认证失败或未连接，重新运行 status 并按其返回的链接操作。若 status 不可用，则说明该设备上 Google Tasks 不可用并停止。认证流程仅通过 status 和 disconnect 进行，不手工编写凭据文件，也不使用原始 gws auth。
在读取到任务所在的列表 ID 和任务 ID 后，应将这些 ID 原样用于后续的更新、完成、移动或删除操作，不要回退到 @default，也不要自行编造或改写 ID。
适用场景
适合需要批量或自动化管理 Google 待办事项的场合，例如查询本周到期任务、整理任务层级、按名称定位列表并操作其中任务等。
限制
任务仅基于日期：due 是类似 2026-04-16T00:00:00Z 的 RFC3339 时间戳，但 Google Tasks 只使用其中的日期，不含具体时间，也不发送提醒或通知，因此不应承诺具体时间或提醒。若用户需要定时提醒，可建议改用 Google Calendar。任务属于已连接账户的个人数据，不支持共享列表、将任务指派给他人或添加附件。与用户交流时应使用自然语言，命令、JSON 输出、状态词、任务或列表 ID、API 字段及原始 JSON 均不应出现在回复中；任务自身的标题、备注和到期日期属于用户内容，可以保留在回复中。到期日期需结合当前日期和用户时区，以纯日期形式报告。due 保持仅日期值；若需实际时刻，可参考 task_record_updated_at 和 task_completed_at 的 UTC/用户本地字段。切勿打印令牌、密钥或凭据材料，若出现在工具输出中应予以遮蔽。