用途:飞书智能日历技能基于 feishu-cli,通过三个 v1.18+ 新增子命令辅助会议安排:suggestion 为参与者推荐共同空闲时段,room-find 为给定时段查找可用会议室,rsvp 接受、拒绝或待定已收到的邀请。基础日历 CRUD(list/get/create-event/agenda 等)不属于本技能,应走 feishu-cli-toolkit。
主要能力:suggestion 直调 freebusy/suggestion,支持参与者 ID 列表、会议时长、搜索起止、时区、周期性 rrule、排除时段,返回推荐时段与 ai_action_guidance;room-find 直调 freebusy/room_find,支持多时段、参与者、城市、建筑、楼层、会议室名、容量范围过滤,返回按时段聚合的会议室信息(room_id、room_name、capacity、reserve_until_time)。
使用方式:安装命令暂未提供。常用命令如 feishu-cli calendar suggestion --attendee-ids ou_aaa,ou_bbb --duration 30m;feishu-cli calendar room-find --slot 2024-01-22T09:00:00+08:00~2024-01-22T10:00:00+08:00 --min-capacity 6;feishu-cli calendar rsvp --event-id <EVENT_ID> --action accept。rsvp 亦支持兼容别名 --rsvp-status。
身份与权限:suggestion/room-find 优先 User Token、App Token 兜底,需 calendar:calendar.free_busy:read;rsvp 必需 User Token,需 calendar:calendar.event:reply。可用 auth check 预检权限。
限制与注意:参与者 ID 前缀须为 ou_(用户)或 oc_(群聊),其他前缀会被跳过;duration 纯数字按分钟,不接受小数小时;start 默认当前时间,end 默认同一天 23:59:59;slot 与 exclude 用 start~end 且 end 须晚于 start;room-find 内置重试,用户层不宜再叠加;suggestion 未挂重试,高频调用需自行 sleep 1-2s;rsvp action 仅 accept/decline/tentative 三个枚举。