$npx -y skills add larksuite/cli --skill lark-workflow-meeting-summary会议纪要整理工作流:汇总指定时间范围内的会议纪要并生成结构化报告。当用户需要整理会议纪要、生成会议周报、回顾一段时间内的会议内容时使用。
| 1 | # 会议纪要汇总工作流 |
| 2 | |
| 3 | **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md),其中包含认证、权限处理**。然后阅读 [`../lark-vc/SKILL.md`](../lark-vc/SKILL.md),了解会议纪要相关操作。 |
| 4 | |
| 5 | **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-vc/references/vc-domain-boundaries.md`](../lark-vc/references/vc-domain-boundaries.md)**,不读将导致命令使用、会议产物决策、领域边界职责判断错误: |
| 6 | > 1. 了解日历 & VC、会议产物 & 文档的关联关系和职责划分 |
| 7 | > 2. 了解会议产物(妙记和纪要)之间的关联关系,例如:**妙记和纪要产生条件相互独立** |
| 8 | > 3. 了解不同会议产物的组成部分,以便根据需求决策使用哪种产物的数据 |
| 9 | > 4. 了解会议总结、分析和信息提取的标准流程 |
| 10 | |
| 11 | ## 适用场景 |
| 12 | |
| 13 | - "帮我整理这周的会议纪要" / "总结最近的会议" / "生成会议周报" |
| 14 | - "看看今天开了哪些会" / "回顾过去一周开了哪些会" |
| 15 | |
| 16 | ## 前置条件 |
| 17 | |
| 18 | 仅支持 **user 身份**。执行前确保已授权: |
| 19 | |
| 20 | ```bash |
| 21 | lark-cli auth login --domain vc # 基础(查询+纪要) |
| 22 | lark-cli auth login --domain vc,drive # 含读取纪要文档正文、生成文档 |
| 23 | ``` |
| 24 | |
| 25 | ## 工作流 |
| 26 | |
| 27 | ``` |
| 28 | {时间范围} ─► vc +search ──► 会议列表 (meeting_ids) |
| 29 | │ |
| 30 | ▼ |
| 31 | vc +detail ──► 获取 note_id |
| 32 | │ |
| 33 | ▼ |
| 34 | note +detail ──► 纪要文档 tokens |
| 35 | │ |
| 36 | ▼ |
| 37 | drive metas batch_query 纪要元数据 |
| 38 | │ |
| 39 | ▼ |
| 40 | 结构化报告 |
| 41 | ``` |
| 42 | |
| 43 | ### Step 1: 确定时间范围 |
| 44 | |
| 45 | 默认**过去 7 天**。推断规则:"今天"→当天,"这周"→本周一~now,"上周"→上周一~上周日,"这个月"→1日~now。 |
| 46 | |
| 47 | > **注意**:日期转换必须调用系统命令(如 `date`),不要心算。时间范围参数需根据 CLI 实际要求格式化(通常为 `YYYY-MM-DD` 或 ISO 8601)。 |
| 48 | |
| 49 | ### Step 2: 查询会议记录 |
| 50 | |
| 51 | ```bash |
| 52 | # page-size 最大为 30 |
| 53 | lark-cli vc +search --start "<YYYY-MM-DD>" --end "<YYYY-MM-DD>" --format json --page-size 30 |
| 54 | ``` |
| 55 | |
| 56 | - 时间范围拆分:搜索的时间范围最大为 1 个月。搜索更长时间范围的会议,需要拆分为多次时间范围为一个月查询。 |
| 57 | - `--end` 为**包含当天**的日期(即查"今天"时 start 和 end 都填今天) |
| 58 | - `--format json` 输出 JSON 格式,你更佳擅长解析 JSON 数据。 |
| 59 | - `--page-size 30` 每页最多 30 条。 |
| 60 | - 有 `page_token` 时必须继续翻页,收集所有 `id` 字段(meeting-id) |
| 61 | |
| 62 | ### Step 3: 获取纪要元数据 |
| 63 | |
| 64 | 1. 查询会议关联的纪要信息 |
| 65 | ```bash |
| 66 | # 首先获取 note_id 和 minute_token |
| 67 | lark-cli vc +detail --meeting-ids "id1,id2,...,idN" |
| 68 | |
| 69 | # 然后用 note_id 获取文档 tokens(如有多个需分别获取) |
| 70 | lark-cli note +detail --note-id "note_id" |
| 71 | ``` |
| 72 | - 根据上一步搜集到的 `meeting-id` 查询。 |
| 73 | - 单次最多查询 50 个,超过 50 个需分批调用。 |
| 74 | - 部分会议没有 `note_id` 或报错 `no notes available`,在最终输出中标注"无纪要"。 |
| 75 | - 记录每个纪要的 `note_id`(纪要 ID)、`note_display_type`(展示类型:`unknown` / `normal` / `unified`)、`note_doc_token`(纪要文档 Token)和 `verbatim_doc_token`(逐字稿文档 Token)。 |
| 76 | |
| 77 | > **逐字稿路由按 `note_display_type` 决定**(详见 [vc-domain-boundaries.md](../lark-vc/references/vc-domain-boundaries.md) 的 Note 域): |
| 78 | > - `normal`:逐字稿是独立文档,链接/正文走 `verbatim_doc_token`。 |
| 79 | > - `unified`:逐字稿**不是独立文档**,没有可分享的逐字稿文档链接;需要逐字稿内容时用 `note +transcript --note-id <note_id>`([lark-note](../lark-note/SKILL.md))拉取到本地,报告中标注"unified 纪要"即可。 |
| 80 | |
| 81 | 2. 获取纪要文档和逐字稿文档链接 |
| 82 | ```bash |
| 83 | # 学习命令使用方式 |
| 84 | lark-cli schema drive.metas.batch_query |
| 85 | |
| 86 | # 批量获取纪要文档与逐字稿链接: 一次最多查询 10 个文档 |
| 87 | # 仅对 note_doc_token 与 normal 纪要的 verbatim_doc_token 查询链接 |
| 88 | lark-cli drive metas batch_query --data '{"request_docs": [{"doc_type": "docx", "doc_token": "<doc_token>"}], "with_url": true}' |
| 89 | ``` |
| 90 | |
| 91 | ### Step 4: 整理纪要报告 |
| 92 | |
| 93 | 根据时间跨度选择输出格式: |
| 94 | |
| 95 | - **单日汇总**("今天"/"昨天"):用"今日会议概览"标题,逐会议列出会议时间、主题、纪要链接、逐字稿链接(`unified` 纪要无逐字稿链接,标注"unified 纪要,逐字稿需 `note +transcript` 拉取")。 |
| 96 | - **多日/周报**("这周"/"过去 7 天"等):用"会议纪要周报"标题,含概览统计、逐会议详情。 |
| 97 | |
| 98 | ### Step 5: 生成文档(可选,用户要求时) |
| 99 | |
| 100 | 阅读 [`../lark-doc/SKILL.md`](../lark-doc/SKILL.md) 学习云文档技能。 |
| 101 | |
| 102 | ```bash |
| 103 | lark-cli docs +create --doc-format markdown --content $'<title>会议纪要汇总 (<start> - <end>)</title>\n<内容>' |
| 104 | # 或追加到已有文档 |
| 105 | lark-cli docs +update --doc "<url_or_token>" --command append --doc-format markdown --content $'<内容>' |
| 106 | ``` |
| 107 | |
| 108 | ## 参考 |
| 109 | |
| 110 | - [lark-shared](../lark-shared/SKILL.md) — 认证、权限(必读) |
| 111 | - [lark-vc](../lark-vc/SKILL.md) — `+search`、`+detail` 详细用法 |
| 112 | - [lark-note](../lark-note/SKILL.md) — `note +detail`、`note +transcript`(unified 纪要逐字稿) |
| 113 | - [lark-doc](../lark-doc/SKILL.md) — `+fetch`、`+create`、`+update` 详细用法 |