SKILL.md

vc (v1)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理

CRITICAL — 开始前 MUST 先用 Read 工具读取 references/vc-domain-boundaries.md，不读将导致命令使用、会议产物决策、领域边界职责判断错误：

了解日历 & VC、会议产物 & 文档的关联关系和职责划分

了解会议产物（妙记和纪要）之间的关联关系，例如：妙记和纪要产生条件相互独立

了解不同会议产物的组成部分，以便根据需求决策使用哪种产物的数据

了解会议总结、分析和信息提取的标准流程

身份

所有 vc 命令默认使用 --as user。+search 和 meeting get 也支持 --as bot。

# BAD — 查昨天的会议用 calendar，会漏掉即时会议

lark-cli calendar +search-event --query "站会" --start <start_time> --end <end_time>

GOOD — 查已结束的会议用 vc +search

lark-cli vc +search --query "站会" --start <start_time> --end <end_time>

## Shortcuts （推荐优先使用）

| Shortcut | 说明 |

|----------|------|

| [`+search`](references/lark-vc-search.md) | 搜索历史会议记录（需至关键词、时间范围、组织者、参与者、会议室少一个筛选条件） |

| [`+detail`](references/lark-vc-detail.md) | 通过 meeting-ids 获取会议详情，包括 note_id 和 minute_token |

| [`+recording`](references/lark-vc-recording.md) | 通过 meeting-ids 或 calendar-event-ids 查询 minute_token |

- 使用任何 Shortcut 前，必须先读其对应 reference 文档。

## 意图路由

| 用户意图 | 路由到 |

|----------|--------|

| 查"昨天的会议""上周的会""已结束的会议" | 本 skill（`+search`，含即时会议） |

| 查日历/日程或未来时间的会议 | [lark-calendar](../lark-calendar/SKILL.md) |

| 查"今天有哪些会议" | `vc +search`（已结束）+ lark-calendar（未开始），合并展示 |

| 只按自然语言标题查"xx 纪要的逐字稿 / 原始记录 / 谁说了什么" | 先到 [lark-drive](../lark-drive/SKILL.md) / [lark-doc](../lark-doc/SKILL.md)；仅在已拿到 `note_id` / `vc-node-id` 后再到 [lark-note](../lark-note/SKILL.md) |

| Agent 真实入会/离会、会中实时事件 | [lark-vc-agent](../lark-vc-agent/SKILL.md) |

| 妙记信息/时长/封面/链接 | 先走 `vc +detail` 或 `vc +recording` 获取 `minute_token`，再用 [lark-minutes](../lark-minutes/SKILL.md) 的 `minutes get` |

| 本地音视频文件转纪要/逐字稿 | 先走 [lark-minutes](../lark-minutes/SKILL.md) 上传，再用 `minutes +detail --minute-tokens` |

## 核心概念

- **视频会议（Meeting）**：飞书视频会议实例，通过 meeting_id 标识。已结束的会议支持通过关键词、时间段、参会人、组织者、会议室等条件搜索（见 `+search`）。

- **会议纪要（Note）**：视频会议结束后生成的结构化文档，通过 `note_id` 标识，包含纪要文档（总结、待办）和逐字稿文档。`note_display_type` 区分**普通纪要（`normal`）**和 **unified 纪要**；已知 `note_id` 的直查与 unified 原始记录请用 [lark-note](../lark-note/SKILL.md)。

- **妙记（Minutes）**：来源于飞书视频会议的录制产物或用户上传的音视频文件，支持视频/音频的转写，包含总结、待办、章节和文字记录，通过 minute_token 标识。

- **纪要文档（MainDoc）**：AI 智能纪要的主文档，包含 AI 生成的总结和待办，对应 `note_doc_token`。

- **用户会议纪要（MeetingNotes）**：用户主动绑定到日程的纪要文档，对应 `meeting_note`。需先通过 [`calendar +meeting`](../lark-calendar/references/lark-calendar-meeting.md) 由 `event_id` 获取。

- **逐字稿（VerbatimDoc）**：会议的逐句文字记录，包含说话人和时间戳。

## 产物选择决策

| 用户意图 | 必须读取的产物 | 禁止 |

|---------|-------------|------|

| 提炼/总结/重新总结/整理会议内容/回顾会议 | 为降低 token 消耗，非必须不得获取 AI 纪要。必须使用原始对话记录（按下方逐字稿路由取得）或妙记文字记录（Transcript），基于原始对话独立分析 | 禁止直接搬运 AI 纪要（`note_doc_token`）的总结作为最终输出 |

