AGENT SKILL

lark-note

飞书会议纪要(Note)直查:已知 note_id 时查询纪要详情、展示类型、关联文档 token,并读取 unified 原始逐字记录。当用户已持有 note_id,或从文档显式 vc-node-id 获得 note_id 时使用。不负责会议/日程/妙记定位、文档标题搜索或 Docx 正文读取。

使用场景文档处理
License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
lark-note
version
1.0.0
metadata
{ "cliHelp": "lark-cli note --help", "requires": { "bins": [ "lark-cli" ] } }
description
飞书会议纪要(Note)直查:已知 note_id 时查询纪要详情、展示类型、关联文档 token,并读取 unified 原始逐字记录。当用户已持有 note_id,或从文档显式 vc-node-id 获得 note_id 时使用。不负责会议/日程/妙记定位、文档标题搜索或 Docx 正文读取。

02 资源文件 2

03 SKILL.md 正文

note (v1)

身份:仅使用 --as user。使用前阅读 ../lark-shared/SKILL.md。

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-vc/references/vc-domain-boundaries.md,不读将导致命令使用、会议产物决策、领域边界职责判断错误:

  1. 了解日历 & VC、会议产物 & 文档的关联关系和职责划分
  2. 了解会议产物(妙记和纪要)之间的关联关系,例如:妙记和纪要产生条件相互独立
  3. 了解不同会议产物的组成部分,以便根据需求决策使用哪种产物的数据

Note 域只接受显式 note_id:用户直接提供,或 docs +fetch 返回的 <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 返回 <vc-transcribe-tab vc-node-id="..."> 取 vc-node-id 作为 NOTE_ID,先 note +detail --note-id NOTE_ID
只持有 meeting_id 先 vc +detail --meeting-ids <id> 拿 note_id,再 note +detail --note-id NOTE_ID
只持有 minute_token(妙记 URL) 先 minutes +detail --minute-tokens <token> 顶层取 note_id,再 note +detail --note-id NOTE_ID(不要把 minute_token 当 note_id)
只持有日程 event_id 先 calendar +meeting --event-ids <id> 拿 meeting_id,再按上一行继续
已知 note_id,读纪要正文 note +detail → docs +fetch --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 --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 定位纪要(note_id)→ lark-vc(vc +detail)。
  • 通过 minute_token 定位纪要(note_id)→ lark-minutes(minutes +detail 顶层返回 note_id)。
  • 通过日程 event_id 定位会议(meeting_id) / 用户绑定纪要(meeting_note) → lark-calendar(calendar +meeting)。
  • 自然语言纪要标题搜索 → lark-drive / lark-doc。
  • Docx 正文读取 → lark-doc。
  • 妙记基础信息与媒体文件 → lark-minutes。

Shortcuts

Shortcut 何时读 reference
+detail 需要解释输出字段或根据展示类型继续路由
+transcript 需要拉取 unified 原始记录或处理本地输出文件

核心概念

  • 会议纪要(Note):视频会议结束后生成的结构化文档,通过 note_id 标识。一个 Note 包含 AI 智能纪要文档、逐字稿文档和会中共享文档。
  • note_id:纪要的唯一标识符,可通过 vc +detail --meeting-ids 获取。
  • AI 智能纪要(MainDoc):AI 生成的会议总结与待办,对应 note_doc_token。
  • 逐字稿(VerbatimDoc):会议的逐句发言记录,含说话人和时间戳,对应 verbatim_doc_token。
  • 共享文档(SharedDoc):会中投屏共享的文档,对应 shared_doc_tokens。

核心场景

1. 通过 note_id 获取纪要文档 Token

  1. 当用户已有 note_id,需要获取对应的 note_doc_token、verbatim_doc_token 或 shared_doc_tokens 时,使用 note +detail。
  2. note_id 通常来自 vc +detail 的返回结果。
  3. 获取到文档 Token 后,可使用 docs +fetch 读取文档内容,或使用 drive metas batch_query 获取文档元信息。
# 1. 从会议获取 note_id
lark-cli vc +detail --meeting-ids <meeting_id>

# 2. 用 note_id 拿文档 Token
lark-cli note +detail --note-id <note_id>

# 3. 读取纪要文档内容
lark-cli docs +fetch --doc <note_doc_token> --doc-format markdown

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k