用途 google_forms 技能用于管理用户的 Google 表单,包括读取表单、创建表单、更新表单以及读取用户提交的回复。该技能明确要求通过 hatch_gws_cli 完成所有操作,内置的 Google Workspace CLI 是唯一实现路径。
主要能力 连接管理方面,可运行状态查询与断开连接命令。表单操作方面,支持查询表单(forms.get)、创建表单(forms.create)、批量更新(forms.batchUpdate),以及列出回复(responses.list)和获取单条回复(responses.get)。执行不熟悉的表单方法前,可先用 schema 命令查看当前 CLI 的参数与 JSON 结构,以保证 --params 与 --json 符合约定。
使用方式 通过 exec 运行 hatch_gws_cli forms <resource> <method> [flags]。例如创建表单时传入标题等 JSON 内容;批量更新时可传入针对表单描述的 updateMask 请求;读取回复时可指定 formId 与 pageSize。认证由封装工具的状态与断开子命令处理,不应手写凭证文件,也不要运行原始的 gws auth 命令。
首次使用流程 先运行 hatch_gws_cli forms status。如果状态不可用,说明该设备不支持 Google 表单,不应提供替代集成方案或向用户索要凭证。如果状态为未连接且返回连接链接,则用该链接生成 Connect Google Forms 形式的 Markdown 链接,不要单独粘贴原始 URL,并等待用户完成连接。连接成功后再继续表单操作。
操作规则与限制 创建表单以及编辑仅由用户本人拥有且尚未发布的表单,可以在请求明确时直接执行;编辑共享或已发布表单、或发布表单前应先确认,因为内容可能被他人看到。展示回复数据前先运行 forms.get,把问题 ID 映射为可读的表单结构。表单 ID 与回复 ID 应视为不透明字符串,只使用先前命令返回或用户明确提供的 ID。需要全部回复时分页拉取,直到没有下一页令牌为止。读写后仅向用户确认可见结果,不在用户文本中暴露原始 ID、分页令牌或原始 JSON,除非用户要求或用于排障。读取回复时保留 Google 原始时间戳,并补充语义化的 UTC 与用户本地时间形式。
适用场景 适合需要通过命令行批量或自动化管理 Google 表单、查看问卷回复并整理结果的场景,也适合在支持该技能的环境中由 AI 助手代为执行表单的创建、更新与回复读取。
限制 使用前提是设备上可使用 hatch_gws_cli 并完成 Google 表单连接;若状态不可用则无法使用,且不提供其他集成方式。具体收费、价格与平台支持范围暂未提供。