lark-note

Name: lark-note
Author: larksuite

bylarksuite· 47 skills

Installs

162k

Stars

16k

Forks

1.2k

How to install lark-note?

larksuite/cli/lark-note

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

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Use this skill

Run `npx skills use "https://github.com/larksuite/cli" --skill "larksuite/cli/lark-note"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.

Use the whole pack

Use the skills in "https://github.com/larksuite/cli" that are relevant to the current task. Run `npx skills add "https://github.com/larksuite/cli"` and select the relevant skills, then follow their instructions.

Files · 1

View on GitHub

SKILL.md

1	# note (v1)
2
3	身份：仅使用 `--as user`。使用前阅读 [`../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
10	Note 域只接受显式 `note_id`：用户直接提供，或 `docs +fetch` 返回的 `<vc-transcribe-tab vc-node-id="...">` 中的 `vc-node-id`。不要从 `doc_token`、标题、正文或 backlink 反推 `note_id`。
11
12	## 命令路由
13
14	\| 用户表达 / 上下文 \| 路由 \|
15	\|---------\|------\|
16	\| 已知 `note_id`，查纪要类型 / 文档 token \| `note +detail --note-id NOTE_ID` \|
17	\| `docs +fetch` 返回 `<vc-transcribe-tab vc-node-id="...">` \| 取 `vc-node-id` 作为 `NOTE_ID`，先 `note +detail --note-id NOTE_ID` \|
18	\| 只持有 `meeting_id` \| 先 `vc +detail --meeting-ids <id>` 拿 `note_id`，再 `note +detail --note-id NOTE_ID` \|
19	\| 只持有 `minute_token`（妙记 URL） \| 先 `minutes +detail --minute-tokens <token>` 顶层取 `note_id`，再 `note +detail --note-id NOTE_ID`（不要把 `minute_token` 当 `note_id`） \|
20	\| 只持有日程 `event_id` \| 先 `calendar +meeting --event-ids <id>` 拿 `meeting_id`，再按上一行继续 \|
21	\| 已知 `note_id`，读纪要正文 \| `note +detail` → `docs +fetch --doc <note_doc_token>` \|
22	\| 已知 `note_id`，查 unified 原始记录 / 逐字稿 \| `note +transcript --note-id NOTE_ID` \|
23	\| 只有自然语言纪要标题，用户要逐字稿 / 原始记录 / 谁说了什么 \| 不进本 skill；先走文档搜索与 `docs +fetch`，拿到 `vc-node-id` 后再回来 \|
24
25	## `note_display_type` 路由
26
27	\| `note +detail` 结果 \| 用户要逐字稿 / 原始记录时 \|
28	\|------\|---------------\|
29	\| `normal` + `verbatim_doc_token` 非空 \| `docs +fetch --doc <verbatim_doc_token>` \|
30	\| `unknown` + `verbatim_doc_token` 非空 \| 先按独立文档处理；不要猜成 unified \|
31	\| `unknown` + 无逐字稿 token \| 停止重试并说明无法确定逐字稿入口 \|
32	\| `unified` \| `note +transcript --note-id <note_id>` \|
33
34	判别键是 `note_display_type`，不是 `verbatim_doc_token` 是否为空：unified 纪要也可能返回非空 `verbatim_doc_token`。
35
36	## 关键字段
37
38	- `note_id`：Note 域唯一入口。
39	- `note_display_type`：`unknown` / `normal` / `unified`。
40	- `note_doc_token`：纪要正文文档，正文读取交给 [lark-doc](../lark-doc/SKILL.md)。
41	- `verbatim_doc_token`：普通纪要逐字稿文档；unified 逐字稿不按这个 token 路由。
42
43	## 不在本 Skill 范围
44
45	- 通过 `meeting_id` 定位纪要（`note_id`）→ [lark-vc](../lark-vc/SKILL.md)（`vc +detail`）。
46	- 通过 `minute_token` 定位纪要（`note_id`）→ [lark-minutes](../lark-minutes/SKILL.md)（`minutes +detail` 顶层返回 `note_id`）。
47	- 通过日程 `event_id` 定位会议(`meeting_id`) / 用户绑定纪要(`meeting_note`) → [lark-calendar](../lark-calendar/SKILL.md)（`calendar +meeting`）。
48	- 自然语言纪要标题搜索 → [lark-drive](../lark-drive/SKILL.md) / [lark-doc](../lark-doc/SKILL.md)。
49	- Docx 正文读取 → [lark-doc](../lark-doc/SKILL.md)。
50	- 妙记基础信息与媒体文件 → [lark-minutes](../lark-minutes/SKILL.md)。
51
52	## Shortcuts
53
54	\| Shortcut \| 何时读 reference \|
55	\|----------\|------\|
56	\| [`+detail`](references/lark-note-detail.md) \| 需要解释输出字段或根据展示类型继续路由 \|
57	\| [`+transcript`](references/lark-note-transcript.md) \| 需要拉取 unified 原始记录或处理本地输出文件 \|
58
59	## 核心概念
60
61	- 会议纪要（Note）：视频会议结束后生成的结构化文档，通过 `note_id` 标识。一个 Note 包含 AI 智能纪要文档、逐字稿文档和会中共享文档。
62	- note_id：纪要的唯一标识符，可通过 `vc +detail --meeting-ids` 获取。
63	- AI 智能纪要（MainDoc）：AI 生成的会议总结与待办，对应 `note_doc_token`。
64	- 逐字稿（VerbatimDoc）：会议的逐句发言记录，含说话人和时间戳，对应 `verbatim_doc_token`。
65	- 共享文档（SharedDoc）：会中投屏共享的文档，对应 `shared_doc_tokens`。
66
67	## 核心场景
68
69	### 1. 通过 note_id 获取纪要文档 Token
70
71	1. 当用户已有 `note_id`，需要获取对应的 `note_doc_token`、`verbatim_doc_token` 或 `shared_doc_tokens` 时，使用 `note +detail`。
72	2. `note_id` 通常来自 `vc +detail` 的返回结果。
73	3. 获取到文档 Token 后，可使用 `docs +fetch` 读取文档内容，或使用 `drive metas batch_query` 获取文档元信息。
74
75	```bash
76	# 1. 从会议获取 note_id
77	lark-cli vc +detail --meeting-ids <meeting_id>
78
79	# 2. 用 note_id 拿文档 Token
80	lark-cli note +detail --note-id <note_id>
81
82	# 3. 读取纪要文档内容
83	lark-cli docs +fetch --doc <note_doc_token> --doc-format markdown
84	```

6 picks

Type

Run `npx skills use "https://github.com/larksuite/cli" --skill "larksuite/cli/lark-note"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.

Use the skills in "https://github.com/larksuite/cli" that are relevant to the current task. Run `npx skills add "https://github.com/larksuite/cli"` and select the relevant skills, then follow their instructions.

lark-note

How to install lark-note?

Related

lark-note

How to install lark-note?

Related