| 查看待办/章节 | AI 纪要（`note_doc_token`）或妙记产物 — AI 待办更友好（含提出人和负责人），章节按话题划分更结构化 | — |

| 查看纪要链接/文档地址 | 仅返回文档链接，无需读取内容 | — |

| 直接看 AI 总结结果 | AI 纪要（`note_doc_token`） | — |

| 谁说了什么/完整发言记录 | 原始对话记录（按下方逐字稿路由取得） | — |

> **逐字稿路由**：先用 `vc +detail` 拿到 `note_id`，再 [`note +detail`](../lark-note/SKILL.md) 看 `note_display_type`，**不要只看 `verbatim_doc_token` 是否为空**。具体路由以 [lark-note](../lark-note/SKILL.md) 的 `note_display_type` 规则为准。

>

> **为什么"提炼/总结"必须从原始对话记录出发？** AI 纪要是模型对会议的二次压缩，可能遗漏讨论细节、争论过程和隐含决策。用户要求"提炼"或"重新总结"时，期望的是基于原始对话的独立分析，而非对 AI 产物的重新排版。

## 核心场景

### 1. 搜索会议记录

1. 仅支持搜索已结束的会议，对于还未开始的未来会议，需要使用 lark-calendar 技能。

2. 仅支持使用关键词、时间段、参会人、组织者、会议室等筛选条件搜索会议记录，对于不支持的筛选条件，需要提示用户。

3. 搜索结果存在多条数据时，务必注意分页数据获取，不要遗漏任何会议记录。

4. 只有自然语言纪要标题、没有会议线索时，不要把标题当会议关键词；按上方意图路由切到文档搜索。

### 2. 整理会议纪要

> 在选择读取哪个产物前，先确认你理解 AI 总结链路 vs 录制链路的区别。如不确定，先读 [`references/vc-domain-boundaries.md`](references/vc-domain-boundaries.md)。

1. 整理纪要文档时默认给出纪要文档、逐字稿、妙记链接即可，无需读取纪要文档或逐字稿内容。

2. 用户明确需要获取总结、待办、章节产物时，再读取文档获取具体内容。

3. 读取智能纪要（`note_doc_token`）内容时，纪要文档的**第一个 `<whiteboard>`** 标签是封面图（AI 生成的总结可视化），应同时下载展示给用户：

1. 读取纪要内容

lark-cli docs +fetch --doc <note_doc_token> --doc-format markdown

2. 从返回的 markdown 中提取第一个 <whiteboard token="xxx"/> 的 token

3. 下载封面图到聚合目录（和逐字稿、录像同目录，保持产物归拢）

并非所有纪要都有封面画板，没有 <whiteboard> 标签时跳过即可

lark-cli docs +media-download --type whiteboard --token <whiteboard_token> --output ./minutes/<minute_token>/cover


**产物目录规范**：同一会议的所有下载产物（录像、逐字稿、封面图等）统一放到 `./minutes/{minute_token}/` 目录下。这与 `minutes +download` 和 `minutes +detail --minute-tokens` 的默认落点保持一致，便于 Agent 聚合。显式路径（如封面图）需手动对齐到同一目录。

**纪要相关文档 — 根据用户意图选择：**

- `note_doc_token` → **AI 智能纪要**（AI 总结 + 待办），由 `note +detail --note-id <note_id>` 返回

- `meeting_note` → **用户绑定到日程的会议纪要**，由 [calendar +meeting --event-ids ](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-calendar/references/lark-calendar-meeting.md) 返回

- 用户说"逐字稿""完整记录""谁说了什么"时 → 按 `note_display_type` 路由，详见 [lark-note](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-note/SKILL.md)

- 用户说"纪要""总结""纪要内容"时，应同时返回 `note_doc_token` 和 `meeting_note`（如有）

- 用户意图不明确时，应展示所有文档链接让用户选择，而不是替用户决定

- 如果用户提供的是**本地音视频文件**并说"转纪要""转逐字稿"，不要直接从 `vc +detail` 开始；应先用 [minutes +upload](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-minutes/references/lark-minutes-upload.md) 生成 `minute_url`，再提取 `minute_token` 调用 `minutes +detail --minute-tokens`

### 3. 纪要文档与逐字稿链接

- 纪要文档、逐字稿文档与关联的共享文档默认使用文档 Token 返回。

- 仅需要获取文档名称和 URL 等基本信息时，使用 `lark-cli drive metas batch_query` 查询

学习命令使用方式

lark-cli schema drive.metas.batch_query

批量获取文档基本信息: 一次最多查询 10 个文档

lark-cli drive metas batch_query --data '{"request_docs": [{"doc_type": "docx", "doc_token": "<doc_token>"}], "with_url": true}'


