Back to skills

Agent Skill

Lark Note

lark-note

身份:仅使用 `--as user`。使用前阅读 [`../lark-shared/SKILL.md`](https://github.com/larksuite/cli/blob/main/skills/lark-note/../lark-shared/SKILL.md)。

Open.feishu.cnToolsGo

70K installs

larksuite/cli

by Open.feishu.cn

Score

8.5

/ 10

Installs

70K

Repo Stars

14.5K

Last Updated

2d ago

Fresh

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,查纪要类型 / 文档 tokennote +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 +detaildocs +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停止重试并说明无法确定逐字稿入口
unifiednote +transcript --note-id <note_id>

判别键是 note_display_type,不是 verbatim_doc_token 是否为空:unified 纪要也可能返回非空 verbatim_doc_token

关键字段

  • note_id:Note 域唯一入口。
  • note_display_typeunknown / 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 原始记录或处理本地输出文件

How to Use

Use in O-mega

Claude Code

npx skills add larksuite/cli lark-note
Lark Note | Agent Skills | o-mega