Lark Workflow Meeting Summary

会议纪要汇总工作流

CRITICAL — 开始前 MUST 先完整读取 ../lark-shared/SKILL.md 和 ../lark-meeting/SKILL.md。认证、身份和权限以 lark-shared 为准；会议与产物关系、产物选择和逐字稿路由以 lark-meeting 为准。

适用场景

• "帮我整理这周的会议纪要" / "总结最近的会议" / "生成会议周报"
• "看看今天开了哪些会" / "回顾过去一周开了哪些会"

前置条件

仅支持 user 身份。执行前确保已授权：

lark-cli auth login --domain vc        # 基础（查询+纪要）
lark-cli auth login --domain vc,drive   # 含读取纪要文档正文、生成文档
lark-cli auth login --domain vc,drive,minutes  # 含无 note_id 时的妙记备选路径

工作流

{时间范围} ─► vc +search ──► 会议列表 (meeting_ids)
                   │
                   ▼
               vc +detail ──► 获取 note_id 
                   │
                   ▼
               note +detail ──► 纪要文档 tokens
                   │
                   ▼
               drive metas batch_query 纪要元数据
                   │
                   ▼
               结构化报告

Step 1: 确定时间范围

默认过去 7 天。推断规则："今天"→当天，"这周"→本周一now，"上周"→上周一上周日，"这个月"→1日~now。

注意：日期转换必须调用系统命令（如 date），不要心算。时间范围参数需根据 CLI 实际要求格式化（通常为 YYYY-MM-DD 或 ISO 8601）。

Step 2: 查询会议记录

# page-size 最大为 30
lark-cli vc +search --start "<YYYY-MM-DD>" --end "<YYYY-MM-DD>" --format json --page-size 30

• 时间范围拆分：搜索的时间范围最大为 1 个月。搜索更长时间范围的会议，需要拆分为多次时间范围为一个月查询。
• --end 为包含当天的日期（即查"今天"时 start 和 end 都填今天）
• --format json 输出 JSON 格式，你更佳擅长解析 JSON 数据。
• --page-size 30 每页最多 30 条。
• 有 page_token 时必须继续翻页，收集所有 id 字段（meeting-id）

Step 3: 获取纪要元数据

1. 查询会议关联的纪要信息

# 首先获取 note_id 和 minute_token
lark-cli vc +detail --meeting-ids "id1,id2,...,idN"

# 然后用 note_id 获取文档 tokens（如有多个需分别获取）
lark-cli note +detail --note-id "note_id"

• 根据上一步搜集到的 meeting-id 查询。
• 单次最多查询 50 个，超过 50 个需分批调用。
• 部分会议没有 note_id 或报错 no notes available，不要直接标注"无纪要"：先看 vc +detail 是否返回了 minute_token，有则走下面的妙记备选路径；note_id 和 minute_token 都没有时才标注"无纪要"。
• 记录每个纪要的 note_id（纪要 ID）、note_display_type（展示类型：unknown / normal / unified）、note_doc_token（纪要文档 Token）和 verbatim_doc_token（逐字稿文档 Token）。

妙记备选路径（无 note_id、有 minute_token 时）：智能纪要与妙记是两条独立产物链路，缺少智能纪要不代表这场会没有内容。

# --minute-tokens 是复数形式（+download 同）；--output-dir 只接受相对路径
lark-cli minutes +detail --minute-tokens "<minute_token>" --transcript --output-dir ./transcripts --as user

逐字稿会落盘，供 Step 4 基于原始发言独立提炼（不要照搬 AI 总结）。若返回 No read permission（2091005），先把无权限事实告知用户，用户明确同意后再用单数 flag 申请：lark-cli minutes +apply-permission --minute-token "<minute_token>" --perm view --as user；申请需 owner 在客户端批准后才可重试。详见 基于 minute_token 查询妙记及关联产物。

逐字稿路由按 note_display_type 决定（详见 基于 note_id 查询智能纪要及关联产物）：

• normal：逐字稿是独立文档，链接/正文走 verbatim_doc_token。
• unified：逐字稿不是独立文档，没有可分享的逐字稿文档链接；需要逐字稿内容时用 note +transcript --note-id <note_id>（lark-meeting）拉取到本地，报告中标注"unified 纪要"即可。

2. 获取纪要文档和逐字稿文档链接

# 学习命令使用方式
lark-cli schema drive.metas.batch_query

# 批量获取纪要文档与逐字稿链接: 一次最多查询 10 个文档
# 仅对 note_doc_token 与 normal 纪要的 verbatim_doc_token 查询链接
lark-cli drive metas batch_query --data '{"request_docs": [{"doc_type": "docx", "doc_token": "<doc_token>"}], "with_url": true}'

Step 4: 整理纪要报告

根据时间跨度选择输出格式：

• 单日汇总（"今天"/"昨天"）：用"今日会议概览"标题，逐会议列出会议时间、主题、纪要链接、逐字稿链接（unified 纪要无逐字稿链接，标注"unified 纪要，逐字稿需 note +transcript 拉取"）。
• 多日/周报（"这周"/"过去 7 天"等）：用"会议纪要周报"标题，含概览统计、逐会议详情。

Step 5: 生成文档（可选，用户要求时）

阅读 ../lark-doc/SKILL.md 学习云文档技能。

lark-cli docs +create --doc-format markdown --content $'<title>会议纪要汇总 (<start> - <end>)</title>\n<内容>'
# 或追加到已有文档
lark-cli docs +update --doc "<url_or_token>" --command append --doc-format markdown --content $'<内容>'

参考

• lark-shared — 认证、权限（必读）
• lark-meeting — 会议与产物统一路由
• 查询会议与会议产物 — 搜索、消歧、产物获取与逐字稿分析流程
• 查询妙记及关联产物 — 无 note_id 时的妙记备选路径
• vc +search、vc +detail、note +detail、note +transcript、minutes +detail、minutes +apply-permission — 命令细节
• lark-doc — +fetch、+create、+update 详细用法

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 Workflow Meeting Summary; 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.
• Treat skill selection as routing, not ceremony: invoke only the narrowest applicable workflow and keep user or repository instructions authoritative.