- 需要获取文档内容时，使用 `lark-cli docs +fetch`。

获取文档内容

lark-cli docs +fetch --doc <doc_token> --doc-format markdown


### 4. 查询参会人快照（读操作）

用户问"谁参加过这场会议""这个会议有哪些参会人""某某参会了吗"等**参会人快照**类问题时，使用 **`vc meeting get --with-participants`**：这是参会人服务端快照 API，不依赖 bot 身份参会，**已结束会议也可查**：

lark-cli vc meeting get --params '{"meeting_id":"<meeting_id>","with_participants":true}'


选型判断表：

| 用户意图 | 推荐命令 | 所在 skill |
| --- | --- | --- |
| 参会人快照（谁参加过、何时入/离会，任意时点） | `vc meeting get --with-participants` | 本 skill |
| 已结束会议的发言内容 | 优先：`vc +detail` 取 `note_id` 再 `note +detail` 取 `verbatim_doc_token` 后 `docs +fetch`；备选：`vc +detail` 取 `minute_token` 再 `minutes +detail --transcript` | [lark-note](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-note/SKILL.md) / [lark-minutes](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-minutes/SKILL.md) |
| **进行中会议**的实时事件流（转写、聊天、共享、会中加入/离开） | `vc +meeting-events` | [lark-vc-agent](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-vc-agent/SKILL.md) |
| **Agent 真实入会 / 离会** | `vc +meeting-join` / `vc +meeting-leave` | [lark-vc-agent](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-vc-agent/SKILL.md) |

## 资源关系

Meeting (视频会议)

├── Note (会议纪要) ← note_id 标识，note_display_type: normal / unified

│ ├── MainDoc (AI 智能纪要文档, note_doc_token)

│ ├── MeetingNotes (用户绑定的会议纪要文档, meeting_notes)

│ ├── VerbatimDoc (逐字稿, verbatim_doc_token) ← normal 路径

│ ├── UnifiedTranscript (unified 原始记录) ← unified 路径，note +transcript（lark-note）

│ └── SharedDoc (会中共享文档)

└── Minutes (妙记) ← minute_token 标识，由 vc +detail 或 vc +recording 桥接获取，产物详情走 [lark-minutes](../lark-minutes/SKILL.md)

├── Transcript (文字记录)

├── Summary (总结)

├── Todos (待办)

├── Chapters (章节)

└── Keywords (推荐关键词)


**MeetingNotes 边界**：用户绑定到日程的会议纪要文档（`meeting_note`）属于日程域，不在 VC 资源关系内；从 `event_id` 用 [calendar +meeting](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-calendar/references/lark-calendar-meeting.md) 获取。

**妙记边界**：`+recording` 仅负责把 `meeting_id` / `calendar_event_id` 桥接到 `minute_token`；妙记的总结/待办/章节/逐字稿等产物归 [lark-minutes](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-minutes/SKILL.md)（`minutes +detail`）。

**Note 域边界**：VC 域只负责把 `meeting_id` 转成 `note_id` / `minute_token`，纪要详情归 [lark-note](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-note/SKILL.md)。

- 入口选择：从 `meeting_id` 出发用 `vc +detail` 拿 `note_id` 和 `minute_token`；从 `minute_token` 出发用 [minutes +detail](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-minutes/references/lark-minutes-detail.md) 也会返回关联的 `note_id`，可继续走 `note +detail` 拿纪要文档 token。

- 已有 `note_id` → 直接走 [note +detail](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-note/SKILL.md) / [note +transcript](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-note/SKILL.md)，不要绕回 VC。

- 已有 `doc_token` 且目标是读正文 → [lark-doc](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-doc/SKILL.md)。

- 只有自然语言纪要标题 → 文档搜索 / Docx 正文读取；有显式 `vc-node-id` 才进入 [lark-note](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-note/SKILL.md)。

- 从日程出发（只有 `event_id`）→ 先走 [calendar +meeting](https://github.com/larksuite/cli/blob/HEAD/skills/lark-vc/../lark-calendar/references/lark-calendar-meeting.md) 拿到 `meeting_id` 或 `meeting_note`，再按上述路径继续。

## API Resources

lark-cli vc <resource> <method> [flags]


### meeting

- `get` — 获取会议详情（主题、时间、参会人、note_id）

获取会议基础信息（不含参会人）

lark-cli vc meeting get --params '{"meeting_id": "<meeting_id>"}'

获取会议基础信息（含参会人）

lark-cli vc meeting get --params '{"meeting_id": "<meeting_id>", "with_participants": true}'

lark-vc