OpenSkillIndex← back to search
claude-code

Cli lark-minutes

飞书妙记：妙记相关基本功能。1.查询妙记列表（按关键词/所有者/参与者/时间范围）；2.获取妙记基础信息（标题、封面、时长 等）；3.下载妙记音视频文件；4.获取妙记相关 AI 产物（总结、待办、章节）。飞书妙记 URL 格式: http(s)://<host>/minutes/<minute-token>

install
source · Clone the upstream repo
git clone https://github.com/larksuite/cli
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/larksuite/cli "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/lark-minutes" ~/.claude/skills/larksuite-cli-lark-minutes && rm -rf "$T"
manifest: skills/lark-minutes/SKILL.md
source content

minutes (v1)

CRITICAL — 开始前 MUST 先用 Read 工具读取 

../lark-shared/SKILL.md
，其中包含认证、权限处理

核心概念

  • 妙记（Minutes）：来源于飞书视频会议的录制产物或用户上传的音视频文件，通过 
    minute_token
    标识。
  • 妙记 Token（minute_token）：妙记的唯一标识符，可从妙记 URL 末尾提取（例如 
    https://*.feishu.cn/minutes/obcnq3b9jl72l83w4f14xxxx
    中的 
    obcnq3b9jl72l83w4f14xxxx
    ）。如果 URL 中包含额外参数（如 
    ?xxx
    ），应截取路径最后一段。

核心场景

1. 搜索妙记

  1. 当用户描述的是"我的妙记""包含某个关键词的妙记""某段时间内的妙记"，优先使用 
    minutes +search
    。
  2. 仅支持使用关键词、时间段、参与者、所有者等筛选条件搜索妙记记录，对于不支持的筛选条件，需要提示用户。
  3. 搜索结果存在多条数据时，务必注意分页数据获取，不要遗漏任何妙记记录。
  4. 如果是会议的妙记，应优先使用 vc +search 先定位会议，再按需通过 vc +recording 获取 
    minute_token
    。

2. 查看妙记基础信息

  1. 当用户只需要确认某条妙记的标题、封面、时长、所有者、URL 等基础信息时，使用 
    minutes minutes get
    。
  2. 如果用户给的是妙记 URL，应先从 URL 末尾提取 
    minute_token
    ，再调用 
    minutes minutes get
    。
  3. 用户意图不明确时，默认先给基础元信息，帮助确认是否命中目标妙记。

使用 

lark-cli schema minutes.minutes.get
可查看完整返回值结构。核心字段包含：
title
（标题）、
cover
（封面 URL）、
duration
（时长，毫秒）、
owner_id
（所有者 ID）、
url
（妙记链接）。

3. 下载妙记音视频文件

  1. 下载妙记音视频文件到本地，或获取有效期 1 天的下载链接。详见 minutes +download。
  2. minutes +download
    只负责音视频媒体文件。
  3. 用户只想拿可分享的下载地址时，使用 
    --url-only
    ；用户要落地到本地文件时，直接下载。

注意：

+download
只负责音视频媒体文件。如果用户需要的是逐字稿、总结、待办、章节等纪要内容，请使用 vc +notes --minute-tokens。

4. 获取妙记的逐字稿、总结、待办、章节

  1. 当用户说"这个妙记的逐字稿""总结""待办""章节"时，不属于本 skill。
  2. 应使用 vc +notes --minute-tokens 获取对应的纪要产物。
  3. 如果当前上下文中已有 
    minute_token
    ，可直接传给 
    vc +notes
    ；如果只有妙记 URL，先提取 
    minute_token
    。
# 通过 minute_token 获取纪要产物（逐字稿、总结、待办、章节）
lark-cli vc +notes --minute-tokens <minute_token>

跨 skill 路由：逐字稿、AI 总结、待办、章节等纪要内容由 lark-vc 的 

+notes
命令提供

资源关系

Minutes (妙记) ← minute_token 标识
├── Metadata (标题、封面、时长、owner、url) → minutes minutes get
└── MediaFile (音频/视频文件) → minutes +download

能力边界：

minutes
负责 搜索妙记、查看基础元信息、下载音视频文件。

路由规则：

  • 用户说"妙记列表 / 搜索妙记 / 某个关键词的妙记" → 
    minutes +search
  • 用户只是想看"我的妙记 / 某段时间内的妙记 / 妙记列表"，不要先走 lark-vc，而应直接使用本 skill
  • 用户如果同时提到"会议 / 会 / 开会 / 某场会"，即使也提到了"妙记"，也应优先走 lark-vc 先定位会议，再通过 vc +recording 获取 
    minute_token
  • 用户说"我的妙记 / 我拥有的妙记 / 我参与的妙记"时，可将相关过滤条件映射为 
    me
    ；
    me
    表示当前用户
  • 结果有多页时，使用 
    page_token
    持续翻页，直到确认没有更多结果
  • minutes +search
    单次最多返回 
    200
    条；结果总数没有固定上限
  • 用户说"这个妙记的标题 / 时长 / 封面 / 链接" → 
    minutes minutes get
  • 用户说"下载这个妙记的视频 / 音频 / 媒体文件" → 
    minutes +download
  • 用户说"这个妙记的逐字稿 / 总结 / 待办 / 章节" → 使用 vc +notes --minute-tokens

Shortcuts（推荐优先使用）

Shortcut 是对常用操作的高级封装（

lark-cli minutes +<verb> [flags]
）。有 Shortcut 的操作优先使用。

Shortcut说明
+search
Search minutes by keyword, owners, participants, and time range
+download
Download audio/video media file of a minute
<!-- AUTO-GENERATED-START — gen-skills.py 管理，勿手动编辑 -->

API Resources

lark-cli schema minutes.<resource>.<method>   # 调用 API 前必须先查看参数结构
lark-cli minutes <resource> <method> [flags] # 调用 API

重要：使用原生 API 时，必须先运行 

schema
查看 
--data
/ 
--params
参数结构，不要猜测字段格式。

minutes

  • get
    — 获取妙记信息

权限表

方法所需 scope
+search
minutes:minutes.search:read
minutes.get
minutes:minutes:readonly
+download
minutes:minutes.media:export
<!-- AUTO-GENERATED-END -->