halojerry minutes (v1)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-vc/references/vc-domain-boundaries.md，不读将导致命令使用、会议产物决策、领域边界职责判断错误：
- 了解日历 & VC、会议产物 & 文档的关联关系和职责划分
- 了解会议产物（妙记和纪要）之间的关联关系，例如：妙记和纪要产生条件相互独立
- 了解不同会议产物的组成部分，以便根据需求决策使用哪种产物的数据
- 了解会议总结、分析和信息提取的标准流程
身份
所有 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） |
"xx 纪要的逐字稿/原始记录/谁说了什么" 且没有 minute_token / 妙记 URL / 本地音视频文件 |
不走本 skill；路由到 lark-drive / lark-doc，必要时再到 lark-note |
| "把音视频文件转成纪要/逐字稿/文字稿" | 先本 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. 搜索妙记
- 当用户描述的是"我的妙记""包含某个关键词的妙记""某段时间内的妙记"，优先使用
minutes +search。 - 仅支持使用关键词、时间段、参与者、所有者等筛选条件搜索妙记记录，对于不支持的筛选条件，需要提示用户。
- 搜索结果存在多条数据时，务必注意分页数据获取，不要遗漏任何妙记记录。
- 如果是会议的妙记，应优先通过 lark-vc 定位会议并获取
minute_token。 - 会议场景的妙记路由，以及"参与的妙记"如何解释，统一以 minutes +search 为准。
2. 查看妙记基础信息
- 当用户只需要确认某条妙记的标题、封面、时长、所有者、URL 等基础信息时，使用
minutes minutes get。 - 如果用户给的是妙记 URL，应先从 URL 末尾提取
minute_token，再调用minutes minutes get。 - 如果是会议 / 日程上下文中的妙记基础信息，先通过 VC 链路拿到
minute_token，再调用minutes minutes get。 - 用户意图不明确时，默认先给基础元信息，帮助确认是否命中目标妙记。
使用
lark-cli schema minutes.minutes.get可查看完整返回值结构。核心字段包含：title（标题）、cover（封面 URL）、duration（时长，毫秒）、owner_id（所有者 ID）、url（妙记链接）。
3. 下载妙记音视频文件
- 下载妙记音视频文件到本地，或获取有效期 1 天的下载链接。详见 minutes +download。
+download只负责音视频媒体文件。用户需要逐字稿、总结、待办、章节等纪要内容时，请使用 vc +notes --minute-tokens。- 用户只想拿可分享的下载地址时，使用
--url-only；用户要落地到本地文件时，直接下载。 - 未显式指定路径时，文件默认落到
./minutes/{minute_token}/<server-filename>，与vc +notes的逐字稿共享同一目录便于聚合。
注意：
+download只负责音视频媒体文件。如果用户需要的是逐字稿、总结、待办、章节等纪要内容，请使用 vc +notes --minute-tokens。
4. 读取妙记的逐字稿、总结、待办、章节（只读）
- 当用户要查看 / 读取"这个妙记的逐字稿""总结""待办""章节"时，使用 vc +notes --minute-tokens。
- 如果当前上下文中已有
minute_token，可直接传给vc +notes；如果只有妙记 URL，先提取minute_token。 - 如果用户给的是本地音视频文件，但目标是"转成纪要""转成逐字稿""转成文字稿""转成撰写文字"，应先按下文第 5 节上传文件生成妙记，再把返回的
minute_url提取成minute_token，继续调用vc +notes --minute-tokens。 - 用户如果直接给出本地文件名或路径，并要求"转逐字稿""转文字稿""整理成撰写文字"，这也是本 skill 的明确触发信号。
# 通过 minute_token 获取纪要产物（逐字稿、总结、待办、章节）
lark-cli vc +notes --minute-tokens <minute_token>
跨 skill 路由：逐字稿、AI 总结、待办、章节等纪要内容由 lark-vc 的
+notes命令提供 读 vs 写：vc +notes只负责读取 AI 产物。用户要新建 / 修改 / 删除妙记内的 AI 待办或替换 AI 总结，见下文第 6 节，不要走 lark-task。
5. 上传音视频文件生成妙记（并可继续获取纪要 / 逐字稿）
- 当用户需要通过上传本地音视频文件来生成妙记时使用。
- 当用户说"把音视频文件转成纪要""把录音转成逐字稿/文字稿/撰写文字""把 mp4/mp3 转成总结/待办/章节"时，也先走这个入口。
- 处理流程：
- 上传音视频获取
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。
6. 编辑妙记的 AI 待办与 AI 总结（写入）
当用户要在某条妙记内操作 AI 待办或 AI 总结时使用本节。不是飞书任务（Task）清单里的待办。
触发信号（任一命中即走本 skill，禁止走 lark-task）：
- "在（某条）妙记里新建 / 添加 / 修改 / 删除待办"
- "把妙记 A 的待办改成已完成 / 未完成"
- "妙记里的任务1 / 任务2"（上下文已明确是妙记）
- 已给出
minute_token或妙记 URL，且要改待办 / 总结
妙记 AI 待办 vs 飞书任务 Task：
| 用户意图 | 正确命令 | 错误命令 |
|---|---|---|
| 妙记里加待办 | minutes +todo --operation add 或 --todos '[...]' |
task +create / task tasklists list |
| 妙记里改待办 | minutes +todo --operation update --todo-id ... |
task +update |
| 妙记里删待办 | minutes +todo --operation delete --todo-id ... |
task tasks delete |
| 我的任务清单 | — | 走 lark-task |
新建多条待办：优先用 --todos 一次提交；单条则用多次 --operation add：
# 批量：任务1 已完成 + 任务2 未完成
lark-cli minutes +todo --minute-token <token> --as user --todos '[
{"operation":"add","content":"晚上好1","is_done":true},
{"operation":"add","content":"晚上好2","is_done":false}
]'
更新 / 删除前：先用 vc +notes --minute-tokens <token> 读取 todos[].todo_id（按 content 匹配目标条目；列表顺序不保证稳定，不要用"第 2 条"代替 todo_id）。
无编辑权限：若 CLI 返回 error.type=no_edit_permission，表示对这条妙记没有编辑权，应请所有者授权；不要误走 auth login --scope。
逐字稿关键词替换无命中：minutes +word-replace 时，若 CLI 返回 error.type=words_not_found，表示传入的 source_word 在该妙记逐字稿中一个都没匹配到，未做任何替换。这是参数问题不是权限问题：先用 vc +notes --minute-tokens <token> 读取当前逐字稿，核对 source_word 的精确写法与大小写后重试。
替换 AI 总结全文：见 minutes +summary。
使用
+todo前必须阅读 references/lark-minutes-todo.md；使用+summary前必须阅读 references/lark-minutes-summary.md。
资源关系
Minutes (妙记) ← minute_token 标识
├── Metadata (标题、封面、时长、owner、url) → minutes minutes get
└── MediaFile (音频/视频文件) → minutes +download
能力边界：
minutes负责 搜索妙记、查看基础元信息、下载/上传音视频、编辑妙记 AI 待办与 AI 总结、重命名、逐字稿说话人/关键词替换。路由规则：
- 用户说"妙记列表 / 搜索妙记 / 某个关键词的妙记" →
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
- 用户要在妙记内新建 / 修改 / 删除 AI 待办（含「妙记里加待办」「任务1 已完成」等）→
minutes +todo，禁止走 lark-task- 用户要替换妙记 AI 总结全文 →
minutes +summary- 用户说"通过文件生成妙记 / 把音视频转妙记" → 先上传获取
file_token，然后使用minutes +upload- 用户说"把音视频文件转成纪要 / 逐字稿 / 文字稿 / 撰写文字 / 总结 / 待办 / 章节" → 先上传获取
file_token，调用minutes +upload生成minute_url，再提取minute_token走vc +notes --minute-tokens- 用户说"重命名妙记 / 改妙记标题 / 修改妙记名字" →
minutes +update- 用户说"替换说话人 / 把 A 的发言改成 B / 重新归属发言人" →
minutes +speaker-replace- 用户说"批量替换逐字稿关键词" →
minutes +word-replaceNote 域边界（禁止规则）：
minute_token是妙记文件标识，不是note_id。
- 不要把
minute_token传给note +detail或note +transcript。- 已有
minute_token且要读取纪要产物时，先走 lark-vc；只有自然语言纪要标题时不要从 Minutes 反查。
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 |
+upload |
Upload a media file token to generate a minute |
+update |
Update a minute's title |
+speaker-replace |
Replace a speaker in a minute's transcript (rebind from one user to another) |
+summary |
Replace the full AI summary text of a minute |
+todo |
Add, update, or delete AI todo(s) inside a minute (single or batch via --todos; not Feishu Task) |
- 使用
+search命令时，必须阅读 references/lark-minutes-search.md，了解搜索参数和返回值结构。 - 使用
+download命令时，必须阅读 references/lark-minutes-download.md，了解下载参数和返回值结构。 - 使用
+upload命令时，必须阅读 references/lark-minutes-upload.md，了解生成参数和返回值结构。 - 使用
+update命令时，必须阅读 references/lark-minutes-update.md，了解修改参数和返回值结构。 - 使用
+speaker-replace命令时，必须阅读 references/lark-minutes-speaker-replace.md，了解参数和限制（仅支持用户 ID，不支持姓名）。 - 使用
+summary命令时，必须阅读 references/lark-minutes-summary.md，了解全文替换参数。 - 使用
+todo命令时，必须阅读 references/lark-minutes-todo.md，了解单条与--todos批量模式；不要用 lark-task。
API Resources
lark-cli minutes <resource> <method> [flags]
minutes
get— 获取妙记信息
权限错误：如果返回
[2091005] permission deny，表示用户没有对应妙记文件的阅读权限，需提示用户联系妙记 owner 申请权限。
不在本 skill 范围
- 已有
minute_token的纪要/逐字稿/总结/待办/章节内容获取 → lark-vc（vc +notes --minute-tokens） - 只有自然语言纪要标题的逐字稿查询 → 文档搜索 / Docx 正文读取；有显式
vc-node-id才进入 lark-note - 搜索历史会议记录 → lark-vc
- 查询未来的会议日程 → lark-calendar