seaworld008/lark-minutes

minutes (v1)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理

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

1. 了解日历 & VC、会议产物 & 文档的关联关系和职责划分
2. 了解会议产物（妙记和纪要）之间的关联关系，例如：妙记和纪要产生条件相互独立
3. 了解不同会议产物的组成部分，以便根据需求决策使用哪种产物的数据
4. 了解会议总结、分析和信息提取的标准流程

身份

所有 minutes 命令默认使用 --as user。

Shortcuts

| Shortcut | 说明 | |----------|------| | +search | 按关键词、所有者、参与者、时间范围搜索妙记 | | +download | 下载妙记音视频媒体文件 | | +upload | 上传 file_token 生成妙记 | | +update | 更新妙记标题 | | +speaker-replace | 替换妙记逐字稿中的说话人（仅支持用户 ID，不支持姓名） |

• 使用任何 Shortcut 前，必须先读其对应 reference 文档。

意图路由

| 用户意图 | 路由到 | |----------|--------| | "我的妙记""搜索妙记""妙记列表" | 本 skill（+search） | | "这个妙记的标题/时长/封面/链接" | 本 skill（minutes get） | | "下载妙记的视频/音频" | 本 skill（+download） | | "把音视频转妙记/上传文件生成妙记" | 本 skill（+upload） | | "重命名妙记/改妙记标题" | 本 skill（+update） | | "替换说话人/把 A 的发言改成 B" | 本 skill（+speaker-replace） | | "这个妙记的逐字稿/总结/待办/章节" | lark-vc（vc +notes --minute-tokens） | | "把音视频文件转成纪要/逐字稿/文字稿" | 先本 skill（+upload），再 lark-vc（vc +notes --minute-tokens） | | 用户同时提到"会议/开会"和"妙记" | 先 lark-vc（+search → +recording），再本 skill |

核心概念

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

核心场景

1. 搜索妙记

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

2. 查看妙记基础信息

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

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

3. 下载妙记音视频文件

1. 下载妙记音视频文件到本地，或获取有效期 1 天的下载链接。详见 minutes +download。
2. +download 只负责音视频媒体文件。用户需要逐字稿、总结、待办、章节等纪要内容时，请使用 vc +notes --minute-tokens。
3. 用户只想拿可分享的下载地址时，使用 --url-only；用户要落地到本地文件时，直接下载。
4. 未显式指定路径时，文件默认落到 ./minutes/{minute_token}/<server-filename>，与 vc +notes 的逐字稿共享同一目录便于聚合。

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

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

1. 当用户说"这个妙记的逐字稿""总结""待办""章节"时，不属于本 skill。
2. 应使用 vc +notes --minute-tokens 获取对应的纪要产物。
3. 如果当前上下文中已有 minute_token，可直接传给 vc +notes；如果只有妙记 URL，先提取 minute_token。
4. 如果用户给的是本地音视频文件，但目标是"转成纪要""转成逐字稿""转成文字稿""转成撰写文字"，也支持；此时应先按下文第 5 节上传文件生成妙记，再把返回的 minute_url 提取成 minute_token，继续调用 vc +notes --minute-tokens。
5. 用户如果直接给出本地文件名或路径，并要求"转逐字稿""转文字稿""整理成撰写文字"，这也是本 skill 的明确触发信号。

# 通过 minute_token 获取纪要产物（逐字稿、总结、待办、章节）
lark-cli vc +notes --minute-tokens <minute_token>

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

5. 上传音视频文件生成妙记（并可继续获取纪要 / 逐字稿）

1. 当用户需要通过上传本地音视频文件来生成妙记时使用。
2. 当用户说"把音视频文件转成纪要""把录音转成逐字稿/文字稿/撰写文字""把 mp4/mp3 转成总结/待办/章节"时，也先走这个入口。
3. 处理流程：
   • 上传音视频获取 file_token：使用 lark-cli drive +upload 上传本地文件到云空间（云盘/云存储）并获取 file_token。
   • 生成妙记：获取到 file_token 后，调用 lark-cli minutes +upload 将文件转换为妙记并获取 minute_url 链接。
   • 继续获取纪要 / 逐字稿（按需）：如果用户目标不是只要妙记链接，而是要纪要、逐字稿、总结、待办或章节，则从 minute_url 中提取 minute_token，再调用 lark-cli vc +notes --minute-tokens 获取对应产物。

