核心用法
recipe-find-free-time 是一个 Google Workspace 日历调度自动化技能，通过调用 gws-calendar 基础技能，实现多用户空闲时段查询与会议创建的一站式流程。
执行流程：
1. 查询空闲时段：使用 gws calendar freebusy query 命令，传入时间范围（timeMin/timeMax）及多个用户邮箱（items 数组），获取所有指定用户的忙碌/空闲状态
2. 智能匹配时段：系统返回结构化 JSON 数据，展示各用户的占用情况，辅助识别共同空闲窗口
3. 自动创建会议：在确认的空闲时段内，直接调用 gws calendar +insert 创建会议，自动填充标题、参与者、起止时间
典型场景： 跨部门周会排期、客户预约窗口确认、分布式团队多时区协调。
显著优点
- 自动化编排：将「查空闲→找重叠→建会议」三步整合为标准化流程，减少人工判断
- 原生集成 Google：直接调用 Google Calendar Free/Busy API，数据实时准确，无需第三方中转
- 批量处理能力：单次查询支持多用户（理论无上限，受 API 速率限制），适合团队级调度
- JSON 结构化交互：输入输出均为标准 JSON，便于脚本化、自动化调度系统集成
潜在局限与风险
- 依赖前置技能：必须预加载
gws-calendar技能，且需有效 Google Workspace 授权凭证 - 时区处理需人工确认：命令中的时间戳需为 ISO 8601 格式（如
2024-03-18T08:00:00Z），本地时区转换需使用者自行处理 - 无智能推荐算法：仅返回原始空闲数据，重叠时段的「最优选择」需人工判断，不支持自动评分或偏好学习
- 权限敏感性：查询他人空闲信息需具备对应日历的「查看空闲/忙碌信息」权限，跨组织场景受限
- 时间精度限制：Google Free/Busy API 默认以 30 分钟为粒度返回，精确到分钟的调度可能受限
适合人群
| 角色 | 场景 |
|------|------|
| 行政/运营助理 | 批量为高管团队安排会议 |
| 项目经理 | 协调跨职能团队站立会、评审会 |
| 销售/客户成功 | 快速确认与客户的多人会议窗口 |
| 自动化开发者 | 构建内部调度机器人或 CI/CD 触发会议 |
常规风险提示
⚠️ 隐私合规：批量查询员工日历可能涉及劳动隐私法规，建议事前告知并限制使用范围
⚠️ 误删/误建风险：自动化创建会议缺乏二次确认，测试环境务必使用 --dry-run 或沙盒日历
⚠️ Token 安全：gws 凭证需妥善保管，避免硬编码在公开仓库