核心用法
飞书日历 Skill 通过 Calendar v4 API 实现企业级日程自动化管理，涵盖三大核心场景：
1. 日历与日程管理
- 创建独立日历（如"项目日历"）实现团队协作隔离
- 分步创建日程：先创建事件主体，再单独添加参与人（API 限制必须两步）
- 支持更新、删除日程操作
2. 智能排期freebusy/list 接口可批量查询多人在指定时段的空闲状态，是安排跨部门会议的利器。支持 ISO 8601 时间格式，可直接识别冲突时段。
3. 实时订阅监控
通过 subscribe 接口对关键日历建立 Webhook 订阅，实现日程变更的实时感知，适用于高管日程跟踪、关键项目节点监控等场景。
显著优点
- 生态深度集成：原生对接飞书组织架构，自动同步企业通讯录，无需维护独立的用户映射表
- 企业级可靠性：飞书日历作为核心办公组件，API 稳定性经过大规模验证
- 自动化闭环：从查询空闲→创建日程→订阅变更形成完整工作流，减少人工协调成本
- 权限粒度精细：支持日历级别、日程级别的权限控制，满足敏感会议管理需求
潜在局限
- API 设计繁琐：创建日程必须分两步（先创建再添加参与人），无法原子化完成
- 时间格式陷阱：时间戳必须为秒级字符串（非毫秒、非数字），是高频踩坑点
- 依赖飞书生态：仅限飞书企业用户使用，无法跨平台兼容
- Webhook 配置成本：订阅功能需要额外的回调地址配置和事件处理开发
适合人群
- 需要频繁协调跨部门会议的项目经理、行政助理
- 希望自动化高管日程监控的 executive assistant
- 构建智能排班、会议室预订系统的开发者
- 需要日程数据驱动业务流程（如自动触发会议准备任务）的自动化团队
常规风险
- 权限泄露风险：
calendar:subscribe权限若被滥用可监控敏感人员日程，需严格管控授权范围 - 时区处理：跨时区企业需确认
time_min/time_max带时区偏移的格式正确性 - 并发冲突：高并发创建日程时可能产生竞态条件，建议结合 freebusy 查询实现乐观锁
- Token 有效期：
tenant_access_token需处理刷新机制，避免长周期任务中断