注意：必须先获取飞书云空间（云盘/云存储）的 file_token 才能进行转换。

不要误走本地转写工具：当用户目标是把本地音视频文件转成纪要、逐字稿、文字稿、撰写文字时，不要改用 ffmpeg、whisper 或其他本地 ASR/转码命令；标准路径就是 drive +upload -> minutes +upload -> vc +notes --minute-tokens。

资源关系

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

能力边界：minutes 负责 搜索妙记、查看基础元信息、下载音视频文件、上传音视频生成妙记。

路由规则：

• 用户说"妙记列表 / 搜索妙记 / 某个关键词的妙记" → minutes +search
• 用户只是想看"我的妙记 / 某段时间内的妙记 / 妙记列表"，不要先走 lark-vc，而应直接使用本 skill
• 用户如果同时提到"会议 / 会 / 开会 / 某场会"，即使也提到了"妙记"，也应优先走 lark-vc 先定位会议，再通过 vc +recording 获取 minute_token
• 用户如果要的是妙记基础信息，拿到 minute_token 后用 minutes minutes get；用户如果要的是逐字稿、文字稿、撰写文字、总结、待办、章节，再走 vc +notes --minute-tokens
• “我的妙记”“参与的妙记”等自然语言映射细则，以 minutes +search 为准
• 结果有多页时，使用 page_token 持续翻页，直到确认没有更多结果
• minutes +search 单次最多返回 200 条；结果总数没有固定上限
• 用户说"这个妙记的标题 / 时长 / 封面 / 链接" → minutes minutes get
• 用户说"下载这个妙记的视频 / 音频 / 媒体文件" → minutes +download
• 用户说"这个妙记的逐字稿 / 文字稿 / 撰写文字 / 总结 / 待办 / 章节" → 使用 vc +notes --minute-tokens
• 用户说"通过文件生成妙记 / 把音视频转妙记" → 先上传获取 file_token，然后使用 minutes +upload
• 用户说"把音视频文件转成纪要 / 逐字稿 / 文字稿 / 撰写文字 / 总结 / 待办 / 章节" → 先上传获取 file_token，调用 minutes +upload 生成 minute_url，再提取 minute_token 走 vc +notes --minute-tokens
• 用户说"重命名妙记 / 改妙记标题 / 修改妙记名字" → minutes +update
• 用户说"替换说话人 / 把 A 的发言改成 B / 重新归属发言人" → minutes +speaker-replace

API Resources

lark-cli minutes <resource> <method> [flags]

minutes

• get — 获取妙记信息

权限错误：如果返回 [2091005] permission deny，表示用户没有对应妙记文件的阅读权限，需提示用户联系妙记 owner 申请权限。

不在本 skill 范围

• 纪要/逐字稿/总结/待办/章节内容获取 → lark-vc（vc +notes --minute-tokens）
• 搜索历史会议记录 → lark-vc
• 查询未来的会议日程 → lark-calendar

<!-- LOCAL-QUALITY-SUPPLEMENT:START -->

Usage Notes

This supplement is maintained by the repository sync pipeline. It keeps the imported upstream skill usable inside this curated collection when the upstream source is intentionally concise.

Common Patterns

1. Confirm that the user's task matches the skill trigger.
2. Read the relevant project files or user-provided context before acting.
3. Choose the smallest reversible action that advances the task.
4. Run the verification command or manual check that proves the result.
5. Report the outcome, evidence, and any remaining risk.

Boundaries

• Prefer the upstream workflow for Lark Minutes; this section only adds local quality guardrails.
• Do not invent project facts when required files, vaults, services, or tools are unavailable.
• Stop and ask for clarification when the next action could overwrite user work, expose private data, or change production state.

<!-- LOCAL-QUALITY-SUPPLEMENT:END -->