Skip to content
Back to skills

Feishu Room Booking

ASecurity

字节内部使用的飞书会议室查询与预订技能(覆盖全球130+工区、7300+会议室)。当用户提到"查会议室"、"订会议室"、"空闲会议室"、"预订会议室"、"开会"、"找个会议室"、"F4会议室"、"紫金会议室"、"哪个会议室有空"、或者创建会议时需要自动匹配空闲会议室时,必须使用此 skill。也适用于用户要求创建日程并指定楼栋/区域时自动完成会议室预订的场景。也适用于用户提到"会议室偏好"、"我的偏好"、"候补"、"补订会议室"、"自动订会议室"时。当用户未指定楼栋时,优先读取用户偏好中的默认楼栋;无偏好则主动询问城市/楼栋。

  • 3 stars
  • 0 votes
  • 0 copies
  • 3 views
  • Added September 9, 2026
toolspythonbash

Works with

  • cli

Security analysis

A100/100

Scanned September 9, 2026

npx -y skills add Lord1Egypt/awesome-skill-forge --skill feishu-room-booking --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Feishu Room Booking?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Feishu Room Booking
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/lord1egypt-feishu-room-booking/badge)](https://www.skillsdirectory.com/skills/lord1egypt-feishu-room-booking)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: feishu-room-booking
description: |
  字节内部使用的飞书会议室查询与预订技能(覆盖全球130+工区、7300+会议室)。当用户提到"查会议室"、"订会议室"、"空闲会议室"、"预订会议室"、"开会"、"找个会议室"、"F4会议室"、"紫金会议室"、"哪个会议室有空"、或者创建会议时需要自动匹配空闲会议室时,必须使用此 skill。也适用于用户要求创建日程并指定楼栋/区域时自动完成会议室预订的场景。也适用于用户提到"会议室偏好"、"我的偏好"、"候补"、"补订会议室"、"自动订会议室"时。当用户未指定楼栋时,优先读取用户偏好中的默认楼栋;无偏好则主动询问城市/楼栋。
---

# 飞书会议室查询与预订

管理飞书会议室的忙闲查询、自动匹配、日程预订、偏好管理和候补轮询。

## 前置依赖

- `lark-cli` 已安装且 bot 身份可用
- 飞书应用已开通相关权限(calendar:calendar.free_busy:read, calendar:calendar.event:create 等)
- 数据文件:`references/room-mapping.json`(全球 130+ 工区、7300+ 会议室)、`references/user-preferences.json`、`references/room-waitlist.json`、`references/weekly-workspace.json`
- 脚本目录:`scripts/`
- 建筑匹配使用索引查找(O(1)),忙闲查询自动 10 线程并行

## 工具脚本

所有会议室操作**必须通过脚本**,不要手写 bash 循环。

### query_rooms.py — 会议室查询

```bash
# 列出所有楼栋
python3 scripts/query_rooms.py --list-buildings

# 列出指定楼栋的会议室
python3 scripts/query_rooms.py --list-rooms -b "丽金"

# 查询空闲会议室(表格输出,自动并行查询)
python3 scripts/query_rooms.py -b "丽金" \
  -s "2026-04-20T14:00:00+08:00" \
  -e "2026-04-20T15:00:00+08:00" -o table

# 按容量筛选
python3 scripts/query_rooms.py -b "丽金" \
  -s "2026-04-20T14:00:00+08:00" \
  -e "2026-04-20T15:00:00+08:00" \
  --capacity-gte 8 -o table

# 调整并行度(默认 10 线程)
python3 scripts/query_rooms.py -b "丽金" \
  -s "2026-04-20T14:00:00+08:00" \
  -e "2026-04-20T15:00:00+08:00" \
  --max-workers 20 -o table
```

### manage_preferences.py — 偏好管理

```bash
# 设置偏好
python3 scripts/manage_preferences.py --set \
  --user "ou_xxx" --building "丽金" --capacity-gte 8 \
  --preferred-rooms "F11-07,F11-15" --note "偏好靠近电梯"

# 读取偏好
python3 scripts/manage_preferences.py --get --user "ou_xxx"

# 记录用户选择(自动学习)
python3 scripts/manage_preferences.py --learn \
  --user "ou_xxx" --room "F11-15(8)" --building "丽金智地中心 B座"

# 列出所有偏好
python3 scripts/manage_preferences.py --list
```

### watch_waitlist.py — 候补管理

```bash
# 查看候补状态
python3 scripts/watch_waitlist.py --status

# 执行一轮轮询
python3 scripts/watch_waitlist.py --poll

# 添加候补
python3 scripts/watch_waitlist.py --add \
  --event-id "xxx" --summary "周会" \
  --start "2026-04-20T14:00:00+08:00" --end "2026-04-20T15:00:00+08:00" \
  --building "丽金" --capacity-gte 8

# 移除候补
python3 scripts/watch_waitlist.py --remove --event-id "xxx"

# 清理过期候补
python3 scripts/watch_waitlist.py --clean
```

### workspace_manager.py — 工区时间线管理

```bash
# 查看当前工区和下周工区
python3 scripts/workspace_manager.py --get

# 设置当前工区(默认从今天到本周日)
python3 scripts/workspace_manager.py --set --workspace "丽金智地中心 B座"

# 设置指定日期范围的工区
python3 scripts/workspace_manager.py --set --workspace "紫金数码园4号楼" \
  --from "2026-04-30" --to "2026-05-02"

# 设置下周工区
python3 scripts/workspace_manager.py --set-next --workspace "紫金数码园4号楼"

# 推荐下周工区 / 周五提醒检查 / 查看时间线
python3 scripts/workspace_manager.py --recommend
python3 scripts/workspace_manager.py --check-friday-reminder
python3 scripts/workspace_manager.py --timeline
```

## 数据文件

| 文件 | 用途 |
|------|------|
| `references/room-mapping.json` | 会议室资源 ID 映射 |
| `references/user-preferences.json` | 用户个人偏好 |
| `references/room-waitlist.json` | 候补预订队列 |
| `references/weekly-workspace.json` | 当前工区 / 下周工区时间线 |

## 核心流程

### 流程 A:查询空闲会议室

用户只想看哪些会议室有空。

1. **解析意图** — 时间段、楼栋、容量需求
2. **确定楼栋** —
   - 用户明确指定 → 直接使用
   - 用户未指定 → 先读取用户偏好获取默认楼栋(`manage_preferences.py --get`)
   - 用户无偏好 → 读取当前工区 / 下周工区(`workspace_manager.py --get`)作为默认楼栋
   - 仍然无法确定 → ⚠️ 必须询问城市/楼栋,不要猜测。可提示"北京/上海/深圳/杭州/..."等热门城市
3. **确定日期** — ⚠️ 严格验证星期几
4. **执行查询** — `python3 scripts/query_rooms.py -u "ou_xxx" -s ... -e ... -o table`
   - 用户已指定楼栋时仍优先传 `-b`
   - 未指定楼栋时,脚本会按“用户偏好 → 当前/下周工区”兜底
5. **呈现结果** — 直接转发脚本输出

### 流程 B:创建会议并自动预订

用户要开会,需要创建日程 + 匹配会议室。

1. **解析意图** — 标题、时间、楼栋、容量、参会人
2. **确定日期** — ⚠️ 严格验证星期几
3. **确定默认楼栋** —
   - 优先读取用户偏好:`python3 scripts/manage_preferences.py --get --user "ou_xxx"`
   - 无偏好时读取工区时间线:`python3 scripts/workspace_manager.py --get`
   - 用户显式指定楼栋时覆盖默认值
4. **查询空闲会议室** — 用脚本查询,带上容量筛选
5. **用户选择** — `feishu_ask_user_question` 弹卡片
6. **创建日程** — `feishu_calendar_event` create
7. **添加会议室+参会人** — `feishu_calendar_event_attendee` create
   - ⚠️ 字段名是 `attendee_id`,不是 `id`
8. **Reflection 二次校验** — 等 5 秒后查 attendee list / event detail
   - `confirmed`:resource 已 accept,才能对用户说“预订成功”
   - `pending`:resource 已出现但状态未定,只能说“已提交,等待确认”
   - `failed`:resource decline / 缺失,不能宣告成功
9. **Fallback** — `failed` 时自动换下一个空闲会议室
10. **记录选择** — 仅 `confirmed` 后调用 `python3 scripts/manage_preferences.py --learn --user "ou_xxx" --room "F11-15(8)" --building "..."`

### 流程 C:用户偏好管理

用户设置或修改会议室偏好,后续自动应用。

**设置偏好:**
- 用户说"我一般用丽金B座8人以上的会议室"
- 调用 `--set` 写入偏好

**自动学习:**
- 每次流程 B 完成后,调用 `--learn` 记录选择
- 连续 3 次选同一个会议室 → 自动标记为偏好会议室
- 最近 3 次选同一楼栋 → 自动设为默认楼栋

**应用偏好:**
- 流程 B 的 Step 3 自动读取偏好
- 偏好楼栋不匹配时,按偏好查;没空闲时追问是否换楼栋
- 容量需求自动带入查询

### 流程 D:扫描日程自动补订

自动检测用户日程中缺少会议室的会议并补订。

**触发方式:**
- **手动**:用户说"帮我检查一下有没有缺会议室的日程"、"补订会议室"
- **自动**:Heartbeat 定时任务

**扫描步骤:**
1. 调用 `feishu_calendar_event` list 获取用户近期日程(未来 24 小时)
2. 首轮检查当前用户是否已 accept:优先读事件级 `self_rsvp_status`,没有时再看 attendees 中当前用户的 `rsvp_status / status / response_status`
3. 对 resource 参会人做 reflection 分类,而不是只看“是否存在 resource”
   - `confirmed`:已有已确认会议室,直接跳过
   - `pending`:会议室状态待确认,先进入二次确认队列,不立即补订
   - `failed` / `missing`:视为当前没有成功会议室,可继续补订
4. 对首轮判定需要补订的事件,再做一次二次确认
5. 二次确认后仍为 `confirmed` 缺会议室的日程:
   - 先读取用户偏好确定默认楼栋和容量
   - 无默认楼栋时回退到当前工区 / 下周工区
   - 查询空闲会议室
   - 有空闲 → 自动预订(跳过用户确认,因为是补订场景)
   - 全满 → 加入候补队列

**判断是否需要会议室的逻辑:**
- ❌ 跳过:当前用户未 accept、已有 `confirmed` 会议室、日期型全天事件
- ⏳ 待确认:当前用户状态缺失,或 resource 已存在但 RSVP 未稳定
- ✅ 补订:当前用户已 accept,且当前没有 `confirmed` 会议室

### 流程 E:候补轮询

会议室满了时的自动候补机制。

**添加候补:**
- 流程 D 发现全满时,调用 `watch_waitlist.py --add` 加入队列
- 候补项应写入已经确定好的楼栋;默认楼栋的决策仍遵循“用户偏好 → 当前/下周工区”

**轮询检查:**
- Heartbeat 或手动触发 `watch_waitlist.py --poll`
- 对每个 waiting 状态的候补,查询当前时段空闲会议室
- 找到空闲 → 标记为 `ready`,通知 agent 执行预订
- agent 提交预订后进入 `verification_pending`,等待 5 秒后二次校验
- 仍然满 → 记录已尝试列表,等待下次轮询

**预订成功后:**
- `confirmed` → 从候补移除
- `pending` → 保持 `verification_pending`
- `failed / decline` → 回到 `waiting`,允许继续候补或 fallback

**清理:**
- 定期 `--clean` 清理已过期的候补(开始时间超过 1 小时)

### 流程 F:工区时间线管理

用户需要声明当前工区、设置下周工区,或让系统给出默认工区建议。

**支持动作:**
- `python3 scripts/workspace_manager.py --get` 查看当前工区 / 下周工区
- `python3 scripts/workspace_manager.py --set --workspace "丽金智地中心 B座"` 设置当前工区
- `python3 scripts/workspace_manager.py --set-next --workspace "紫金数码园4号楼"` 设置下周工区
- `python3 scripts/workspace_manager.py --recommend` 基于近期会议室选择推荐工区
- `python3 scripts/workspace_manager.py --check-friday-reminder` 检查是否需要周五提醒
- `python3 scripts/workspace_manager.py --timeline` 查看完整时间线

**默认楼栋决策优先级:**
1. 用户本次明确指定楼栋
2. 用户偏好中的 `default_building`
3. 当前工区 / 与查询日期匹配的下周工区
4. 仍然无法确定时追问用户

---

## 交互规范

### 自然语言解析
| 用户说 | 解析 |
|--------|------|
| "明天下午3点开会" | 明天 15:00,默认 1 小时。未指定楼栋时先查偏好,再查工区 |
| "找个会议室" | 读取偏好 → 用默认楼栋和容量。无偏好则读当前工区;仍无结果再问城市/楼栋 |
| "查一下丽金B座明天下午" | Flow A,匹配 "丽金B座" → 丽金智地中心 B座 |
| "帮我找丽金B座11楼的会议室" | Flow A,先匹配楼栋,再用楼层 `11` 缩小房间范围 |
| "查一下 F11-15 明天下午是否空闲" | Flow A,优先按房间号匹配楼栋,再按房间号缩小到单个候选 |
| "我这周在丽金B座" | 流程 F,设置当前工区时间线 |
| "下周回紫金" | 流程 F,设置下周工区 |
| "帮我设个偏好,丽金B座8人以上" | 流程 C,设置偏好 |
| "查一下我有没有缺会议室的会" | 流程 D,扫描日程 |
| "候补状态怎么样了" | 流程 E,查看候补 |
| "北京有哪些工区" | `--list-buildings` 筛选含"北京"的行 |

### 楼栋匹配提示

当前覆盖全球 130+ 工区。agent 匹配楼栋时:
- 中文关键词("丽金"、"紫金"、"大钟寺")→ 自动模糊匹配
- 英文缩写("F4"、"F11")→ 自动匹配别名
- 楼层 / 房间号差异表达("11楼" / "11F" / "F11-15" / "11-15" / "DiscussionBooth A")→ 自动抽取并缩小候选
- 城市筛选:用户说"北京的会议室" → 先 `--list-buildings` 再 grep "北京"
- 匹配到多个结果时 → 列出来让用户选,不要默认猜一个

### 用户确认原则
- 流程 B(主动创建):必须确认时间、会议室、参会人
- 流程 D(自动补订):不需要确认,直接执行
- 流程 E(候补预订):不需要确认,直接执行

## 注意事项

1. **并行查询**:freebusy 查询自动 10 线程并行,大工区(200+ 间)可加 `--max-workers 20`
2. **会议室是 resource**:attendee type 为 `"resource"`,`attendee_id` 传 `omm_xxx`
3. **预订异步**:添加后等 5 秒再查 RSVP
4. **时区统一**:`Asia/Shanghai`(+08:00),ISO 8601
5. **日期验证**:涉及相对时间必须验证星期几
6. **脚本优先**:统一用 scripts/ 下的脚本
7. **时间修改风险**:patch 改时间后会议室可能 decline,必须重新验证
8. **偏好自动学习**:每次预订成功后调用 `--learn` 记录
9. **楼栋匹配**:使用索引查找(O(1)),支持模糊匹配 name 和所有 alias
10. **全球覆盖**:room-mapping.json 含 130+ 工区、7300+ 间会议室,未指定楼栋时优先使用用户偏好,再回退到当前/下周工区
11. **工区时间线**:weekly-workspace.json 只负责当前工区 / 下周工区,不替代用户个人偏好和自动学习

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in tools →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.