seaworld008/lark-workflow-meeting-summary

会议纪要汇总工作流

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理。然后阅读 ../lark-vc/SKILL.md，了解会议纪要相关操作。

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

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

适用场景

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

前置条件

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

lark-cli auth login --domain vc        # 基础（查询+纪要）
lark-cli auth login --domain vc,drive   # 含读取纪要文档正文、生成文档

工作流

{时间范围} ─► 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，在最终输出中标注"无纪要"。
• 记录每个纪要的 note_id（纪要 ID）、note_display_type（展示类型：unknown / normal / unified）、note_doc_token（纪要文档 Token）和 verbatim_doc_token（逐字稿文档 Token）。

逐字稿路由按 note_display_type 决定（详见 vc-domain-boundaries.md 的 Note 域）：

• normal：逐字稿是独立文档，链接/正文走 verbatim_doc_token。
• unified：逐字稿不是独立文档，没有可分享的逐字稿文档链接；需要逐字稿内容时用 note +transcript --note-id <note_id>（lark-note）拉取到本地，报告中标注"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-vc — +search、+detail 详细用法
• lark-note — note +detail、note +transcript（unified 纪要逐字稿）
• lark-doc — +fetch、+create、+update 详细用法

<!-- 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 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.

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