PaperclipOrg
Claude Agent Skill · by Larksuite

Lark Minutes

Search, download, and inspect Lark meeting recordings (妙记) without juggling API tokens manually. Query your recordings by keyword, participant, or date range, g

Install
Terminal · npx
$npx skills add https://github.com/obra/superpowers --skill brainstorming
Works with Paperclip

How Lark Minutes fits into a Paperclip company.

Lark Minutes drops into any Paperclip agent that handles this kind of work. Assign it to a specialist inside a pre-configured PaperclipOrg company and the skill becomes available on every heartbeat — no prompt engineering, no tool wiring.

S
SaaS FactoryPaired

Pre-configured AI company — 18 agents, 18 skills, one-time purchase.

$27$59
Explore pack
Source file
SKILL.md116 lines
Expand
---name: lark-minutesversion: 1.0.0description: "飞书妙记：妙记相关基本功能。1.查询妙记列表（按关键词/所有者/参与者/时间范围）；2.获取妙记基础信息（标题、封面、时长 等）；3.下载妙记音视频文件；4.获取妙记相关 AI 产物（总结、待办、章节）。飞书妙记 URL 格式: http(s)://<host>/minutes/<minute-token>"metadata:  requires:    bins: ["lark-cli"]  cliHelp: "lark-cli minutes --help"--- # minutes (v1) **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../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](../lark-vc/references/lark-vc-search.md) 先定位会议，再按需通过 [vc +recording](../lark-vc/references/lark-vc-recording.md) 获取 `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](references/lark-minutes-download.md)。2. `minutes +download` 只负责音视频媒体文件。3. 用户只想拿可分享的下载地址时，使用 `--url-only`；用户要落地到本地文件时，直接下载。 > **注意**：`+download` 只负责音视频媒体文件。如果用户需要的是逐字稿、总结、待办、章节等纪要内容，请使用 [vc +notes --minute-tokens](../lark-vc/references/lark-vc-notes.md)。 ### 4. 获取妙记的逐字稿、总结、待办、章节 1. 当用户说"这个妙记的逐字稿""总结""待办""章节"时，**不属于本 skill**。2. 应使用 [vc +notes --minute-tokens](../lark-vc/references/lark-vc-notes.md) 获取对应的纪要产物。3. 如果当前上下文中已有 `minute_token`，可直接传给 `vc +notes`；如果只有妙记 URL，先提取 `minute_token`。 ```bash# 通过 minute_token 获取纪要产物（逐字稿、总结、待办、章节）lark-cli vc +notes --minute-tokens <minute_token>``` > **跨 skill 路由**：逐字稿、AI 总结、待办、章节等纪要内容由 [lark-vc](../lark-vc/SKILL.md) 的 `+notes` 命令提供 ## 资源关系 ```textMinutes (妙记) ← minute_token 标识├── Metadata (标题、封面、时长、owner、url) → minutes minutes get└── MediaFile (音频/视频文件) → minutes +download``` > **能力边界**：`minutes` 负责 **搜索妙记、查看基础元信息、下载音视频文件**。>> **路由规则**：>> - 用户说"妙记列表 / 搜索妙记 / 某个关键词的妙记" → `minutes +search`> - 用户只是想看"我的妙记 / 某段时间内的妙记 / 妙记列表"，不要先走 [lark-vc](../lark-vc/SKILL.md)，而应直接使用本 skill> - 用户如果同时提到"会议 / 会 / 开会 / 某场会"，即使也提到了"妙记"，也应优先走 [lark-vc](../lark-vc/SKILL.md) 先定位会议，再通过 [vc +recording](../lark-vc/references/lark-vc-recording.md) 获取 `minute_token`> - 用户说"我的妙记 / 我拥有的妙记 / 我参与的妙记"时，可将相关过滤条件映射为 `me`；`me` 表示当前用户> - 结果有多页时，使用 `page_token` 持续翻页，直到确认没有更多结果> - `minutes +search` 单次最多返回 `200` 条；结果总数没有固定上限> - 用户说"这个妙记的标题 / 时长 / 封面 / 链接" → `minutes minutes get`> - 用户说"下载这个妙记的视频 / 音频 / 媒体文件" → `minutes +download`> - 用户说"这个妙记的逐字稿 / 总结 / 待办 / 章节" → 使用 [vc +notes --minute-tokens](../lark-vc/references/lark-vc-notes.md) ## Shortcuts（推荐优先使用） Shortcut 是对常用操作的高级封装（`lark-cli minutes +<verb> [flags]`）。有 Shortcut 的操作优先使用。 | Shortcut                                           | 说明                                                              || -------------------------------------------------- | --------------------------------------------------------------- || [`+search`](references/lark-minutes-search.md)     | Search minutes by keyword, owners, participants, and time range || [`+download`](references/lark-minutes-download.md) | Download audio/video media file of a minute                     | - 使用 `+search` 命令时，必须阅读 [references/lark-minutes-search.md](references/lark-minutes-search.md)，了解搜索参数和返回值结构。- 使用 `+download` 命令时，必须阅读 [references/lark-minutes-download.md](references/lark-minutes-download.md)，了解下载参数和返回值结构。 <!-- AUTO-GENERATED-START — gen-skills.py 管理，勿手动编辑 --> ## API Resources ```bashlark-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 -->