核心用法
recipe-find-free-time 是一款 Google Workspace 日程协调工具，通过调用 gws-calendar 技能实现多用户空闲时间查询与会议创建。典型使用流程分为三步：首先执行 gws calendar freebusy query 命令，传入时间范围（ISO 8601 格式）及待查询用户邮箱列表，获取各用户的忙碌时段数据；随后分析返回的 JSON 结构，识别所有参与者的共同空闲区间；最后调用 gws calendar +insert 在确认的空闲时段创建会议并自动添加参会人。
显著优点
- 批量协调能力：单次查询即可覆盖多个用户的日程冲突检测，避免逐一询问的低效沟通
- 原生 GWS 集成：直接对接 Google Calendar API，无需额外授权或第三方中转
- 命令式工作流：清晰的查询→分析→创建三步流程，适合自动化脚本和 CI/CD 场景
- 结构化数据输出：JSON 格式的 free/busy 响应便于程序解析和自定义冲突算法
潜在缺点与局限性
- 依赖前置技能：必须预加载
gws-calendar及gws二进制工具，部署链路较长 - 无智能推荐：仅返回原始空闲数据，不自动计算最优时段，需用户或外部脚本实现决策逻辑
- 时区敏感：时间参数需严格使用 UTC 格式（Z 后缀），跨时区团队需自行转换
- 权限边界模糊：查询他人日历需目标用户预先配置共享权限，工具本身不处理授权申请
- 无冲突预警：创建会议时若目标时段已被抢占（并发场景），缺乏乐观锁或重试机制
适合人群
- 企业内部效率工具开发者
- 需要批量排期的行政助理或项目经理
- 构建日程自动化管道的 DevOps/Platform 工程师
常规风险
| 风险类型 | 说明 |
|---------|------|
| 权限扩散 | 服务账号若被赋予过宽的日历读取范围，可能导致非授权用户数据泄露 |
| 时区误配 | UTC 与本地时间转换错误可能导致会议时间错位 |
| 并发覆盖 | 多进程同时写入同一时段可能产生日程冲突 |
| 依赖失效 | `gws` CLI 版本升级或 API 变更可能导致命令语法失效 |