seaworld008/lark-vc

vc (v1)

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

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

1. 了解日历 & VC、会议产物 & 文档的关联关系和职责划分
2. 了解会议产物（妙记和纪要）之间的关联关系，例如：妙记和纪要产生条件相互独立
3. 了解不同会议产物的组成部分，以便根据需求决策使用哪种产物的数据
4. 了解会议总结、分析和信息提取的标准流程

身份

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

# BAD — 查昨天的会议用 calendar，会漏掉即时会议
lark-cli calendar events search_event --query "站会" --start-time ...

# GOOD — 查已结束的会议用 vc +search
lark-cli vc +search --query "站会" --start-time ...

Shortcuts （推荐优先使用）

| Shortcut | 说明 | |----------|------| | +search | 搜索历史会议记录（需至少一个筛选条件） | | +notes | 查询会议纪要和妙记产物（通过 meeting-ids、minute-tokens 或 calendar-event-ids） | | +recording | 通过 meeting-ids 或 calendar-event-ids 查询 minute_token |

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

意图路由

| 用户意图 | 路由到 | |----------|--------| | 查"昨天的会议""上周的会""已结束的会议" | 本 skill（+search，含即时会议） | | 查日历/日程或未来时间的会议 | lark-calendar | | 查"今天有哪些会议" | vc +search（已结束）+ lark-calendar（未开始），合并展示 | | Agent 真实入会/离会、会中实时事件 | lark-vc-agent | | 本地音视频文件转纪要/逐字稿 | 先走 lark-minutes 上传，再回 vc +notes --minute-tokens |

核心概念

• 视频会议（Meeting）：飞书视频会议实例，通过 meeting_id 标识。已结束的会议支持通过关键词、时间段、参会人、组织者、会议室等条件搜索。
• 会议纪要（Note）：视频会议结束后生成的结构化文档，包含纪要文档（总结+待办）和逐字稿文档。
• 妙记（Minutes）：来源于飞书视频会议的录制产物或用户上传的音视频文件，包含总结、待办、章节和文字记录，通过 minute_token 标识。
• 纪要文档（MainDoc）：AI 智能纪要的主文档，包含 AI 生成的总结和待办，对应 note_doc_token。
• 用户会议纪要（MeetingNotes）：用户主动绑定到会议的纪要文档，对应 meeting_notes。仅通过 --calendar-event-ids 路径返回。
• 逐字稿（VerbatimDoc）：会议的逐句文字记录，包含说话人和时间戳。

产物选择决策

| 用户意图 | 必须读取的产物 | 禁止 | |---------|-------------|------| | 提炼/总结/重新总结/整理会议内容/回顾会议 | 逐字稿（verbatim_doc_token）或妙记文字记录（Transcript），基于原始对话独立分析 | 禁止直接搬运 AI 纪要（note_doc_token）的总结作为最终输出 | | 查看待办/章节 | AI 纪要（note_doc_token）或妙记产物 — AI 待办更友好（含提出人和负责人），章节按话题划分更结构化 | — | | 查看纪要链接/文档地址 | 仅返回文档链接，无需读取内容 | — | | 直接看 AI 总结结果 | AI 纪要（note_doc_token） | — | | 谁说了什么/完整发言记录 | 逐字稿（verbatim_doc_token） | — |

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

核心场景

1. 搜索会议记录

1. 仅支持搜索已结束的会议，对于还未开始的未来会议，需要使用 lark-calendar 技能。
2. 仅支持使用关键词、时间段、参会人、组织者、会议室等筛选条件搜索会议记录，对于不支持的筛选条件，需要提示用户。
3. 搜索结果存在多条数据时，务必注意分页数据获取，不要遗漏任何会议记录。

2. 整理会议纪要

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

