lark-minutes

Name: lark-minutes
Author: larksuite

379kinstalls1.1kforks

How to install lark-minutes?

larksuite/cli/lark-minutes

$npx -y skills add larksuite/cli --skill lark-minutes

Installs into the current project.

Summary

飞书妙记：搜索妙记、查看妙记基础信息、下载/上传音视频、读取或编辑妙记的产物内容、改标题、替换说话人/关键词、申请妙记查看/编辑权限。当给出minute_token、本地音视频文件，要查/改/转妙记产物，或用户明确要主动申请妙记权限时使用；本地音视频转纪要/逐字稿优先走本 skill，不要用 ffmpeg/whisper 本地转写。不负责：获取会议关联妙记，或仅按自然语言标题定位纪要

Files · 1

View on GitHub

SKILL.md

1	# minutes (v1)
2
3	CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/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	所有 minutes 命令默认使用 `--as user`。
14
15	## Shortcuts
16
17	\| Shortcut \| 说明 \|
18	\|----------\|------\|
19	\| [`+search`](references/lark-minutes-search.md) \| 按关键词、所有者、参与者、时间范围搜索妙记 \|
20	\| [`+detail`](references/lark-minutes-detail.md) \| 查询妙记详情(标题和关联的纪要note_id)，按需获取 AI 产物（总结、待办、章节、逐字稿、关键词） \|
21	\| [`+download`](references/lark-minutes-download.md) \| 下载妙记音视频媒体文件 \|
22	\| [`+upload`](references/lark-minutes-upload.md) \| 上传 file_token 生成妙记 \|
23	\| [`+update`](references/lark-minutes-update.md) \| 更新妙记标题 \|
24	\| `+apply-permission` \| 申请妙记查看或编辑权限 \|
25	\| [`+speaker-replace`](references/lark-minutes-speaker-replace.md) \| 替换妙记逐字稿中的说话人（须先 `lark-cli api GET .../speakerlist` 取 `speaker_id`） \|
26	\| `+word-replace` \| 批量替换逐字稿关键词（详见 `lark-cli minutes +word-replace --help`） \|
27	\| [`+summary`](references/lark-minutes-summary.md) \| 替换妙记 AI 总结全文 \|
28	\| [`+todo`](references/lark-minutes-todo.md) \| 新建/更新/删除妙记 AI 待办（单条或 `--todos` 批量；不是 lark-task） \|
29
30	- 使用任何 Shortcut 前，必须先读其对应 reference 文档。
31
32	## 意图路由
33
34	\| 用户意图 \| 命令 \|
35	\|---------\|------\|
36	\| 我的妙记 / 搜索妙记 / 某段时间的妙记 \| `+search` \|
37	\| 妙记基础信息：标题 / 时长 / 封面 / 链接 \| `minutes get` \|
38	\| 下载妙记音视频文件、获取媒体下载链接 \| `+download`（仅媒体；要妙记内容用 `+detail`） \|
39	\| 妙记总结 / 章节 / 待办 / 关键词 / 逐字稿 \| `+detail --minute-tokens <token>` + 显式产物 flag \|
40	\| 基于妙记提炼/总结/分析/回顾会议 \| `+detail --minute-tokens <token> --transcript`，再独立分析（禁止照搬 AI 总结） \|
41	\| 拿这条妙记关联的纪要文档（`note_doc_token` / `verbatim_doc_token` / `shared_doc_tokens`） \| `+detail` 取顶层 `note_id` → [`note +detail --note-id`](../lark-note/SKILL.md) \|
42	\| 把本地音视频转纪要 / 逐字稿 / 文字稿 \| `drive +upload` 取 `file_token` → `+upload` 生成 `minute_url` → `+detail` 拿产物 \|
43	\| 在妙记里增加 / 更改 / 删除 AI 待办 \| `+todo`（禁止走 lark-task） \|
44	\| 替换妙记的AI 总结 \| `+summary` \|
45	\| 重命名妙记/改妙记标题 \| `+update` \|
46	\| 申请妙记权限（查看/编辑） \| `+apply-permission --perm view\\|edit` \|
47	\| 替换说话人/把 A 的发言改成 B/重新归属发言人/把外部（非飞书）说话人改成飞书用户" \| 先 `lark-cli api GET .../transcript/speakerlist` 取 `speaker_id`，再 [`minutes +speaker-replace`](references/lark-minutes-speaker-replace.md)；`--from-speaker-id` 只传 id，不传展示名 \|
48	\| 批量替换逐字稿关键词 \| `+word-replace` \|
49	\| 用户同时提到"会议/开会"和"妙记" \| 先 [lark-vc](../lark-vc/SKILL.md)（`+search` → `+recording`）获取 `minute_token`，再本 skill \|
50
51	## 核心概念
52
53	- 妙记（Minutes）：来源于飞书视频会议的录制产物或用户上传的音视频文件，通过 `minute_token` 标识。
54	- 妙记 Token（minute_token）：妙记的唯一标识符，可从妙记 URL 末尾提取（如 `https://*.feishu.cn/minutes/obcnxxx` 中的 `obcnxxx`）。如果 URL 中包含额外参数（如 `?xxx`），截取路径最后一段。
55
56	## 核心场景
57
58	### 1. 搜索妙记
59
60	1. 如果是会议的妙记，应优先通过 [lark-vc](../lark-vc/SKILL.md) 定位会议并获取 `minute_token`。
61	2. 会议场景的妙记路由，以及"参与的妙记"如何解释，统一以 [minutes +search](references/lark-minutes-search.md) 为准。
62
63
64	### 2. 查看妙记基础信息
65
66	1. 当用户只需要确认某条妙记的标题、封面、时长、所有者、URL 等基础信息时，使用 `minutes minutes get`。
67	2. 如果是会议 / 日程上下文中的妙记基础信息，先通过 VC/Calendar 链路拿到 `minute_token`，再调用 `minutes minutes get`。
68	3. 用户意图不明确时，默认先给基础元信息，帮助确认是否命中目标妙记。
69
70	### 3. 申请妙记权限
71
72	遇到妙记没有查看或编辑权限时，引导用户申请对应权限；只有用户明确要申请时，才调用 `minutes +apply-permission`。
73
74	只有当用户明确要求"申请查看权限"、"申请编辑权限"、"帮我申请这条妙记权限"时，才调用：
75
76	```bash
77	lark-cli minutes +apply-permission --minute-token <token> --perm view\|edit
78	```
79
80	这是向妙记所有者发起权限申请，不代表立即获得权限。
81
82	安全约束：遇到无权限错误时，不要自动调用 `+apply-permission`；先把无权限事实告知用户，只有用户明确要求申请权限时才发起申请。
83
84	### 4. 上传音视频文件生成妙记（并可继续获取纪要 / 逐字稿）
85
86	1. 当用户说"把音视频文件转成纪要""把录音转成逐字稿/文字稿/撰写文字""把 mp4/mp3 转成总结/待办/章节"时，也先走这个入口。
87	2. 处理流程：
88	- 上传音视频获取 `file_token`：使用 [`lark-cli drive +upload`](../lark-drive/references/lark-drive-upload.md) 上传本地文件到云空间（云盘/云存储）并获取 `file_token`。
89	- 生成妙记：获取到 `file_token` 后，调用 [`lark-cli minutes +upload`](references/lark-minutes-upload.md) 将文件转换为妙记并获取 `minute_url` 链接。
90	- 继续获取纪要 / 逐字稿（按需）：如果用户目标不是只要妙记链接，而是要纪要、逐字稿、总结、待办或章节，则从 `minute_url` 中提取 `minute_token`，再调用 [`lark-cli minutes +detail --minute-tokens`](references/lark-minutes-detail.md) 获取对应产物。
91
92	> 注意：必须先获取飞书云空间（云盘/云存储）的 `file_token` 才能进行转换。
93	>
94	> 不要误走本地转写工具：当用户目标是把本地音视频文件转成纪要、逐字稿、文字稿、撰写文字时，不要改用 `ffmpeg`、`whisper` 或其他本地 ASR/转码命令；标准路径就是 `drive +upload -> minutes +upload -> minutes +detail --minute-tokens`。
95
96	### 5. 编辑妙记的 AI 待办与 AI 总结（写入）
97
98	当用户要在某条妙记内操作 AI 待办或 AI 总结时使用本节。不是飞书任务（Task）清单里的待办。
99
100	触发信号（任一命中即走本 skill，禁止走 lark-task）：
101
102	- "在（某条）妙记里新建 / 添加 / 修改 / 删除待办"
103	- "把妙记 A 的待办改成已完成 / 未完成"
104	- "妙记里的任务1 / 任务2"（上下文已明确是妙记）
105	- 已给出 `minute_token` 或妙记 URL，且要改待办 / 总结
106
107	妙记 AI 待办 vs 飞书任务 Task：
108
109	\| 用户意图 \| 正确命令 \| 错误命令 \|
110	\|---------\|---------\|---------\|
111	\| 妙记里加待办 \| `minutes +todo --operation add` 或 `--todos '[...]'` \| `task +c

People who liked this also viewed

6 picks

Type

lark-minutes

379kinstalls1.1kforks

View on GitHub

How to install lark-minutes?

larksuite/cli/lark-minutes

$npx -y skills add larksuite/cli --skill lark-minutes

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# minutes (v1)
2
3	CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/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	所有 minutes 命令默认使用 `--as user`。
14
15	## Shortcuts
16
17	\| Shortcut \| 说明 \|
18	\|----------\|------\|
19	\| [`+search`](references/lark-minutes-search.md) \| 按关键词、所有者、参与者、时间范围搜索妙记 \|
20	\| [`+detail`](references/lark-minutes-detail.md) \| 查询妙记详情(标题和关联的纪要note_id)，按需获取 AI 产物（总结、待办、章节、逐字稿、关键词） \|
21	\| [`+download`](references/lark-minutes-download.md) \| 下载妙记音视频媒体文件 \|
22	\| [`+upload`](references/lark-minutes-upload.md) \| 上传 file_token 生成妙记 \|
23	\| [`+update`](references/lark-minutes-update.md) \| 更新妙记标题 \|
24	\| `+apply-permission` \| 申请妙记查看或编辑权限 \|
25	\| [`+speaker-replace`](references/lark-minutes-speaker-replace.md) \| 替换妙记逐字稿中的说话人（须先 `lark-cli api GET .../speakerlist` 取 `speaker_id`） \|
26	\| `+word-replace` \| 批量替换逐字稿关键词（详见 `lark-cli minutes +word-replace --help`） \|
27	\| [`+summary`](references/lark-minutes-summary.md) \| 替换妙记 AI 总结全文 \|
28	\| [`+todo`](references/lark-minutes-todo.md) \| 新建/更新/删除妙记 AI 待办（单条或 `--todos` 批量；不是 lark-task） \|
29
30	- 使用任何 Shortcut 前，必须先读其对应 reference 文档。
31
32	## 意图路由
33
34	\| 用户意图 \| 命令 \|
35	\|---------\|------\|
36	\| 我的妙记 / 搜索妙记 / 某段时间的妙记 \| `+search` \|
37	\| 妙记基础信息：标题 / 时长 / 封面 / 链接 \| `minutes get` \|
38	\| 下载妙记音视频文件、获取媒体下载链接 \| `+download`（仅媒体；要妙记内容用 `+detail`） \|
39	\| 妙记总结 / 章节 / 待办 / 关键词 / 逐字稿 \| `+detail --minute-tokens <token>` + 显式产物 flag \|
40	\| 基于妙记提炼/总结/分析/回顾会议 \| `+detail --minute-tokens <token> --transcript`，再独立分析（禁止照搬 AI 总结） \|
41	\| 拿这条妙记关联的纪要文档（`note_doc_token` / `verbatim_doc_token` / `shared_doc_tokens`） \| `+detail` 取顶层 `note_id` → [`note +detail --note-id`](../lark-note/SKILL.md) \|
42	\| 把本地音视频转纪要 / 逐字稿 / 文字稿 \| `drive +upload` 取 `file_token` → `+upload` 生成 `minute_url` → `+detail` 拿产物 \|
43	\| 在妙记里增加 / 更改 / 删除 AI 待办 \| `+todo`（禁止走 lark-task） \|
44	\| 替换妙记的AI 总结 \| `+summary` \|
45	\| 重命名妙记/改妙记标题 \| `+update` \|
46	\| 申请妙记权限（查看/编辑） \| `+apply-permission --perm view\\|edit` \|
47	\| 替换说话人/把 A 的发言改成 B/重新归属发言人/把外部（非飞书）说话人改成飞书用户" \| 先 `lark-cli api GET .../transcript/speakerlist` 取 `speaker_id`，再 [`minutes +speaker-replace`](references/lark-minutes-speaker-replace.md)；`--from-speaker-id` 只传 id，不传展示名 \|
48	\| 批量替换逐字稿关键词 \| `+word-replace` \|
49	\| 用户同时提到"会议/开会"和"妙记" \| 先 [lark-vc](../lark-vc/SKILL.md)（`+search` → `+recording`）获取 `minute_token`，再本 skill \|
50
51	## 核心概念
52
53	- 妙记（Minutes）：来源于飞书视频会议的录制产物或用户上传的音视频文件，通过 `minute_token` 标识。
54	- 妙记 Token（minute_token）：妙记的唯一标识符，可从妙记 URL 末尾提取（如 `https://*.feishu.cn/minutes/obcnxxx` 中的 `obcnxxx`）。如果 URL 中包含额外参数（如 `?xxx`），截取路径最后一段。
55
56	## 核心场景
57
58	### 1. 搜索妙记
59
60	1. 如果是会议的妙记，应优先通过 [lark-vc](../lark-vc/SKILL.md) 定位会议并获取 `minute_token`。
61	2. 会议场景的妙记路由，以及"参与的妙记"如何解释，统一以 [minutes +search](references/lark-minutes-search.md) 为准。
62
63
64	### 2. 查看妙记基础信息
65
66	1. 当用户只需要确认某条妙记的标题、封面、时长、所有者、URL 等基础信息时，使用 `minutes minutes get`。
67	2. 如果是会议 / 日程上下文中的妙记基础信息，先通过 VC/Calendar 链路拿到 `minute_token`，再调用 `minutes minutes get`。
68	3. 用户意图不明确时，默认先给基础元信息，帮助确认是否命中目标妙记。
69
70	### 3. 申请妙记权限
71
72	遇到妙记没有查看或编辑权限时，引导用户申请对应权限；只有用户明确要申请时，才调用 `minutes +apply-permission`。
73
74	只有当用户明确要求"申请查看权限"、"申请编辑权限"、"帮我申请这条妙记权限"时，才调用：
75
76	```bash
77	lark-cli minutes +apply-permission --minute-token <token> --perm view\|edit
78	```
79
80	这是向妙记所有者发起权限申请，不代表立即获得权限。
81
82	安全约束：遇到无权限错误时，不要自动调用 `+apply-permission`；先把无权限事实告知用户，只有用户明确要求申请权限时才发起申请。
83
84	### 4. 上传音视频文件生成妙记（并可继续获取纪要 / 逐字稿）
85
86	1. 当用户说"把音视频文件转成纪要""把录音转成逐字稿/文字稿/撰写文字""把 mp4/mp3 转成总结/待办/章节"时，也先走这个入口。
87	2. 处理流程：
88	- 上传音视频获取 `file_token`：使用 [`lark-cli drive +upload`](../lark-drive/references/lark-drive-upload.md) 上传本地文件到云空间（云盘/云存储）并获取 `file_token`。
89	- 生成妙记：获取到 `file_token` 后，调用 [`lark-cli minutes +upload`](references/lark-minutes-upload.md) 将文件转换为妙记并获取 `minute_url` 链接。
90	- 继续获取纪要 / 逐字稿（按需）：如果用户目标不是只要妙记链接，而是要纪要、逐字稿、总结、待办或章节，则从 `minute_url` 中提取 `minute_token`，再调用 [`lark-cli minutes +detail --minute-tokens`](references/lark-minutes-detail.md) 获取对应产物。
91
92	> 注意：必须先获取飞书云空间（云盘/云存储）的 `file_token` 才能进行转换。
93	>
94	> 不要误走本地转写工具：当用户目标是把本地音视频文件转成纪要、逐字稿、文字稿、撰写文字时，不要改用 `ffmpeg`、`whisper` 或其他本地 ASR/转码命令；标准路径就是 `drive +upload -> minutes +upload -> minutes +detail --minute-tokens`。
95
96	### 5. 编辑妙记的 AI 待办与 AI 总结（写入）
97
98	当用户要在某条妙记内操作 AI 待办或 AI 总结时使用本节。不是飞书任务（Task）清单里的待办。
99
100	触发信号（任一命中即走本 skill，禁止走 lark-task）：
101
102	- "在（某条）妙记里新建 / 添加 / 修改 / 删除待办"
103	- "把妙记 A 的待办改成已完成 / 未完成"
104	- "妙记里的任务1 / 任务2"（上下文已明确是妙记）
105	- 已给出 `minute_token` 或妙记 URL，且要改待办 / 总结
106
107	妙记 AI 待办 vs 飞书任务 Task：
108
109	\| 用户意图 \| 正确命令 \| 错误命令 \|
110	\|---------\|---------\|---------\|
111	\| 妙记里加待办 \| `minutes +todo --operation add` 或 `--todos '[...]'` \| `task +c

People who liked this also viewed

6 picks

Type