核心用法
本技能（recipe-find-free-time）是一个调度自动化配方，用于解决多用户会议时间协调的痛点。其工作流程分为三步：首先通过 gws calendar freebusy query 接口查询指定时间范围内多个 Google 账户的空闲/忙碌状态；然后解析返回的 JSON 数据，识别所有参会者的重叠空闲时段；最后利用 gws calendar +insert 命令在确定的空闲 slot 中直接创建会议事件。
典型场景
- 跨部门会议排期：输入 2-10 个企业邮箱，系统自动找出共同空闲时间
- 客户/外部协作方对接：无需对方暴露完整日程细节，仅获取 busy 状态
- 批量预约面试/评审：HR 或项目经理快速锁定多方可用时段
显著优点
1. 隐私友好：采用 Google Calendar Free/Busy API，只返回忙碌时间段，不暴露事件标题、地点等敏感信息
2. 企业级兼容：基于 GWS（Google Workspace）生态，天然支持企业域名账户和权限体系
3. 自动化闭环：查询到创建事件一气呵成，减少人工比对和手动录入
4. JSON 结构化输出：便于二次开发，可轻松接入 Slack Bot、企业微信等通知系统
潜在缺点与局限性
1. 依赖外部权限：需要目标用户已授权应用访问其日历忙闲信息，新员工或外部客户可能未配置
2. 时区处理隐性：示例使用 UTC 时间（Z 后缀），实际业务中需确保所有用户时区一致性，否则可能产生 1-24 小时偏移错误
3. 无智能冲突解决：仅返回原始 busy 数据，复杂场景（如"尽量避开某人上午"或"优先选 30 分钟而非 60 分钟"）需额外逻辑
4. 单云锁定：仅支持 Google Calendar，Microsoft 365、飞书、钉钉等企业需其他方案
适合人群
- 行政/HR 团队：高频组织跨部门会议、面试排期
- 项目经理：需要协调客户、设计师、开发等多方时间的敏捷团队
- 企业 IT 自动化工程师：将日程查询集成到内部 OA 或审批流
常规风险
- 权限泄露风险：若 API 凭证管理不当，可能获取超出必要范围的日历数据（建议仅申请
calendar.freebusy只读权限） - 时间边界误差：API 返回的 busy 区间为闭区间，实际可用空闲时间需严格检查端点是否包含
- 配额与限速：Google Workspace API 存在 QPS 限制，大规模查询（如 50+ 用户）需实现指数退避重试