1. 整理纪要文档时默认给出纪要文档、逐字稿、妙记链接即可，无需读取纪要文档或逐字稿内容。
2. 用户明确需要获取总结、待办、章节产物时，再读取文档获取具体内容。
3. 读取智能纪要（note_doc_token）内容时，纪要文档的第一个 <whiteboard> 标签是封面图（AI 生成的总结可视化），应同时下载展示给用户：

# 1. 读取纪要内容
lark-cli docs +fetch --api-version v2 --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 和 vc +notes --minute-tokens 的默认落点保持一致，便于 Agent 聚合。显式路径（如封面图）需手动对齐到同一目录。

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

• note_doc_token → AI 智能纪要（AI 总结 + 待办）
• meeting_notes → 用户绑定的会议纪要（用户主动关联到会议的文档，仅 --calendar-event-ids 路径返回）
• verbatim_doc_token → 逐字稿（完整的逐句文字记录，含说话人和时间戳）— 用户说"逐字稿""完整记录""谁说了什么"时用这个
• 用户说"纪要""总结""纪要内容"时，应同时返回 note_doc_token 和 meeting_notes（如有）
• 用户意图不明确时，应展示所有文档链接让用户选择，而不是替用户决定
• 如果用户提供的是本地音视频文件并说"转纪要""转逐字稿"，不要直接从 vc +notes 开始；应先用 minutes +upload 生成 minute_url，再提取 minute_token 调用 vc +notes --minute-tokens

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

1. 纪要文档、逐字稿文档与关联的共享文档默认使用文档 Token 返回。
2. 仅需要获取文档名称和 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}'

3. 需要获取文档内容时，使用 lark-cli docs +fetch --api-version v2。

# 获取文档内容
lark-cli docs +fetch --api-version v2 --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 +notes 取 verbatim_doc_token 再 docs +fetch --api-version v2 | 本 skill | | 进行中会议的实时事件流（转写、聊天、共享、会中加入/离开）| vc +meeting-events | lark-vc-agent | | Agent 真实入会 / 离会 | vc +meeting-join / vc +meeting-leave | lark-vc-agent |

资源关系

Meeting (视频会议)
├── Note (会议纪要)
│   ├── MainDoc (AI 智能纪要文档, note_doc_token)
│   ├── MeetingNotes (用户绑定的会议纪要文档, meeting_notes)
│   ├── VerbatimDoc (逐字稿, verbatim_doc_token)
│   └── SharedDoc (会中共享文档)
└── Minutes (妙记) ← minute_token 标识，+recording 从 meeting_id 获取
    ├── Transcript (文字记录)
    ├── Summary (总结)
    ├── Todos (待办)
    ├── Chapters (章节)
    └── Keywords (推荐关键词)

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}'

minutes（跨域，详见 lark-minutes）

• get — 获取妙记基础信息（标题、时长、封面）；查询妙记内容请用 +notes --minute-tokens <minute-token>

不在本 skill 范围

• 查询未来的会议日程 → lark-calendar
• Agent 真实入会/离会、会中实时事件 → lark-vc-agent
• 本地音视频文件转纪要/逐字稿 → lark-minutes（上传后回 vc +notes）
• 妙记搜索/下载/上传/重命名/替换说话人 → lark-minutes

<!-- LOCAL-QUALITY-SUPPLEMENT:START -->

Usage Notes

This supplement is maintained by the repository sync pipeline. It keeps the imported upstream skill usable inside this curated collection when the upstream source is intentionally concise.

Common Patterns

1. Confirm that the user's task matches the skill trigger.
2. Read the relevant project files or user-provided context before acting.
3. Choose the smallest reversible action that advances the task.
4. Run the verification command or manual check that proves the result.
5. Report the outcome, evidence, and any remaining risk.

Boundaries

• Prefer the upstream workflow for Lark Vc; this section only adds local quality guardrails.
• Do not invent project facts when required files, vaults, services, or tools are unavailable.
• Stop and ask for clarification when the next action could overwrite user work, expose private data, or change production state.

<!-- LOCAL-QUALITY-SUPPLEMENT:END -->