| name | lark-workflow-meeting-finder |
| version | 1.0.0 |
| description | 日程冲突检测器：查询多个参与者的忙闲状态，找到共同的空闲时段，可选直接创建会议日程。当用户需要'找时间开会'、'协调会议时间'、'查看空闲时段'、'日程冲突'、'约会议'、'有空什么时候'、'大家什么时候有空'时使用。 |
| metadata | {"requires":{"bins":["lark-cli"]}} |
日程冲突检测器工作流
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理
适用场景
- "查一下明天下午大家有空吗" / "查看空闲时段"
- "安排一个1小时的会，参会人：张三、李四、王五" / "约会议"
- "下周三下午我和张三、李四有没有时间开会" / "日程冲突"
- "找个大家都空的时间开会" / "协调会议时间"
- "看看今天有没有空隙可以开个会"
前置条件
仅支持 user 身份。执行前确保已授权：
lark-cli auth login --domain calendar,contact
工作流
{参会人列表 + 时间范围 + 会议时长}
│
├── contact +search-user ──────────► 查找参会人 open_id
│
├── calendar +freebusy ────────────► 查询各参会人忙闲
│
├── AI 分析空闲交集 ──────────────► 找出共同空闲时段
│
├── [有明确时间] 冲突检测 ─────────► 报告冲突详情
│
├── [有时间段] +suggestion ────────► 推荐多个可选时段
│
└── [用户确认] calendar +create ───► 创建会议日程 + 发邀请
Step 1: 查找参会人
如果用户提供了姓名，先查找 open_id：
lark-cli contact +search-user --query "<参会人姓名>" --as user
记录返回的 open_id（ou_xxx 格式）。如果查不到，提示用户检查姓名是否正确。
注意：只能查找同一飞书租户内的用户。跨租户用户无法查询忙闲状态。
Step 2: 查询忙闲状态
逐人查询
lark-cli calendar +freebusy --user-id "ou_xxx" --as user
lark-cli calendar +freebusy \
--user-id "ou_xxx" \
--start "2026-04-10T09:00:00+08:00" \
--end "2026-04-10T18:00:00+08:00" \
--as user
注意：--start / --end 仅支持 ISO 8601 格式和 Unix timestamp，不支持自然语言。需要 AI 根据当前日期计算。
批量查询
对多个参会人，逐一调用 +freebusy（当前 lark-cli 不支持一次传多个 user-id）：
lark-cli calendar +freebusy --user-id "ou_aaa" --start "..." --end "..." --as user
lark-cli calendar +freebusy --user-id "ou_bbb" --start "..." --end "..." --as user
lark-cli calendar +freebusy --user-id "ou_ccc" --start "..." --end "..." --as user
Step 3: AI 分析空闲时段
将所有参会人的忙闲数据整合，计算共同空闲时段：
- 将每个人的忙碌时段标记在时间轴上
- 取所有忙碌时段的并集
- 在非忙碌时段中，筛选出满足会议时长要求的连续空闲段
- 按推荐优先级排序（工作时间优先，避开午休）
输出格式：
## 推荐会议时段
以下为 {日期} 所有参会人均空闲的时段（会议时长 {N} 分钟）：
| 时段 | 推荐度 | 说明 |
|------|--------|------|
| 09:00-10:00 | 推荐 | 工作时间，无冲突 |
| 14:00-15:00 | 推荐 | 工作时间，无冲突 |
| 11:00-12:00 | 一般 | 接近午休 |
### 冲突详情
| 参会人 | 忙碌时段 | 事件 |
|--------|---------|------|
| 张三 | 10:00-11:30 | 产品评审会 |
| 李四 | 13:00-14:00 | 1v1 |
智能推荐（可选）
如果用户给出了时间范围但没指定具体时间，可使用 +suggestion 获取系统推荐：
lark-cli calendar +suggestion \
--start "2026-04-10T09:00:00+08:00" \
--end "2026-04-10T18:00:00+08:00" \
--attendee-ids "ou_aaa,ou_bbb,ou_ccc" \
--duration-minutes 60 \
--as user
Step 4: 创建会议（可选）
用户确认时间段后，创建日程并发送邀请：
lark-cli calendar +create \
--summary "会议主题" \
--start "2026-04-10T09:00:00+08:00" \
--end "2026-04-10T10:00:00+08:00" \
--attendee-ids "ou_aaa,ou_bbb,ou_ccc" \
--as user
注意：创建前务必与用户确认时间、主题和参会人，避免误操作。
降级策略
| 场景 | 降级方案 |
|---|
| 某参会人查不到 | 提示用户确认姓名，或跳过该人继续查询 |
| 无共同空闲时段 | 建议：扩大时间范围 / 减少参会人 / 拆分会议 |
| 只能找到非理想时段 | 列出"次优时段"，说明冲突详情 |
| +suggestion 不可用 | 退回到 +freebusy 手动分析 |
| 创建日程失败 | 输出推荐时段让用户手动创建 |
权限表
| 命令 | 所需 scope |
|---|
contact +search-user | contact:user.base:readonly |
calendar +freebusy | calendar:freebusy:readonly |
calendar +suggestion | calendar:freebusy:readonly |
calendar +create | calendar:calendar:write, calendar:event:write |
参考
