🧩 它做什么，不做什么

lark-note 是飞书官方 CLI 工具 larksuite/cli 中的一个 Agent Skill，定位很窄：当你手里已经有一个 note_id 的时候，用它来拿数据。

它能做两件事。第一，通过 note +detail 命令查询纪要详情，拿到纪要的展示类型（普通纪要还是 unified 纪要）、AI 智能纪要文档的 token、逐字稿文档 token，以及会中共享文档的 token。第二，如果这个纪要是 unified 类型，用 note +transcript 拉取完整的原始逐字记录。

它不负责的事情同样重要：不做会议/日程/妙记的定位，不做文档标题搜索，也不读取 Docx 正文。如果你只有会议标题或者自然语言描述，需要先通过文档搜索拿到 vc-node-id，再交给 lark-note 处理。

一句话总结：它是下游工具，负责消费 note_id，不负责生产 note_id。

📦 第一次怎么装

lark-note 通过 skills CLI 安装。在项目根目录执行：

npx skills add https://github.com/larksuite/cli --skill lark-note

如果你用的是 Claude Code，也可以手动把 SKILL.md 放到 ~/.claude/skills/lark-note/ 目录下，Claude Code 下次启动时会自动发现。

安装 lark-note 之前，确保 lark-cli 本身已经装好并完成了认证配置。lark-note 依赖 lark-cli note --help 这个入口来运行命令。

🛠️ 装好之后怎么用

使用场景很明确：你已经有了 note_id，需要拿这个纪要里的数据。在 Agent 对话中直接描述需求即可，比如“帮我看一下这个 note_id 的纪要详情”或者“把这个 unified 纪要的逐字稿拉出来”。

查纪要详情：

lark-cli note +detail --note-id <note_id>

这个命令只读，仅支持 --as user 身份。返回结果里你会看到 note_doc_token（AI 纪要正文的文档 token）、note_display_type（normal 还是 unified）和 verbatim_doc_token（普通纪要的逐字稿文档 token）。

拉取 unified 逐字稿：

lark-cli note +transcript --note-id <note_id>

这个命令同样仅支持 --as user。CLI 会先校验该 Note 是否为 unified 类型，不是 unified 就不拉取 transcript。内部会自动翻页并拼接完整内容。

拿到详情之后怎么走：如果 note_display_type=normal 且 verbatim_doc_token 非空，逐字稿是独立文档，交给 lark-doc 读取。如果类型是 unified，不管有没有返回 verbatim_doc_token，逐字稿都走 note +transcript 这条路。

💡 几个关键使用技巧

  • note_id 只能显式传入，不能反推。这是这个技能最重要的约束。note_id 的来源只有两个：用户直接提供，或者从文档中 <vc-transcribe-tab vc-node-id="..."> 里拿到 vc-node-id。不要从 doc_token、标题、正文或 backlink 去猜 note_id。
  • 如果你只有 meeting_id 或 minute_token，需要先做一步转换。只有 meeting_id 时，先跑 vc +detail --meeting-ids <id> 拿 note_id；只有妙记 URL 时，先跑 minutes +detail --minute-tokens <token>。不要把 minute_token 当成 note_id 用。
  • 身份要显式沿用。如果 note_id 是通过 --as bot 拿到的，后续所有消费这个 note_id 的命令都必须显式写同一个 --as，不要依赖 profile 里的默认身份。
  • 配合 lark-doc 完成闭环。lark-note 只负责拿 token，读纪要正文、总结、待办、章节这些内容操作要交给 lark-doc，用 docs +fetch --doc <note_doc_token> 来实现。两个 skill 是上下游关系，各管一段。

🤖 适合哪些 AI 工具

lark-note 是一个标准的 Agent Skill，本质上是一份 SKILL.md 文件，不绑定特定平台。飞书官方 CLI 的设计目标就是让 Claude Code、Cursor、Codex 这类 AI 编程助手通过自然语言指令直接操控飞书的核心功能。

目前兼容的工具包括：Claude Code、Cursor、Codex、Windsurf、OpenClaw，以及其他支持 Agent Skill 工作流的工具。安装时 CLI 会列出可选的 Agent 列表，按实际使用情况勾选即可。

需要留意的是，lark-note 只处理已经拿到 note_id 之后的事情。如果你的需求是“帮我找一下上周那个产品评审会的纪要”，这超出了它的职责范围。正确的做法是先通过飞书文档搜索或 docs +fetch 拿到 vc-node-id，再交给 lark-note 继续。