Skip to content

Commit f46548d

Browse files
committed
docs: clarify note title routing
1 parent a8d1ce1 commit f46548d

4 files changed

Lines changed: 15 additions & 15 deletions

File tree

skills/lark-minutes/SKILL.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ metadata:
4545
| "重命名妙记/改妙记标题" | 本 skill(`+update`|
4646
| "替换说话人/把 A 的发言改成 B" | 本 skill(`+speaker-replace`|
4747
| "这个妙记的逐字稿/总结/待办/章节" | [lark-vc](../lark-vc/SKILL.md)`vc +notes --minute-tokens`|
48-
| "xx 纪要的逐字稿/原始记录/谁说了什么" 且没有 `minute_token` / 妙记 URL / 本地音视频文件 | 不走本 skill;先到 [lark-doc](../lark-doc/SKILL.md) 按纪要文档标题搜索并 fetch;有 `vc-node-id` 再切到 [lark-note](../lark-note/SKILL.md),否则读取文档中明确给出的“文字记录/逐字稿” Docx 链接 |
48+
| "xx 纪要的逐字稿/原始记录/谁说了什么" 且没有 `minute_token` / 妙记 URL / 本地音视频文件 | 不走本 skill;路由到 [lark-drive](../lark-drive/SKILL.md) / [lark-doc](../lark-doc/SKILL.md),必要时再到 [lark-note](../lark-note/SKILL.md) |
4949
| "把音视频文件转成纪要/逐字稿/文字稿" | 先本 skill(`+upload`),再 [lark-vc](../lark-vc/SKILL.md)`vc +notes --minute-tokens`|
5050
| 用户同时提到"会议/开会"和"妙记" |[lark-vc](../lark-vc/SKILL.md)`+search``+recording`),再本 skill |
5151

@@ -167,7 +167,7 @@ Minutes (妙记) ← minute_token 标识
167167
> - 用户只是想看"我的妙记 / 某段时间内的妙记 / 妙记列表",不要先走 [lark-vc](../lark-vc/SKILL.md),而应直接使用本 skill
168168
> - 用户如果同时提到"会议 / 会 / 开会 / 某场会",即使也提到了"妙记",也应优先走 [lark-vc](../lark-vc/SKILL.md) 先定位会议,再通过 [vc +recording](../lark-vc/references/lark-vc-recording.md) 获取 `minute_token`
169169
> - 用户如果要的是妙记基础信息,拿到 `minute_token` 后用 `minutes minutes get`;用户如果要**读取**逐字稿、文字稿、撰写文字、总结、待办、章节,再走 `vc +notes --minute-tokens`
170-
> - 用户只给自然语言纪要标题并说"查 xx 纪要的逐字稿 / 原始记录 / 谁说了什么"时,不要因为出现"逐字稿"就走 `minutes +search``vc +notes --minute-tokens`;这不是妙记入口,应先到 [lark-doc](../lark-doc/SKILL.md) 搜索并 fetch 纪要文档。有 `vc-node-id` 再进入 Note 域,否则读取文档中明确给出的“文字记录/逐字稿” Docx 链接
170+
> - 用户只给自然语言纪要标题并说"查 xx 纪要的逐字稿 / 原始记录 / 谁说了什么"时,不要因为出现"逐字稿"就走 `minutes +search``vc +notes --minute-tokens`;这不是妙记入口,应先搜索纪要文档并 fetch 正文。有 `vc-node-id` 再进入 Note 域,否则读取正文中明确给出的“文字记录/逐字稿” Docx 链接
171171
> - “我的妙记”“参与的妙记”等自然语言映射细则,以 [minutes +search](references/lark-minutes-search.md) 为准
172172
> - 结果有多页时,使用 `page_token` 持续翻页,直到确认没有更多结果
173173
> - `minutes +search` 单次最多返回 `200` 条;结果总数没有固定上限
@@ -186,7 +186,7 @@ Minutes (妙记) ← minute_token 标识
186186
> - 不要把 `minute_token` 传给 `note +detail``note +transcript`
187187
> - 不在本 skill 处理 Note 详情或 unified transcript。
188188
> - 已有 `minute_token` 且需要纪要产物索引(含 `note_id` / `note_display_type`)时,走 `vc +notes --minute-tokens`;拿到 `note_id` 后再切到 [lark-note](../lark-note/SKILL.md)
189-
> - 只有自然语言纪要标题时,先走 [lark-doc](../lark-doc/SKILL.md) 搜索和 `docs +fetch --api-version v2`;有 `vc-node-id` 才进入 Note 域,否则读取文档中明确给出的“文字记录/逐字稿” Docx 链接,不要从 Minutes 反查。
189+
> - 只有自然语言纪要标题时,先搜索纪要文档并 fetch 正文;有 `vc-node-id` 才进入 Note 域,否则读取正文中明确给出的“文字记录/逐字稿” Docx 链接,不要从 Minutes 反查。
190190
191191
## Shortcuts(推荐优先使用)
192192

@@ -227,6 +227,6 @@ lark-cli minutes <resource> <method> [flags]
227227
## 不在本 skill 范围
228228

229229
- 已有 `minute_token` 的纪要/逐字稿/总结/待办/章节内容获取 → [lark-vc](../lark-vc/SKILL.md)`vc +notes --minute-tokens`
230-
- 只有自然语言纪要标题的逐字稿查询 → 先到 [lark-doc](../lark-doc/SKILL.md) 搜索并 fetch 纪要文档;有 `vc-node-id` 才进入 [lark-note](../lark-note/SKILL.md)否则读取文档中明确给出的“文字记录/逐字稿” Docx 链接
230+
- 只有自然语言纪要标题的逐字稿查询 → 先搜索纪要文档并 fetch 正文;有 `vc-node-id` 才进入 [lark-note](../lark-note/SKILL.md)否则读取正文中明确给出的“文字记录/逐字稿” Docx 链接
231231
- 搜索历史会议记录 → [lark-vc](../lark-vc/SKILL.md)
232232
- 查询未来的会议日程 → [lark-calendar](../lark-calendar/SKILL.md)

skills/lark-note/SKILL.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Note 域负责**已知 `note_id`** 时的纪要直查。它不反查会议、日
1616

1717
> **`note_id` 来源:** 如果入口是文档,先用 `docs +fetch --api-version v2 --doc <doc_token>` 读取文档元信息;返回里的 `<vc-transcribe-tab vc-node-id="..."></vc-transcribe-tab>` 表示 VC 原始记录 block,其中 `vc-node-id` 属性值就是 Note 域使用的 `note_id`。这是显式属性映射,不要从 `doc_token`、标题、正文或 backlink 反推 `note_id`
1818
>
19-
> **只有纪要标题时:** 用户说“查询 xx 纪要的逐字稿 / 原始记录 / 谁说了什么”,且没有 `note_id``meeting_id``calendar_event_id``minute_token`、会议号或妙记 URL 时,先到 [lark-doc](../lark-doc/SKILL.md) 按“xx”搜索纪要文档,再 `docs +fetch --api-version v2 --doc <doc_token>`。如果返回 `<vc-transcribe-tab vc-node-id="...">`,提取 `vc-node-id` 后进入本 skill;如果没有该 block,但正文里有“文字记录/逐字稿”等明确的 Docx 链接或 token,说明这是普通纪要的独立逐字稿文档,直接用 `docs +fetch --api-version v2 --doc <verbatim_doc_token>` 读取,不要强行进入 Note 域。
19+
> **只有纪要标题时:** 用户说“查询 xx 纪要的逐字稿 / 原始记录 / 谁说了什么”,且没有 `note_id``meeting_id``calendar_event_id``minute_token`、会议号或妙记 URL 时,先搜索纪要文档并 fetch 正文。只有正文里的 `<vc-transcribe-tab vc-node-id="...">` 可以进入本 skill;否则只读取正文中明确给出的“文字记录/逐字稿” Docx 链接,不要强行进入 Note 域。
2020
2121
## 核心概念
2222

@@ -28,10 +28,10 @@ Note 域负责**已知 `note_id`** 时的纪要直查。它不反查会议、日
2828

2929
## 触发规则
3030

31-
| 用户表达 | 命令 |
31+
| 用户表达 | 命令 / 路由 |
3232
|---------|------|
3333
| 已知 `note_id`,查纪要详情 / 纪要类型 / 关联文档 token | `note +detail --note-id NOTE_ID` |
34-
| 只有自然语言纪要标题,用户要逐字稿 / 原始记录 / 谁说了什么 | 先到 [lark-doc](../lark-doc/SKILL.md) 搜索纪要文档并 `docs +fetch --api-version v2`;有 `<vc-transcribe-tab vc-node-id="...">` 才进入本 skill,否则使用文档中明确给出的“文字记录/逐字稿” Docx 链接 |
34+
| 只有自然语言纪要标题,用户要逐字稿 / 原始记录 / 谁说了什么 | 不进本 skill;先路由到 [lark-drive](../lark-drive/SKILL.md) / [lark-doc](../lark-doc/SKILL.md),拿到 `vc-node-id` 后再回来 |
3535
| `docs +fetch --api-version v2` 返回了 `<vc-transcribe-tab vc-node-id="...">`,要进入 Note 域 |`vc-node-id` 属性值作为 `NOTE_ID``note +detail --note-id <vc-node-id>` |
3636
| 已知 `note_id`,查 unified 原始记录 / 逐字稿 | `note +transcript --note-id NOTE_ID` |
3737
| 已知 `note_id`,读纪要正文 |`note +detail``note_doc_token`,再调 `docs +fetch --api-version v2 --doc <note_doc_token>` |
@@ -53,7 +53,7 @@ Note 域负责**已知 `note_id`** 时的纪要直查。它不反查会议、日
5353
- 不处理 `meeting_id` —— 那是 [lark-vc](../lark-vc/SKILL.md) 的入口。
5454
- 不处理 `calendar_event_id` —— 那是 [lark-vc](../lark-vc/SKILL.md) 的入口。
5555
- 不处理 `minute_token` —— 那是 [lark-vc](../lark-vc/SKILL.md)(纪要产物索引)/ [lark-minutes](../lark-minutes/SKILL.md)(妙记基础信息与媒体)的入口。
56-
- 不处理自然语言纪要标题搜索 —— 先到 [lark-doc](../lark-doc/SKILL.md) 搜索并 fetch 纪要文档;只有 fetch 结果里的 `vc-node-id` 可以作为 `note_id`,普通纪要里的“文字记录/逐字稿” Docx 链接仍由 [lark-doc](../lark-doc/SKILL.md) 读取。
56+
- 不处理自然语言纪要标题搜索 —— 先搜索纪要文档并 fetch 正文;只有 fetch 结果里的 `vc-node-id` 可以作为 `note_id`,普通纪要里的“文字记录/逐字稿” Docx 链接仍由 [lark-doc](../lark-doc/SKILL.md) 读取。
5757
- 不读取 Docx 正文 —— 拿到文档 token 后交给 [lark-doc](../lark-doc/SKILL.md)
5858
- 不从纪要正文或 `doc_token` 反推 `note_id`;只有 `docs +fetch --api-version v2` 结果中 `<vc-transcribe-tab>` 的显式 `vc-node-id` 属性可以作为 `note_id`
5959

skills/lark-vc/SKILL.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ lark-cli vc +search --query "站会" --start-time ...
4747
| 查"昨天的会议""上周的会""已结束的会议" | 本 skill(`+search`,含即时会议) |
4848
| 查日历/日程或未来时间的会议 | [lark-calendar](../lark-calendar/SKILL.md) |
4949
| 查"今天有哪些会议" | `vc +search`(已结束)+ lark-calendar(未开始),合并展示 |
50-
| 只按自然语言标题查"xx 纪要的逐字稿 / 原始记录 / 谁说了什么" | 先到 [lark-doc](../lark-doc/SKILL.md) 搜索并 fetch 纪要文档;有 `vc-node-id` 再切到 [lark-note](../lark-note/SKILL.md),否则读取文档中明确给出的“文字记录/逐字稿” Docx 链接 |
50+
| 只按自然语言标题查"xx 纪要的逐字稿 / 原始记录 / 谁说了什么" | [lark-drive](../lark-drive/SKILL.md) / [lark-doc](../lark-doc/SKILL.md),必要时再到 [lark-note](../lark-note/SKILL.md) |
5151
| Agent 真实入会/离会、会中实时事件 | [lark-vc-agent](../lark-vc-agent/SKILL.md) |
5252
| 本地音视频文件转纪要/逐字稿 | 先走 [lark-minutes](../lark-minutes/SKILL.md) 上传,再回 `vc +notes --minute-tokens` |
5353

@@ -84,7 +84,7 @@ lark-cli vc +search --query "站会" --start-time ...
8484
1. 仅支持搜索已结束的会议,对于还未开始的未来会议,需要使用 lark-calendar 技能。
8585
2. 仅支持使用关键词、时间段、参会人、组织者、会议室等筛选条件搜索会议记录,对于不支持的筛选条件,需要提示用户。
8686
3. 搜索结果存在多条数据时,务必注意分页数据获取,不要遗漏任何会议记录。
87-
4. 如果用户表达是“查询 xx 纪要的逐字稿 / 原始记录 / 谁说了什么”,且 `xx` 更像纪要文档标题、没有会议线索(`meeting_id` / `calendar_event_id` / 会议号 / 参会人 / 时间范围),不要把 `xx` 当会议关键词走 `vc +search`先到 [lark-doc](../lark-doc/SKILL.md) 按纪要文档标题搜索并 fetch 文档。有 `<vc-transcribe-tab vc-node-id="...">` 时进入 [lark-note](../lark-note/SKILL.md);没有该 block 但有“文字记录/逐字稿” Docx 链接时,直接用 `docs +fetch --api-version v2` 读取该链接。
87+
4. 如果用户表达是“查询 xx 纪要的逐字稿 / 原始记录 / 谁说了什么”,且 `xx` 更像纪要文档标题、没有会议线索(`meeting_id` / `calendar_event_id` / 会议号 / 参会人 / 时间范围),不要把 `xx` 当会议关键词走 `vc +search`先搜索纪要文档并 fetch 正文。有 `<vc-transcribe-tab vc-node-id="...">` 时进入 [lark-note](../lark-note/SKILL.md);没有该 block 但有“文字记录/逐字稿” Docx 链接时,直接用 `docs +fetch --api-version v2` 读取该链接。
8888

8989
### 2. 整理会议纪要
9090

@@ -168,7 +168,7 @@ Meeting (视频会议)
168168
> **Note 域边界**`vc +notes` 是从**会议线索**`meeting_id` / `calendar_event_id` / `minute_token`)定位纪要的入口,返回 `note_id``note_display_type`
169169
> - 用户**已经持有 `note_id`** 想查纪要详情 / 类型 / unified 原始记录时,**不要走 `vc +notes`**,直接切到 [lark-note](../lark-note/SKILL.md)
170170
> - 用户**已经持有 `doc_token`** 且目标是读正文时,**不要走 `vc +notes`**,直接切到 [lark-doc](../lark-doc/SKILL.md)
171-
> - 用户**只有自然语言纪要标题**且要逐字稿 / 原始记录时,**不要先走 `vc +search``vc +notes`**先到 [lark-doc](../lark-doc/SKILL.md) 搜索纪要文档并 `docs +fetch --api-version v2`。有 `<vc-transcribe-tab vc-node-id="...">` 时进入 [lark-note](../lark-note/SKILL.md);没有该 block 但有“文字记录/逐字稿” Docx 链接时,直接用 `docs +fetch --api-version v2` 读取该链接。
171+
> - 用户**只有自然语言纪要标题**且要逐字稿 / 原始记录时,**不要先走 `vc +search``vc +notes`**先搜索纪要文档并 fetch 正文。有 `<vc-transcribe-tab vc-node-id="...">` 时进入 [lark-note](../lark-note/SKILL.md);没有该 block 但有“文字记录/逐字稿” Docx 链接时,直接用 `docs +fetch --api-version v2` 读取该链接。
172172
> - `vc +notes` 返回 `note_display_type=unified` 且用户要逐字稿 / 原始记录时,用返回的 `note_id``note +transcript`[lark-note](../lark-note/SKILL.md))。
173173
174174
## API Resources
@@ -197,6 +197,6 @@ lark-cli vc meeting get --params '{"meeting_id": "<meeting_id>", "with_participa
197197

