Score
8.5
/ 10
Installs
70K
Repo Stars
14.5K
Last Updated
2d ago
Quality Ratio
98%
Description
Verified
Language
Go
Summary
The Lark Note agent skill enables agents to retrieve structured details, body content, and verbatim or unified transcripts of specific meeting notes from the Lark platform. This agent skill is essential for developers building integrations or automated workflows that require precise extraction of information from Lark meeting notes, especially when dealing with various note display types. It is a skill with 6K installs, indicating a notable adoption among the developer community. It operates by requiring an explicit `note_id` to fetch note details using `note +detail` or to retrieve unified original records via `note +transcript`. The skill guides the agent on how to route requests based on `note_display_type` and `verbatim_doc_token` to correctly access the note body or appropriate transcript, while explicitly defining that it does not handle natural language title searches or `meeting_id` lookups. The skill's primary limitation is its strict dependency on a known `note_id`, as it does not support natural language title searches or locating notes via meeting or calendar IDs.
Skill Definition
身份:仅使用 --as user。使用前阅读 ../lark-shared/SKILL.md。
Note 域只接受显式 note_id:用户直接提供,或 docs +fetch --api-version v2 返回的 <vc-transcribe-tab vc-node-id="..."> 中的 vc-node-id。不要从 doc_token、标题、正文或 backlink 反推 note_id。
命令路由
| 用户表达 / 上下文 | 路由 |
|---|---|
已知 note_id,查纪要类型 / 文档 token | note +detail --note-id NOTE_ID |
docs +fetch --api-version v2 返回 <vc-transcribe-tab vc-node-id="..."> | 取 vc-node-id 作为 NOTE_ID,先 note +detail --note-id NOTE_ID |
已知 note_id,读纪要正文 | note +detail → docs +fetch --api-version v2 --doc <note_doc_token> |
已知 note_id,查 unified 原始记录 / 逐字稿 | note +transcript --note-id NOTE_ID |
| 只有自然语言纪要标题,用户要逐字稿 / 原始记录 / 谁说了什么 | 不进本 skill;先走文档搜索与 docs +fetch,拿到 vc-node-id 后再回来 |
note_display_type 路由
note +detail 结果 | 用户要逐字稿 / 原始记录时 |
|---|---|
normal + verbatim_doc_token 非空 | docs +fetch --api-version v2 --doc <verbatim_doc_token> |
unknown + verbatim_doc_token 非空 | 先按独立文档处理;不要猜成 unified |
unknown + 无逐字稿 token | 停止重试并说明无法确定逐字稿入口 |
unified | note +transcript --note-id <note_id> |
判别键是 note_display_type,不是 verbatim_doc_token 是否为空:unified 纪要也可能返回非空 verbatim_doc_token。
关键字段
note_id:Note 域唯一入口。note_display_type:unknown/normal/unified。note_doc_token:纪要正文文档,正文读取交给 lark-doc。verbatim_doc_token:普通纪要逐字稿文档;unified 逐字稿不按这个 token 路由。
不在本 Skill 范围
- 通过
meeting_id/calendar_event_id/minute_token定位纪要 → lark-vc。 - 自然语言纪要标题搜索 → lark-drive / lark-doc。
- Docx 正文读取 → lark-doc。
- 妙记基础信息与媒体文件 → lark-minutes。
Shortcuts
| Shortcut | 何时读 reference |
|---|---|
+detail | 需要解释输出字段或根据展示类型继续路由 |
+transcript | 需要拉取 unified 原始记录或处理本地输出文件 |