核心用法
gws-forms 是 Google Workspace CLI (gws) 的表单管理子技能，允许用户通过命令行接口 (CLI) 直接操作 Google Forms API。核心工作流遵循 gws forms <resource> <method> 的固定模式，支持六大资源类型：
- forms: 创建、获取、批量更新表单元数据及发布设置
- responses: 读取表单提交的响应数据
- watches: 配置表单变更的推送通知
关键特性包括 batchUpdate 批量更新（单次请求执行多项修改）和分步创建流程——由于 API 限制，创建表单需先调用 create 生成空表单（仅复制标题字段），再通过 update 添加具体题目。
显著优点
1. 自动化集成: CLI 形式天然适配 CI/CD 管道、shell 脚本和定时任务，无需编写 Python/Node.js 中间层
2. 批量操作效率: batchUpdate 原子化提交多项变更，减少 API 调用次数与速率限制风险
3. 与 Google Workspace 生态深度整合: 直接复用 gws 的统一认证体系，支持 OAuth 2.0 服务账号
4. 元数据可编程: 可读取表单结构（get）、导出响应数据（responses）、配置事件监听（watches），实现完整的表单生命周期管理
潜在缺点与局限性
1. 创建流程割裂: 无法一次性创建含题目的完整表单，必须两次 API 调用，增加脚本复杂度
2. 旧版表单不支持: setPublishSettings 明确不支持 Legacy forms，迁移历史表单时可能受阻
3. 字段限制严格: 创建时仅 info.title 和 info.document_title 被保留，描述、题目、设置均被丢弃，易引发数据丢失错觉
4. 依赖前置知识: 要求用户预先阅读 gws-shared/SKILL.md 掌握认证与全局标志，学习曲线较陡
5. CLI 调试门槛: gws schema 查询模式虽强大，但对不熟悉 JSON Schema 的用户不够直观
适合人群
- Workspace 管理员: 批量部署标准化表单模板、监控表单变更
- 数据工程师: 构建自动化的表单数据抽取管道（ETL）
- 开发者/运维: 在基础设施即代码 (IaC) 流程中管理表单资源
- 高级用户: 需要程序化控制表单发布状态、响应收集逻辑的场景
常规风险
1. OAuth 权限范围风险: 需申请 forms 或 forms.body 等敏感作用域，过度授权可能导致数据泄露
2. 批量更新原子性: batchUpdate 虽原子执行，但前置校验失败会导致整批回滚，需设计幂等重试逻辑
3. 数据覆盖隐患: 更新操作默认无确认机制，脚本错误可能批量破坏生产表单结构
4. 速率限制: Google Forms API 存在配额限制，高频自动化场景需实施指数退避策略
5. 服务账号权限边界: 跨域表单访问需显式共享权限，否则 API 调用返回 403 错误