198198
- 查询未来的会议日程 → [lark-calendar](../lark-calendar/SKILL.md)
199199
- Agent 真实入会/离会、会中实时事件 → [lark-vc-agent](../lark-vc-agent/SKILL.md)
200-
- 只有纪要文档标题的逐字稿查询 → 先到 [lark-doc](../lark-doc/SKILL.md) 搜索并 fetch 纪要文档;有 `vc-node-id` 才进入 [lark-note](../lark-note/SKILL.md)否则读取文档中明确给出的“文字记录/逐字稿” Docx 链接
200+
- 只有纪要文档标题的逐字稿查询 → 先搜索纪要文档并 fetch 正文;有 `vc-node-id` 才进入 [lark-note](../lark-note/SKILL.md)否则读取正文中明确给出的“文字记录/逐字稿” Docx 链接
201201
- 本地音视频文件转纪要/逐字稿 → [lark-minutes](../lark-minutes/SKILL.md)(上传后回 `vc +notes`
202202
- 妙记搜索/下载/上传/重命名/替换说话人 → [lark-minutes](../lark-minutes/SKILL.md)

skills/lark-vc/references/vc-domain-boundaries.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@
8181

8282
根据关键字、组织者、参与人、会议室等条件搜索会议,获取会议列表。
8383

84-
> **不要把纪要标题当会议线索:** 如果用户说“查询 xx 纪要的逐字稿 / 原始记录 / 谁说了什么”,且没有 `meeting_id``calendar_event_id`、会议号、参会人或时间范围,`xx` 应先到 [lark-doc](../../lark-doc/SKILL.md) 按纪要文档标题搜索并 fetch。若返回 `<vc-transcribe-tab vc-node-id="...">`,提取 `note_id` 后进入 Note 域判断 `normal` / `unified`;若没有该 block,但有“文字记录/逐字稿” Docx 链接,直接用 `docs +fetch --api-version v2` 读取该链接。
84+
> **不要把纪要标题当会议线索:** 如果用户说“查询 xx 纪要的逐字稿 / 原始记录 / 谁说了什么”,且没有 `meeting_id``calendar_event_id`、会议号、参会人或时间范围,先用 `drive +search --query <标题>` 搜索纪要文档,拿到 Docx URL/token 后再 `docs +fetch --api-version v2`。若返回 `<vc-transcribe-tab vc-node-id="...">`,提取 `note_id` 后进入 Note 域判断 `normal` / `unified`;若没有该 block,但有“文字记录/逐字稿” Docx 链接,直接用 `docs +fetch --api-version v2` 读取该链接。
8585
8686
```bash
8787
lark-cli vc +search --start "<YYYY-MM-DD>" --end "<YYYY-MM-DD>" --format json
@@ -139,7 +139,7 @@ lark-cli note +transcript --note-id <note_id>
139139
## Note 域
140140

141141
- **lark-note skill** 负责**已知 `note_id`** 时的纪要直查:纪要详情、展示类型、关联文档 token,以及 unified 纪要的原始逐字记录。
142-
- **入口边界**:Note 域只接受 `note_id`。只有 `meeting_id` / `calendar_event_id` / `minute_token` 等会议线索时,先用 `lark-vc``+notes` 定位 `note_id`;只有自然语言纪要标题时,先到 [lark-doc](../../lark-doc/SKILL.md) 按标题搜索纪要文档并 `docs +fetch --api-version v2`。返回中的 `<vc-transcribe-tab vc-node-id="..."></vc-transcribe-tab>` 表示 VC 原始记录 block,其中 `vc-node-id` 属性值就是 `note_id`;拿到显式 `note_id` 后再进入 Note 域。若没有该 block,但有“文字记录/逐字稿” Docx 链接,说明是普通纪要的独立逐字稿文档,继续走 Doc 域读取。
142+
- **入口边界**:Note 域只接受 `note_id`。只有 `meeting_id` / `calendar_event_id` / `minute_token` 等会议线索时,先用 `lark-vc``+notes` 定位 `note_id`;只有自然语言纪要标题时,先用 `drive +search --query <标题>` 搜索纪要文档,拿到 Docx URL/token 后再 `docs +fetch --api-version v2`。返回中的 `<vc-transcribe-tab vc-node-id="..."></vc-transcribe-tab>` 表示 VC 原始记录 block,其中 `vc-node-id` 属性值就是 `note_id`;拿到显式 `note_id` 后再进入 Note 域。若没有该 block,但有“文字记录/逐字稿” Docx 链接,说明是普通纪要的独立逐字稿文档,继续走 Doc 域读取。
143143
- **展示类型(`note_display_type`)决定逐字稿路由**
144144
- `normal`:逐字稿是独立文档(`verbatim_doc_token`),用 `docs +fetch --api-version v2` 读取。
145145
- `unknown``verbatim_doc_token` 非空:先按独立文档处理,用 `docs +fetch --api-version v2` 读取;不要猜成 unified。
@@ -179,7 +179,7 @@ Minutes
179179
| `calendar_event_id` | `lark-vc` | `lark-note` / `lark-doc` |
180180
| `minute_token` | `lark-vc`(纪要产物索引)/ `lark-minutes`(妙记基础信息、媒体) | `lark-note` / `lark-doc` |
181181
| `note_id` | `lark-note` | `lark-doc` |
182-
| 自然语言纪要标题 + 逐字稿意图 | [lark-doc](../../lark-doc/SKILL.md) 搜索文档,然后 `docs +fetch --api-version v2` | 如果 fetch 返回 `<vc-transcribe-tab vc-node-id="...">`,用 `vc-node-id` 进入 [lark-note](../../lark-note/SKILL.md);否则读取文档中明确给出的“文字记录/逐字稿” Docx 链接;不要先走 `lark-vc` / `lark-minutes` 搜索 |
182+
| 自然语言纪要标题 + 逐字稿意图 | `lark-drive`(文档搜索) | `lark-doc`(正文读取);有 `vc-node-id` 时再进入 `lark-note`不要先走 `lark-vc` / `lark-minutes` |
183183
| `doc_token` / Docx URL | `lark-doc` | 如果 `docs +fetch --api-version v2` 返回 `<vc-transcribe-tab vc-node-id="...">`,用 `vc-node-id` 属性值作为 `note_id` 进入 `lark-note`;否则不反推 Note |
184184

185185
## Doc 域

0 commit comments

Comments
 (0)