Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-calendar
lark-calendar
Verified【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书日历:管理日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。不负责:查询视频会议记录(本 skill 只覆盖日程;lark-vc 技能未随包收录,可 CLI 直连,见意图路由)、待办任务(走 lark-task)。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 19.0 KB |
| references/lark-calendar-create.md | markdown | 6.1 KB |
| references/lark-calendar-join-event.md | markdown | 2.0 KB |
| references/lark-calendar-list-attendees.md | markdown | 1.3 KB |
| references/lark-calendar-meeting-relation.md | markdown | 5.4 KB |
| references/lark-calendar-meeting.md | markdown | 1.7 KB |
| references/lark-calendar-recurring.md | markdown | 6.8 KB |
| references/lark-calendar-room-find.md | markdown | 8.2 KB |
| references/lark-calendar-rsvp.md | markdown | 1.1 KB |
| references/lark-calendar-schedule-clear-time.md | markdown | 2.8 KB |
| references/lark-calendar-schedule-fuzzy-time.md | markdown | 3.3 KB |
| references/lark-calendar-schedule-meeting.md | markdown | 6.1 KB |
| references/lark-calendar-suggestion.md | markdown | 6.9 KB |
| references/lark-calendar-transfer.md | markdown | 4.4 KB |
| references/lark-calendar-update.md | markdown | 7.8 KB |
references/lark-calendar-meeting-relation.md
View on GitHub# 日程与视频会议的关系
用户口中的「会议」不区分「日程」和「视频会议」,实际是两类不同实体。本文定义两者关系,并给出「当前 / 未来 / 过去」三种查询意图的执行流程。
## 核心概念
- **日程(Calendar Event)**:对用户一段时间的预占,到点后可能开视频会议、也可能只是线下会议 / 私人时间块。
- **视频会议(VC Meeting)**:实际发生过的一次通话,`meeting_id` 只有真正发起后才存在。
| 场景 | `event_id` | `meeting_id` | 备注 |
|------|:---:|:---:|------|
| 日程发起了视频会议 | ✓ | ✓ | 一个日程可发起多次通话,产出多个 `meeting_id` |
| 日程未开视频会议 | ✓ | ✗ | 线下会议 / 私人时间块 |
| 即时视频会议 | ✗ | ✓ | 无日程绑定 |
**关键不变量**:视频会议只发生在**当下和过去**,不存在「未来的视频会议」。
## 意图 1:查询当前正在开的会议
**目标覆盖**:当下时间点用户可能关心的所有活动——正在开的视频会议 + 当前时间的日程(无论有没有开视频)。
**执行步骤**:
```bash
# 1. 当前时间的日程
lark-cli calendar +agenda --start <now> --end <now>
# 2. 用户已加入的视频会议
lark-cli vc +meeting-list-active --as user
# 3. 步骤 1 每个日程回查关联 meeting_id
# 输出是 event_id → meeting_id 映射;后续所有交叉都按 meeting_id 匹配
# (vc +meeting-list-active / vc +detail 结果的 id 字段即 meeting_id,无 event_id)
lark-cli calendar +meeting --event-ids <event_id1>,<event_id2>
# 4. 判定视频会议是否仍在进行
# 仅对「步骤 3 非空 meeting_id 且不在步骤 2 里」的调用
# end_time 为空或 <= start_time → 仍在进行;否则已结束
lark-cli vc +detail --meeting-ids <meeting_id1>,<meeting_id2>
```
**结果分组呈现**:按下列**四组顺序**归类,每组独立成节,空组可省略。
1. **当前用户正在参与的会议**(`meeting_id` 命中步骤 2)
- **即时会议**(无关联 `event_id`):仅展示视频会议信息。
- **日程会议**(能与步骤 3 的 `event_id` 关联):展示日程信息 + 视频会议信息。
2. **当前正在视频会议的日程(用户未加入)**:日程有 `meeting_id`、步骤 4 判定仍在进行、但不在步骤 2 里。展示日程信息 + 视频会议信息。
3. **当前正在进行中的日程(视频会议已结束)**:日程仍在时间窗内、有 `meeting_id`,但步骤 4 判定已结束。展示日程信息 + 视频会议信息(标注「已结束」)。
4. **当前正在进行中的日程(未开启视频会议)**:日程仍在时间窗内,步骤 3 回查无 `meeting_id`。仅展示日程信息。
## 意图 2:查询未来的会议
**只有日程视角**:视频会议只发生在当下和过去,用户说的「未来的会议」等价于「未来的日程」。
```bash
# 二选一:无关键词 → +agenda;有关键词 → +search-event
lark-cli calendar +agenda --start <future_start> --end <future_end>
lark-cli calendar +search-event --query <keyword> --start <future_start> --end <future_end>
# 禁用:vc +search 对未来返回空,容易被误判「没有会议」
# lark-cli vc +search --start <future> --end <future> ← 不要这样做
```
若用户明确要求「未来的视频会议」,仍返回日程列表并**主动说明**:视频会议是否真正开要等到时间到达才能确定。
## 意图 3:查询过去的会议
**目标覆盖**:过去时间段内发生过的视频会议(含即时会议)+ 过去时间段的日程(含未开视频会议的)。
**执行步骤**:
```bash
# 1. 过去的视频会议(含即时会议——仅查日程会漏掉)
lark-cli vc +search --start <past_start> --end <past_end>
# 2. 过去的日程
lark-cli calendar +agenda --start <past_start> --end <past_end>
# 3. 步骤 2 每个日程回查 meeting_id,构建 meeting_id → event_id 映射
# 遍历步骤 1 每条结果,用其 id 字段(即 meeting_id)查此映射:
# 命中 → 日程视频会议;未命中 → 无日程的即时会议
lark-cli calendar +meeting --event-ids <event_id1>,<event_id2>
```
**结果分组**:按三组顺序呈现。
1. **无日程的即时视频会议**:步骤 1 里找不到关联 `event_id`。仅展示视频会议信息。
2. **日程视频会议**:日程 + 关联 `meeting_id`。同时展示日程信息和视频会议信息。
3. **未开视频会议的日程**:日程存在但步骤 3 回查无 `meeting_id`。仅展示日程信息。
## 常见判断路径
| 用户输入 | 动作 |
|----------|------|
| 只给了「会议标题」 | 不确定是日程标题还是即时会议标题,**同时**查 `calendar +search-event --query <标题>` 与 `lark-cli vc +search --query <标题>`(lark-meeting 技能未随包收录,直接用 CLI 命令),交叉后按上述意图分流 |
| 直接给了 `meeting_id` | 直接进入 `lark-cli vc +detail --meeting-ids <meeting_id>`(lark-meeting 技能未随包收录,直接用 CLI 命令),跳过日程 |
| 相对锚点(「今天下午 3 点那个会」) | 先 `+agenda` 定位日程,再按意图 1 或 3 判断 |
| 过去锚点(「昨天开的会」) | **禁止只查 `+agenda`**——必须同时查 `vc +search`,否则漏掉即时会议 |
| 未来锚点(「明天下午的会」) | 只查日程,不查 `vc +search`(未来永远返回空) |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |