lark

飞书/Lark 全功能操作方案。当需要发消息、管理日程/会议室、操作云文档/多维表格/电子表格/知识库、处理任务/邮件/OKR/考勤/审批，或进行视频会议时使用。

Repositorio: justcyl/my-skills
Última actividad en el origen: 19 de junio de 2026 a las 13:25
Idioma detectado de SKILL.md: chino
Estrellas: 0
Forks: 0

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

npx skills add https://github.com/justcyl/my-skills --skill lark

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

Explorador de archivos

100 archivos

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

Explorador de archivos

100 archivos

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

name	lark
version	1.0.0
description	飞书/Lark 全功能操作方案。当需要发消息、管理日程/会议室、操作云文档/多维表格/电子表格/知识库、处理任务/邮件/OKR/考勤/审批，或进行视频会议时使用。
metadata	{"requires":{"bins":["lark-cli"]}}

lark-cli 全功能指南

本 skill 合并了全部 23 个飞书子 skill，统一入口。使用前必须先完成 配置初始化 和认证（见 § 0）。

§ 0. 共享基础（所有域通用）

配置初始化

首次使用需运行 lark-cli config init 完成应用配置。

以 background 方式发起配置，读取输出中的授权链接发给用户：

# 发起配置（阻塞直到用户打开链接并完成操作或过期）
lark-cli config init --new

身份类型

两种身份类型，通过 --as 切换：

身份	标识	获取方式	适用场景
user 用户身份	`--as user`	`lark-cli auth login`	访问用户自己的资源（日历、云空间等）
bot 应用身份	`--as bot`	自动，只需 appId + appSecret	应用级操作，访问 bot 自己的资源

身份选择原则：

Bot 看不到用户资源：无法访问用户的日历、云空间文档、邮箱等个人资源
Bot 无法代表用户操作：发消息以应用名义发送，创建文档归属 bot
Bot 权限：只需在飞书开发者后台开通 scope，无需 auth login
User 权限：后台开通 scope + 用户通过 auth login 授权，两层都要满足

权限不足处理

错误响应关键字段：permission_violations（缺失 scope）、console_url（后台链接）、hint（修复命令）

Bot 身份：将 console_url 发给用户去后台开通 scope。禁止对 bot 执行 auth login。

User 身份：

lark-cli auth login --domain <domain>           # 按业务域授权
lark-cli auth login --scope "<missing_scope>"   # 按具体 scope 授权（推荐）

auth login 必须指定范围（--domain 或 --scope）。多次 login 的 scope 会累积（增量授权）。

Agent 代理认证（推荐）：以 background 方式执行，将授权链接发给用户：

lark-cli auth login --scope "calendar:calendar:readonly"

更新检查

命令执行后，如输出包含 _notice.update 字段，完成当前请求后提议更新：

lark-cli update --check --json

如果用户明确要求更新 CLI，执行：

lark-cli update --json

Lark 相关 Skills 不通过 npx skills add 或外部 Skills CLI 管理；需要更新 / 导入 / 分发时，必须回到 ~/project/my-skills 使用 skills-manager。更新完成后提醒用户退出并重新打开 AI Agent 以加载最新 Skills。

安全规则

禁止输出密钥（appSecret、accessToken）到终端明文
写入/删除操作前必须确认用户意图
用 --dry-run 预览危险请求

§ 1. 域路由总表

域	触发场景	CLI 入口	详细节
§ 2 IM	发消息、群聊、聊天记录、下载图片/文件	`lark-cli im`	—
§ 3 Calendar	日程、会议预约、会议室、空闲时段	`lark-cli calendar`	—
§ 4 Doc	创建/读取/更新飞书文档	`lark-cli docs`	—
§ 5 Drive	上传/下载/搜索文件、权限、评论	`lark-cli drive`	—
§ 6 Base	多维表格表结构、记录、视图、dashboard	`lark-cli base`	94 refs
§ 7 Sheets	电子表格读写、查找、导出	`lark-cli sheets`	39 refs
§ 8 Slides	幻灯片创建/编辑	`lark-cli slides`	—
§ 9 Task	任务、清单、子任务、提醒	`lark-cli task`	—
§ 10 Mail	邮件收发、草稿、监听	`lark-cli mail`	—
§ 11 Wiki	知识空间、节点、成员	`lark-cli wiki`	—
§ 12 Contact	搜索用户、获取 open_id	`lark-cli contact`	—
§ 13 VC	会议记录、纪要、逐字稿	`lark-cli vc`	—
§ 14 Event	WebSocket 实时事件订阅	`lark-cli event`	—
§ 15 OKR	OKR 周期、目标、关键结果

§ 2. 消息（IM）

CRITICAL — 操作前必读 § 0 共享基础

核心概念

Message：单条消息，message_id（om_xxx）。支持类型：text、post、image、file、audio、video、sticker、interactive（card）等
Chat：群聊或 P2P 会话，chat_id（oc_xxx）
Thread：消息的回复线程，thread_id（om_xxx 或 omt_xxx）

Chat (oc_xxx)
├── Message (om_xxx)
│   ├── Thread（回复线程）
│   ├── Reaction（表情）
│   └── Resource（图片/文件/视频/音频）
└── Member（用户/bot）

身份注意

--as user → user_access_token，以授权用户身份操作
--as bot → tenant_access_token，以应用 bot 身份操作
同一 API 两种身份结果差异大，注意 chat 成员资格、可见范围等

Bot 身份获取消息时发件人名称可能不解析：原因是 bot 应用可见范围未覆盖发送者。解决：在开发者后台调整应用可见范围，或改用 --as user。

Shortcuts（推荐优先使用）

lark-cli im +<verb> [flags]

Shortcut	说明
`+chat-create`	创建群聊，邀请成员，设置 bot 管理员
`+chat-messages-list`	列出群/P2P 消息，支持时间范围/排序/分页
`+chat-search`	按关键词/成员搜索可见群聊
`+chat-update`	更新群名称或描述
`+messages-mget`	批量获取消息（最多 50 条 om_id）
`+messages-reply`	回复消息，支持线程回复和富媒体
`+messages-resources-download`	下载消息中的图片/文件，支持大文件分片（8MB chunks）
`+messages-search`	跨群搜索消息（user only），支持关键词/发件人/时间/附件过滤
`+messages-send`	发送消息（text/markdown/post/media），支持幂等 key
`+threads-messages-list`	列出线程消息，支持排序/分页

API Resources

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

Resource	方法	身份
chats	create/get/link/list/update	bot/user
chat.members	bots/create/delete/get	bot/user
messages	delete/forward/merge_forward/read_users	bot(后三者仅bot)
reactions	batch_query/create/delete/list	bot/user
images	create	bot only
pins	create/delete/list	bot/user

权限表

方法	scope
chats.create	`im:chat:create`
chats.get/link/list	`im:chat:read`
chats.update	`im:chat:update`
chat.members.bots/get	`im:chat.members:read`
chat.members.create/delete	`im:chat.members:write_only`
messages.delete/forward/merge_forward	`im:message`
messages.read_users	`im:message:readonly`
reactions.batch_query/list	`im:message.reactions:read`
reactions.create/delete	`im:message.reactions:write_only`
images.create	`im:resource`
pins.create/delete	`im:message.pins:write_only`
pins.list	`im:message.pins:read`

§ 3. 日历（Calendar）

CRITICAL — 操作前必读 § 0 共享基础 CRITICAL — 所有 Shortcut 执行前，必须先用 Read 工具读取对应说明文档，禁止直接盲目调用。 CRITICAL — 涉及【预约日程/会议】或【查询/搜索会议室】→ 第一步必须读 references/calendar/lark-calendar-schedule-meeting.md。 CRITICAL — 口语"帮我约个日历"/"查一下今天的日历" → 实际是日程操作，映射为 +create/+agenda。 CRITICAL — 查询过去时间的会议（"昨天的会""上周的会"）→ 优先走 § 13 VC 搜会议记录。查询日历/日程或未来时间安排 → 使用本域。 CRITICAL — 删除/修改日程后，二次查询验证需等待至少 2 秒（不要告知用户等待）。

时间推断规范：

周一是一周第一天，周日是最后一天
"今天/明天"时间范围覆盖整天
不能预约已完全过去的时间（跨越当前时间的除外）

核心概念

Calendar：日程容器。每用户有主日历（primary），也可创建/订阅共享日历
Event：日程。支持单次和重复日程（RFC5545 iCalendar 标准）
Instance：日程的具体时间实例（重复日程展开后每条）
Attendee：参与者（用户/群/会议室/外部邮箱），各有独立 RSVP 状态
Room：会议室（是日程的 resource attendee，不能单独预定）
Time Slot：确定的连续时间段，如 14:00~15:00

核心场景

预约日程/会议、查询/搜索可用会议室

阻塞要求： 有"预约日程/会议"或"查询/搜索可用会议室"意图 → 立即停止，先完整读取 references/calendar/lark-calendar-schedule-meeting.md，未读前禁止执行任何操作。

有明确时间 → 先 +room-find，再 +freebusy
时间模糊/无时间 → 先 +suggestion 拿候选时间块，再 +room-find
用户"查会议室"但未提供明确时间 → 禁止直接调用 +room-find，必须先 +suggestion
选定时间/会议室方案前必须展示给用户确认，禁止擅自决定

Shortcuts

lark-cli calendar +<verb> [flags]

Shortcut	说明
`+agenda`	查看日程安排（默认今天）
`+create`	创建日程，邀请参会人（ISO 8601 时间）
`+freebusy`	查询用户主日历忙闲信息和 RSVP 状态
`+room-find`	针对明确时间块查找可用会议室（无明确时间时禁止直接调用）
`+rsvp`	回复日程邀请（接受/拒绝/待定）
`+suggestion`	根据模糊时间/时间范围推荐多个可用时间块

API Resources

lark-cli schema calendar.<resource>.<method>
lark-cli calendar <resource> <method> [flags]

calendars: create/delete/get/list/patch/primary/search event.attendees: batch_delete/create/list events: create/delete/get/instance_view/patch/search/share_info freebusys: list

权限表

scope	覆盖方法
`calendar:calendar:create`	calendars.create
`calendar:calendar:delete`	calendars.delete
`calendar:calendar:read`	calendars.get/list/patch/primary/search
`calendar:calendar:update`	calendars.patch
`calendar:calendar.event:create`	events.create
`calendar:calendar.event:delete`	events.delete
`calendar:calendar.event:read`	events.get/instance_view/search/share_info，event.attendees.list
`calendar:calendar.event:update`	events.patch，event.attendees.batch_delete/create
`calendar:calendar.free_busy:read`	freebusys.list

注意：日期/时间戳转换必须调用系统命令（如 date），不要心算。

§ 4. 云文档（Doc）

CRITICAL — 操作前必读 § 0 共享基础 ⚠️ API 版本：所有 docs +create、docs +fetch、docs +update 必须携带 --api-version v2。 CRITICAL — 文档中出现 <sheet>、<bitable>、<cite file-type="sheets|bitable"> 标签时，必须主动提取 token 并切到对应技能（§ 7 Sheets / § 6 Base）下钻读取。

执行操作前必读：

读取文档（docs +fetch） → 读 references/doc/lark-doc-fetch.md
创建/编辑文档内容 → 读 references/doc/lark-doc-xml.md（Markdown 时改读 references/doc/lark-doc-md.md）；从零创建时加读 references/doc/style/lark-doc-create-workflow.md；编辑已有时加读 references/doc/style/lark-doc-update-workflow.md

# 常用示例
lark-cli docs +fetch  --api-version v2 --doc "文档URL或token"
lark-cli docs +create --api-version v2 --content '<title>标题</title><p>内容</p>'
lark-cli docs +update --api-version v2 --doc "文档URL或token" --command append --content '<p>内容</p>'

嵌入对象路由

标签	参数提取	目标域
`<sheet token="..." sheet-id="...">`	token → spreadsheet_token	§ 7 Sheets
`<bitable token="..." table-id="...">`	token → app_token	§ 6 Base
`<cite type="doc" file-type="sheets" ...>`	同 `<sheet>`	§ 7 Sheets
`<cite type="doc" file-type="bitable" ...>`	同 `<bitable>`	§ 6 Base
`<synced_reference src-token="..." src-block-id="...">`	用 `docs +fetch` 读取 src-token	§ 4 Doc

下游路由

拿到 spreadsheet URL/token → 切 § 7 Sheets
拿到 bitable URL/token → 切 § 6 Base
搜索云空间文档 → 优先用 drive +search（§ 5 Drive）

Shortcuts

Shortcut	说明
`+fetch`	读取文档（支持 simple/with-ids/full，5种局部读取模式）
`+create`	创建文档（DocxXML 或 Markdown）
`+update`	更新文档（8种指令：str_replace/block_insert_after/overwrite/append 等）
`+media-download`	下载文档中的图片/文件
`+media-insert`	向文档插入图片/文件
`+search`	搜索云空间文档（已进入维护期，新场景改用 `drive +search`）

§ 5. 云空间（Drive）

CRITICAL — 操作前必读 § 0 共享基础 分流规则： 把本地文件导入成 Base/多维表格 → drive +import --type bitable（先导入，再切 § 6 Base 做内部操作）。

快速决策

搜文档/Wiki/电子表格/多维表格/云空间对象 → drive +search（扁平 flag，无需手写 JSON）
导入本地 .xlsx/.csv/.base 为 Base → drive +import --type bitable
导入本地 .md/.docx/.html 为在线文档 → drive +import --type docx
导入本地 .xlsx/.csv 为电子表格 → drive +import --type sheet
新建文件夹 → drive +create-folder
上传到知识库节点下 → drive +upload --wiki-token <wiki_token>
修改文件标题（docx/sheet/bitable/file/folder/wiki）→ drive files patch --data '{"new_title":"..."}'

Wiki 链接特殊处理

/wiki/<token> 背后可能是不同类型文档，不能直接用作 file_token：

# 先查实际类型和真实 token
lark-cli wiki spaces get_node --params '{"token":"<wiki_token>"}'
# 返回 node.obj_type（docx/sheet/bitable/slides 等）和 node.obj_token（真实 token）

Shortcuts

Shortcut	说明
`+search`	搜索云空间对象（支持 --mine/--edited-since/--doc-types 等扁平 flag）
`+upload`	上传文件到云空间
`+download`	下载文件
`+import`	导入本地文件为在线文档（docx/sheet/bitable）
`+export`	导出在线文档为本地格式
`+create-folder`	创建文件夹
`+move`	移动文件
`+delete`	删除文件
`+add-comment`	添加评论（支持 sheet cell 评论）
`+apply-permission`	管理文档权限

§ 6. 多维表格（Base）

CRITICAL — 操作前必读 § 0 共享基础 CRITICAL — 执行任何 base 命令前必须先读对应命令的 reference 文档，再调用命令。 分流规则： 本地文件导入 Base → 第一步是 drive +import --type bitable，导入完成后再用 base +... 做内部操作。

触发条件

操作飞书多维表格 / Base
建表/改表/查表/字段管理/记录读写/视图配置
公式字段、lookup 字段、派生指标、跨表计算
临时统计、聚合分析、比较排序
Workflow/dashboard/表单/角色权限管理
用户给出 /base/{token} 或解析为 bitable 的 /wiki/{token} 链接

模块地图

大模块	包含能力	Reference 入口
Base 模块	base-create/get/copy，链接解析	`references/base/lark-base-workspace.md`
表与数据模块	table/field/record/view	`references/base/lark-base-table.md` + `lark-base-field.md` + `lark-base-record.md` + `lark-base-view.md`
公式/Lookup	派生字段、条件判断、跨表计算	`references/base/formula-field-guide.md` + `lookup-field-guide.md`
数据分析	一次性筛选/分组/聚合	`references/base/lark-base-data-query.md`
Workflow	自动化流程	`references/base/lark-base-workflow.md`
Dashboard	仪表盘和图表组件	`references/base/lark-base-dashboard.md`
表单	表单和表单题目	`references/base/lark-base-form.md`
权限与角色	高级权限、自定义角色	`references/base/lark-base-role-list.md`

所有 base 命令格式：lark-cli base +<verb>
执行前必须先读对应 reference，禁止直接调用。

lark-cli schema base.<resource>.<method>   # 查参数结构
lark-cli base <resource> <method> [flags] # 调用 API

§ 7. 电子表格（Sheets）

CRITICAL — 操作前必读 § 0 共享基础 CRITICAL — 执行 sheets 命令前必须先读对应 reference 文档。

操作前先用 lark-cli schema sheets.<resource>.<method> 查参数结构。

所有 sheets reference 文档在 references/sheets/，按功能分类：

基本操作：create/get/update/append/find — 查 lark-cli sheets --help
导出：+export-csv、+export-xlsx
数据类型：references/sheets/ 下各 .md 文件

lark-cli schema sheets.<resource>.<method>
lark-cli sheets <resource> <method> [flags]

§ 8. 演示文稿（Slides）

CRITICAL — 操作前必读 § 0 共享基础

Shortcuts

Shortcut	说明
`+create`	创建演示文稿
`+media-upload`	上传本地图片供 Slides XML 使用
`+replace-slide`	块级 XML 编辑（block_replace/block_insert）
`xml_presentations get`	读取演示文稿 XML 内容
`xml_presentation.slide create`	添加幻灯片页
`xml_presentation.slide delete`	删除幻灯片页
`xml_presentation.slide get`	读取单页幻灯片 XML
`xml_presentation.slide replace`	替换单页幻灯片 XML

所有 slides reference 文档在 references/slides/。
使用 +replace-slide 前必须读 references/slides/lark-slides-replace-slide.md。

lark-cli schema slides.<resource>.<method>
lark-cli slides <resource> <method> [flags]

§ 9. 任务（Task）

CRITICAL — 操作前必读 § 0 共享基础

搜索 vs 列取决策：

有明确查询关键字 → +search
无关键字，只有范围条件（"我关注的/由我创建/分配给我"）→ 优先 +get-related-tasks 或 +get-my-tasks
不要把时间范围词（"今年以来"）误当 query 参数
用户提到"todo"（待办）→ 优先理解为 task

创建/更新注意：

设置 repeat_rule 或 reminder 之前必须先设置 due
同时设置 start 和 due 时，开始时间 ≤ 截止时间
bot 身份无法跨租户添加任务成员

Task GUID：API 中的 guid 是全局唯一标识，不是客户端展示的任务编号（t104121）。从 applink 取 guid 参数。

输出要求：同时输出任务的 url 字段，便于用户点击跳转。

Shortcuts

lark-cli task +<verb> [flags]

Shortcut	说明
`+create`	创建任务
`+update`	更新任务
`+complete`	完成任务
`+reopen`	重新打开任务
`+assign`	分配/移除任务成员
`+comment`	添加评论
`+get-my-tasks`	列出分配给我的任务
`+get-related-tasks`	列出与我相关的任务
`+search`	搜索任务（有关键字时用）
`+tasklist-create`	创建清单并批量添加任务
`+tasklist-search`	搜索清单
`+tasklist-task-add`	将任务加入清单
`+tasklist-members`	管理清单成员
`+set-ancestor`	设置/清除父任务

权限表（部分）

方法	scope
tasks CRUD	`task:task:write` / `task:task:read`
tasklists CRUD	`task:tasklist:write` / `task:tasklist:read`
subtasks CRUD	`task:task:write` / `task:task:read`
custom_fields	`task:custom_field:write` / `task:custom_field:read`

§ 10. 邮件（Mail）

CRITICAL — 操作前必读 § 0 共享基础

所有 mail reference 文档在 references/mail/，执行对应操作前先读相应文档。

lark-cli schema mail.<resource>.<method>
lark-cli mail <resource> <method> [flags]

功能类别	相关 Reference
邮件列表/搜索/读取	`references/mail/` 下对应文档
发送/回复/转发	同上
草稿管理	同上
监听新邮件	同上
邮件分享到 IM	`references/mail/lark-mail-share-to-chat.md`

§ 11. 知识库（Wiki）

CRITICAL — 操作前必读 § 0 共享基础

成员管理限制：

--as bot + 部门 → 不支持，直接说明路径不可行，不要试错
bot 路径无法完成时不要静默切换到 user；若用户明确要求 bot，必须说明无法完成

快速决策：

用户给 wiki URL（.../wiki/<token>），后续要查/加/删成员 → 先 wiki spaces get_node 获取 space_id
删除知识空间只有名称/URL → 必须先解析出真实 space_id，展示候选让用户确认后再执行
命中 0 条 → 停下询问，不要改名重试
"我的文档库/My Document Library/个人知识库" → Wiki personal library，不是 Drive 根目录

成员添加流程：先把"人/群/部门"解析成正确 member_id 再调用：

用户 → contact +search-user 获取 open_id（member_type=openid）
群 → im +chat-search 获取 chat_id（member_type=openchat）
部门（user 身份）→ 搜索 open_department_id（member_type=opendepartmentid）

Shortcuts

Shortcut	说明
`+move`	移动 wiki 节点，或将 Drive 文档移入 Wiki
`+node-create`	创建 wiki 节点（自动解析 space）
`+delete-space`	删除知识空间（高风险，需显式 `--yes`）

API Resources

spaces: create/get/get_node/list members: create/delete/list nodes: copy/create/list

权限表

方法	scope
spaces.create	`wiki:space:write_only`
spaces.get/list	`wiki:space:read` / `wiki:space:retrieve`
spaces.get_node	`wiki:node:read`
members.create	`wiki:member:create`
members.delete	`wiki:member:update`
members.list	`wiki:member:retrieve`
nodes.copy	`wiki:node:copy`
nodes.create	`wiki:node:create`
nodes.list	`wiki:node:retrieve`

§ 12. 通讯录（Contact）

CRITICAL — 操作前必读 § 0 共享基础

Shortcuts

Shortcut	说明
`+search-user`	按姓名/邮箱/手机号搜索用户（按相关性排序）
`+get-user`	获取用户信息（省略 user_id 则查自己）

§ 13. 视频会议（VC）

CRITICAL — 操作前必读 § 0 共享基础

路由规则：

查询已结束的会议（历史日期/昨天/上周/今天已开的会）→ 使用本域
查询未来的会议日程/日历 → 使用 § 3 Calendar

核心概念

Meeting：视频会议实例，meeting_id 标识
Note：会议纪要，含 AI 总结、待办、章节（note_doc_token）
VerbatimDoc：逐字稿，含说话人和时间戳（verbatim_doc_token）
MeetingNotes：用户绑定的纪要文档（meeting_notes，仅 --calendar-event-ids 路径返回）
Minutes：来自录制产物的妙记，minute_token 标识 → 详见 § 17 Minutes

核心场景

搜索会议记录：仅支持已结束会议，支持关键词/时间段/参与人/组织者/会议室筛选，注意分页。

整理会议纪要：

默认给纪要文档和逐字稿链接即可，无需读取内容
用户明确要总结/待办/章节时才读文档
读 note_doc_token 时，第一个 <whiteboard> 标签是封面图，应一并下载展示

# 读纪要内容
lark-cli docs +fetch --api-version v2 --doc <note_doc_token> --doc-format markdown
# 下载封面图
lark-cli docs +media-download --type whiteboard --token <whiteboard_token> --output ./minutes/<minute_token>/cover

产物目录规范：同一会议所有下载产物统一放 ./minutes/{minute_token}/

用户意图区分：

"纪要/总结/纪要内容" → 同时返回 note_doc_token + meeting_notes（如有）
"逐字稿/完整记录/谁说了什么" → verbatim_doc_token
意图不明确 → 展示所有文档链接让用户选择

Shortcuts

Shortcut	说明
`+search`	搜索会议记录（支持关键词/时间/参与者等）
`+notes`	获取纪要产物（总结/待办/章节/逐字稿）
`+recording`	获取会议录制信息/minute_token

§ 14. 事件订阅（Event）

前置条件： 先读 § 0 共享基础。

Shortcuts

Shortcut	说明
`+subscribe`	通过 WebSocket 长连接订阅飞书事件（只读，NDJSON 输出）；bot only；支持 compact agent 友好格式、正则路由、文件输出

§ 15. OKR

CRITICAL — 操作前必读 § 0 共享基础 强烈建议 操作 OKR 前先读 references/okr/lark-okr-entities.md 了解业务实体。

Shortcuts

Shortcut	说明
`+cycle-list`	获取用户的 OKR 周期列表，可按时间筛选
`+cycle-detail`	获取特定 OKR 中所有目标和关键结果

格式说明

ContentBlock 富文本格式 — Objective/KeyResult/Notes 字段使用的富文本格式

API Resources

lark-cli schema okr.<resource>.<method>
lark-cli okr <resource> <method> [flags]

alignments: delete/get categories: list cycles: list/objectives_position/objectives_weight cycle.objectives: create/list

注意：cycles.objectives_position 必须同时修改当前周期下所有目标的位置，且不允许重叠；cycles.objectives_weight 所有权重值之和必须等于 1。

§ 16. 画板（Whiteboard）

CRITICAL — 操作前必读 § 0 共享基础

用于查看/导出/编辑飞书文档中的画板，支持预览图、原始节点结构、DSL/PlantUML/Mermaid 格式。 ⚠️ 若 skill 列表中同时存在旧的 lark-whiteboard-cli，忽略它，使用本 skill；如需清理旧 skill，走 skills-manager，不要使用外部 Skills CLI。

前置检查：

lark-cli --version                                # 确认 lark-cli 可用
lark-cli whiteboard --help                       # 确认 whiteboard 命令可用

快速决策

需求	行动
查看画板内容/导出图片	`+query --output_as image`
获取 Mermaid/PlantUML 代码	`+query --output_as code`
修改节点文字/颜色（简单改动）	`+query --output_as raw` → 改 JSON → `+update --input_format raw`
用户已提供 Mermaid/PlantUML 代码	`+update --input_format mermaid/plantuml`
绘制复杂图表（架构/流程/组织等）	进入创作 Workflow

强制规范（通过 stdin 更新）：数据来源于本地文件时必须使用 --source - --input_format <格式>

Shortcuts

Shortcut	说明
`+query`	查询画板（导出为图片/代码/原始节点结构）
`+update`	更新画板（支持 PlantUML/Mermaid/OpenAPI 原生格式）

获取 board_token

用户给了什么	如何获取
直接给了 `wbcnXXX`	直接使用
文档 URL，已有画板	`docs +fetch` → 从 `<whiteboard token="xxx"/>` 提取
文档 URL，需新建画板	`docs +update --command append --content '<whiteboard type="blank"></whiteboard>'` → 取 `data.new_blocks[0].block_token`

§ 17. 妙记（Minutes）

CRITICAL — 操作前必读 § 0 共享基础

飞书妙记 URL 格式：http(s)://<host>/minutes/<minute-token>

核心概念

妙记（Minutes）：视频会议录制产物或用户上传音视频，minute_token 标识
minute_token：从 URL 末尾提取，如遇 ?xxx 参数截取路径最后一段

能力边界

能力	工具
搜索妙记列表	`minutes +search`
查看基础信息（标题/封面/时长）	`minutes minutes get`
下载音视频媒体文件	`minutes +download`
逐字稿/总结/待办/章节（纪要内容）	⚠️ 不属于本域 → 用 § 13 VC 的 `vc +notes --minute-tokens`

路由规则

"我的妙记/某关键词/某段时间内的妙记" → minutes +search
同时提到"会议/开会/某场会" → 优先走 § 13 VC 先定位会议，再通过 vc +recording 获取 minute_token
"这个妙记的逐字稿/总结/待办/章节" → vc +notes --minute-tokens

Shortcuts

Shortcut	说明
`+search`	按关键词/所有者/参与者/时间范围搜索妙记
`+download`	下载妙记音视频文件（`--url-only` 只返回下载链接）

未显式指定路径时，文件默认落到 ./minutes/{minute_token}/<server-filename>

§ 18. 考勤（Attendance）

CRITICAL — 操作前必读 § 0 共享基础

默认参数（必须自动填充，禁止询问用户）

参数	固定值
`employee_type`	`"employee_no"`
`user_ids`（`--data` 中）	`[]`（空数组）

lark-cli schema attendance.user_tasks.query   # 查参数结构
lark-cli attendance user_tasks query --data '{"user_ids":[],"...":"..."}'

权限表

方法	scope
`user_tasks.query`	`attendance:task:readonly`

§ 19. 审批（Approval）

CRITICAL — 操作前必读 § 0 共享基础

lark-cli schema approval.<resource>.<method>
lark-cli approval <resource> <method> [flags]

API Resources

instances: get/cancel/cc/initiated tasks: remind/approve/reject/transfer/query

权限表

方法	scope
instances.get/initiated	`approval:instance:read`
instances.cancel/cc	`approval:instance:write`
tasks.remind/approve/reject/transfer	`approval:task:write` / `approval:instance:write`
tasks.query	`approval:task:read`

§ 20. OpenAPI Explorer

前置条件： 先读 § 0 共享基础。

当现有 skill 或 CLI 已注册命令无法覆盖用户需求时，用本域从飞书官方文档库挖掘原生 API。

文档库

llms.txt                    ← 顶层索引（所有模块文档链接）
  └─ llms-<module>.txt      ← 模块文档（功能概述 + API 文档链接）
       └─ <api-doc>.md      ← 单个 API（方法/路径/参数/响应/错误码）

品牌	入口
飞书	`https://open.feishu.cn/llms.txt`
Lark	`https://open.larksuite.com/llms.txt`

挖掘流程

Step 1：确认现有能力不足

lark-cli <service> --help   # 检查是否已有对应命令

如果已有对应命令或 shortcut → 直接使用，不继续挖掘。

Step 2：顶层索引定位模块 用 WebFetch 获取 llms.txt，找到相关模块文档链接。

Step 3：模块文档找 API 用 WebFetch 获取模块文档，找到相关 API 文档链接。

Step 4：读取 API 文档 获取完整的方法、路径、参数、权限信息。

Step 5：调用 API

lark-cli api GET /open-apis/<path> --params '{"key":"value"}'
lark-cli api POST /open-apis/<path> --data '{"key":"value"}'

§ 21. 自定义 Skill 创建

CLI 核心能力

lark-cli <service> <resource> <method>          # 已注册 API
lark-cli <service> +<verb>                      # Shortcut
lark-cli api <METHOD> <path> [--data/--params]  # 任意 OpenAPI
lark-cli schema <service.resource.method>       # 查参数定义

优先级：Shortcut > 已注册 API > api 裸调。

调研 API

lark-cli <service> --help                                           # 查已有资源和 Shortcut
lark-cli schema <service.resource.method>                           # 查参数
lark-cli api GET /open-apis/vc/v1/rooms --params '{"page_size":"50"}'  # 未注册 API 直接调用

未注册 API → 先用 § 20 OpenAPI Explorer 从官方文档挖掘。

SKILL.md 模板

---
name: lark-<name>
version: 1.0.0
description: "..."
metadata:
  requires:
    bins: ["lark-cli"]
  cliHelp: "lark-cli <service> --help"
---

# <name>

**CRITICAL — 开始前 MUST 先用 Read 工具读取 [§ 0 共享基础](../lark/SKILL.md#-0-共享基础所有域通用)**

## Shortcuts
...

§ 22. 工作流：会议纪要汇总

仅支持 user 身份。

lark-cli auth login --domain vc         # 基础（查询+纪要）
lark-cli auth login --domain vc,drive   # 含读取纪要文档正文/生成文档

工作流

{时间范围} ─► vc +search ──► 会议列表 (meeting_ids)
                   │
                   ▼
               vc +notes ──► 纪要文档 tokens
                   │
                   ▼
               drive metas batch_query 纪要元数据
                   │
                   ▼
               结构化报告

步骤

Step 1：确定时间范围（默认过去 7 天）

日期转换必须调用系统命令（如 date），不要心算。

"今天"→当天，"这周"→本周一～now，"上周"→上周一～上周日，"这个月"→1日～now

Step 2：查询会议记录

lark-cli vc +search --start "<YYYY-MM-DD>" --end "<YYYY-MM-DD>" --format json --page-size 30

--end 包含当天（查"今天"时 start 和 end 都填今天）
搜索范围最大 1 个月，更长时拆分多次查询
有 page_token 时继续翻页，收集所有 id（meeting_id）

Step 3：获取纪要文档

lark-cli vc +notes --meeting-ids "<meeting_id1>,<meeting_id2>"

Step 4：获取纪要元数据

lark-cli schema drive.metas.batch_query
lark-cli drive metas batch_query ...  # 最多 10 个文档

Step 5：汇总输出 按时间排序，输出会议标题、时间、参与人、纪要链接，合并同一天的会议。

§ 23. 工作流：日程待办摘要

仅支持 user 身份。

lark-cli auth login --domain calendar,task

工作流

{date} ─┬─► calendar +agenda ──► 日程列表
        └─► task +get-my-tasks ──► 未完成待办列表
                    │
                    ▼
              AI 汇总（冲突检测 + 排序）──► 摘要

步骤

Step 1：获取日程

# 今天（默认）
lark-cli calendar +agenda

# 指定日期（必须 ISO 8601，不支持 "tomorrow" 等自然语言）
lark-cli calendar +agenda --start "2026-03-26T00:00:00+08:00" --end "2026-03-26T23:59:59+08:00"

--start/--end 只支持 ISO 8601 或 Unix timestamp，不支持 "tomorrow"，需 AI 根据当前日期自行计算。

Step 2：获取未完成待办

lark-cli task +get-my-tasks              # 默认最多 20 条
lark-cli task +get-my-tasks --due-end "2026-03-26T23:59:59+08:00"  # 截止时间过滤

Step 3：AI 汇总

时间戳转本地时区可读时间
冲突检测：同一时间段有多个日程时标注
按时间排序
格式：先日程（含地点/参会人），再待办（含截止时间/优先级）

name	lark
version	1.0.0
description	飞书/Lark 全功能操作方案。当需要发消息、管理日程/会议室、操作云文档/多维表格/电子表格/知识库、处理任务/邮件/OKR/考勤/审批，或进行视频会议时使用。
metadata	{"requires":{"bins":["lark-cli"]}}

lark-cli 全功能指南

本 skill 合并了全部 23 个飞书子 skill，统一入口。使用前必须先完成 配置初始化 和认证（见 § 0）。

§ 0. 共享基础（所有域通用）

配置初始化

首次使用需运行 lark-cli config init 完成应用配置。

以 background 方式发起配置，读取输出中的授权链接发给用户：

# 发起配置（阻塞直到用户打开链接并完成操作或过期）
lark-cli config init --new

身份类型

两种身份类型，通过 --as 切换：

身份	标识	获取方式	适用场景
user 用户身份	`--as user`	`lark-cli auth login`	访问用户自己的资源（日历、云空间等）
bot 应用身份	`--as bot`	自动，只需 appId + appSecret	应用级操作，访问 bot 自己的资源

身份选择原则：

Bot 看不到用户资源：无法访问用户的日历、云空间文档、邮箱等个人资源
Bot 无法代表用户操作：发消息以应用名义发送，创建文档归属 bot
Bot 权限：只需在飞书开发者后台开通 scope，无需 auth login
User 权限：后台开通 scope + 用户通过 auth login 授权，两层都要满足

权限不足处理

错误响应关键字段：permission_violations（缺失 scope）、console_url（后台链接）、hint（修复命令）

Bot 身份：将 console_url 发给用户去后台开通 scope。禁止对 bot 执行 auth login。

User 身份：

lark-cli auth login --domain <domain>           # 按业务域授权
lark-cli auth login --scope "<missing_scope>"   # 按具体 scope 授权（推荐）

auth login 必须指定范围（--domain 或 --scope）。多次 login 的 scope 会累积（增量授权）。

Agent 代理认证（推荐）：以 background 方式执行，将授权链接发给用户：

lark-cli auth login --scope "calendar:calendar:readonly"

更新检查

命令执行后，如输出包含 _notice.update 字段，完成当前请求后提议更新：

lark-cli update --check --json

如果用户明确要求更新 CLI，执行：

lark-cli update --json

安全规则

禁止输出密钥（appSecret、accessToken）到终端明文
写入/删除操作前必须确认用户意图
用 --dry-run 预览危险请求

§ 1. 域路由总表

域	触发场景	CLI 入口	详细节
§ 2 IM	发消息、群聊、聊天记录、下载图片/文件	`lark-cli im`	—
§ 3 Calendar	日程、会议预约、会议室、空闲时段	`lark-cli calendar`	—
§ 4 Doc	创建/读取/更新飞书文档	`lark-cli docs`	—
§ 5 Drive	上传/下载/搜索文件、权限、评论	`lark-cli drive`	—
§ 6 Base	多维表格表结构、记录、视图、dashboard	`lark-cli base`	94 refs
§ 7 Sheets	电子表格读写、查找、导出	`lark-cli sheets`	39 refs
§ 8 Slides	幻灯片创建/编辑	`lark-cli slides`	—
§ 9 Task	任务、清单、子任务、提醒	`lark-cli task`	—
§ 10 Mail	邮件收发、草稿、监听	`lark-cli mail`	—
§ 11 Wiki	知识空间、节点、成员	`lark-cli wiki`	—
§ 12 Contact	搜索用户、获取 open_id	`lark-cli contact`	—
§ 13 VC	会议记录、纪要、逐字稿	`lark-cli vc`	—
§ 14 Event	WebSocket 实时事件订阅	`lark-cli event`	—
§ 15 OKR	OKR 周期、目标、关键结果

§ 2. 消息（IM）

CRITICAL — 操作前必读 § 0 共享基础

核心概念

Message：单条消息，message_id（om_xxx）。支持类型：text、post、image、file、audio、video、sticker、interactive（card）等
Chat：群聊或 P2P 会话，chat_id（oc_xxx）
Thread：消息的回复线程，thread_id（om_xxx 或 omt_xxx）

Chat (oc_xxx)
├── Message (om_xxx)
│   ├── Thread（回复线程）
│   ├── Reaction（表情）
│   └── Resource（图片/文件/视频/音频）
└── Member（用户/bot）

身份注意

--as user → user_access_token，以授权用户身份操作
--as bot → tenant_access_token，以应用 bot 身份操作
同一 API 两种身份结果差异大，注意 chat 成员资格、可见范围等

Bot 身份获取消息时发件人名称可能不解析：原因是 bot 应用可见范围未覆盖发送者。解决：在开发者后台调整应用可见范围，或改用 --as user。

Shortcuts（推荐优先使用）

lark-cli im +<verb> [flags]

Shortcut	说明
`+chat-create`	创建群聊，邀请成员，设置 bot 管理员
`+chat-messages-list`	列出群/P2P 消息，支持时间范围/排序/分页
`+chat-search`	按关键词/成员搜索可见群聊
`+chat-update`	更新群名称或描述
`+messages-mget`	批量获取消息（最多 50 条 om_id）
`+messages-reply`	回复消息，支持线程回复和富媒体
`+messages-resources-download`	下载消息中的图片/文件，支持大文件分片（8MB chunks）
`+messages-search`	跨群搜索消息（user only），支持关键词/发件人/时间/附件过滤
`+messages-send`	发送消息（text/markdown/post/media），支持幂等 key
`+threads-messages-list`	列出线程消息，支持排序/分页

API Resources

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

Resource	方法	身份
chats	create/get/link/list/update	bot/user
chat.members	bots/create/delete/get	bot/user
messages	delete/forward/merge_forward/read_users	bot(后三者仅bot)
reactions	batch_query/create/delete/list	bot/user
images	create	bot only
pins	create/delete/list	bot/user

权限表

方法	scope
chats.create	`im:chat:create`
chats.get/link/list	`im:chat:read`
chats.update	`im:chat:update`
chat.members.bots/get	`im:chat.members:read`
chat.members.create/delete	`im:chat.members:write_only`
messages.delete/forward/merge_forward	`im:message`
messages.read_users	`im:message:readonly`
reactions.batch_query/list	`im:message.reactions:read`
reactions.create/delete	`im:message.reactions:write_only`
images.create	`im:resource`
pins.create/delete	`im:message.pins:write_only`
pins.list	`im:message.pins:read`

§ 3. 日历（Calendar）

时间推断规范：

周一是一周第一天，周日是最后一天
"今天/明天"时间范围覆盖整天
不能预约已完全过去的时间（跨越当前时间的除外）

核心概念

Calendar：日程容器。每用户有主日历（primary），也可创建/订阅共享日历
Event：日程。支持单次和重复日程（RFC5545 iCalendar 标准）
Instance：日程的具体时间实例（重复日程展开后每条）
Attendee：参与者（用户/群/会议室/外部邮箱），各有独立 RSVP 状态
Room：会议室（是日程的 resource attendee，不能单独预定）
Time Slot：确定的连续时间段，如 14:00~15:00

核心场景

预约日程/会议、查询/搜索可用会议室

有明确时间 → 先 +room-find，再 +freebusy
时间模糊/无时间 → 先 +suggestion 拿候选时间块，再 +room-find
用户"查会议室"但未提供明确时间 → 禁止直接调用 +room-find，必须先 +suggestion
选定时间/会议室方案前必须展示给用户确认，禁止擅自决定

Shortcuts

lark-cli calendar +<verb> [flags]

Shortcut	说明
`+agenda`	查看日程安排（默认今天）
`+create`	创建日程，邀请参会人（ISO 8601 时间）
`+freebusy`	查询用户主日历忙闲信息和 RSVP 状态
`+room-find`	针对明确时间块查找可用会议室（无明确时间时禁止直接调用）
`+rsvp`	回复日程邀请（接受/拒绝/待定）
`+suggestion`	根据模糊时间/时间范围推荐多个可用时间块

API Resources

lark-cli schema calendar.<resource>.<method>
lark-cli calendar <resource> <method> [flags]

calendars: create/delete/get/list/patch/primary/search event.attendees: batch_delete/create/list events: create/delete/get/instance_view/patch/search/share_info freebusys: list

权限表

scope	覆盖方法
`calendar:calendar:create`	calendars.create
`calendar:calendar:delete`	calendars.delete
`calendar:calendar:read`	calendars.get/list/patch/primary/search
`calendar:calendar:update`	calendars.patch
`calendar:calendar.event:create`	events.create
`calendar:calendar.event:delete`	events.delete
`calendar:calendar.event:read`	events.get/instance_view/search/share_info，event.attendees.list
`calendar:calendar.event:update`	events.patch，event.attendees.batch_delete/create
`calendar:calendar.free_busy:read`	freebusys.list

注意：日期/时间戳转换必须调用系统命令（如 date），不要心算。

§ 4. 云文档（Doc）

执行操作前必读：

读取文档（docs +fetch） → 读 references/doc/lark-doc-fetch.md
创建/编辑文档内容 → 读 references/doc/lark-doc-xml.md（Markdown 时改读 references/doc/lark-doc-md.md）；从零创建时加读 references/doc/style/lark-doc-create-workflow.md；编辑已有时加读 references/doc/style/lark-doc-update-workflow.md

# 常用示例
lark-cli docs +fetch  --api-version v2 --doc "文档URL或token"
lark-cli docs +create --api-version v2 --content '<title>标题</title><p>内容</p>'
lark-cli docs +update --api-version v2 --doc "文档URL或token" --command append --content '<p>内容</p>'

嵌入对象路由

标签	参数提取	目标域
`<sheet token="..." sheet-id="...">`	token → spreadsheet_token	§ 7 Sheets
`<bitable token="..." table-id="...">`	token → app_token	§ 6 Base
`<cite type="doc" file-type="sheets" ...>`	同 `<sheet>`	§ 7 Sheets
`<cite type="doc" file-type="bitable" ...>`	同 `<bitable>`	§ 6 Base
`<synced_reference src-token="..." src-block-id="...">`	用 `docs +fetch` 读取 src-token	§ 4 Doc

下游路由

拿到 spreadsheet URL/token → 切 § 7 Sheets
拿到 bitable URL/token → 切 § 6 Base
搜索云空间文档 → 优先用 drive +search（§ 5 Drive）

Shortcuts

Shortcut	说明
`+fetch`	读取文档（支持 simple/with-ids/full，5种局部读取模式）
`+create`	创建文档（DocxXML 或 Markdown）
`+update`	更新文档（8种指令：str_replace/block_insert_after/overwrite/append 等）
`+media-download`	下载文档中的图片/文件
`+media-insert`	向文档插入图片/文件
`+search`	搜索云空间文档（已进入维护期，新场景改用 `drive +search`）

§ 5. 云空间（Drive）

快速决策

搜文档/Wiki/电子表格/多维表格/云空间对象 → drive +search（扁平 flag，无需手写 JSON）
导入本地 .xlsx/.csv/.base 为 Base → drive +import --type bitable
导入本地 .md/.docx/.html 为在线文档 → drive +import --type docx
导入本地 .xlsx/.csv 为电子表格 → drive +import --type sheet
新建文件夹 → drive +create-folder
上传到知识库节点下 → drive +upload --wiki-token <wiki_token>
修改文件标题（docx/sheet/bitable/file/folder/wiki）→ drive files patch --data '{"new_title":"..."}'

Wiki 链接特殊处理

/wiki/<token> 背后可能是不同类型文档，不能直接用作 file_token：

# 先查实际类型和真实 token
lark-cli wiki spaces get_node --params '{"token":"<wiki_token>"}'
# 返回 node.obj_type（docx/sheet/bitable/slides 等）和 node.obj_token（真实 token）

Shortcuts

Shortcut	说明
`+search`	搜索云空间对象（支持 --mine/--edited-since/--doc-types 等扁平 flag）
`+upload`	上传文件到云空间
`+download`	下载文件
`+import`	导入本地文件为在线文档（docx/sheet/bitable）
`+export`	导出在线文档为本地格式
`+create-folder`	创建文件夹
`+move`	移动文件
`+delete`	删除文件
`+add-comment`	添加评论（支持 sheet cell 评论）
`+apply-permission`	管理文档权限

§ 6. 多维表格（Base）

触发条件

操作飞书多维表格 / Base
建表/改表/查表/字段管理/记录读写/视图配置
公式字段、lookup 字段、派生指标、跨表计算
临时统计、聚合分析、比较排序
Workflow/dashboard/表单/角色权限管理
用户给出 /base/{token} 或解析为 bitable 的 /wiki/{token} 链接

模块地图

大模块	包含能力	Reference 入口
Base 模块	base-create/get/copy，链接解析	`references/base/lark-base-workspace.md`
表与数据模块	table/field/record/view	`references/base/lark-base-table.md` + `lark-base-field.md` + `lark-base-record.md` + `lark-base-view.md`
公式/Lookup	派生字段、条件判断、跨表计算	`references/base/formula-field-guide.md` + `lookup-field-guide.md`
数据分析	一次性筛选/分组/聚合	`references/base/lark-base-data-query.md`
Workflow	自动化流程	`references/base/lark-base-workflow.md`
Dashboard	仪表盘和图表组件	`references/base/lark-base-dashboard.md`
表单	表单和表单题目	`references/base/lark-base-form.md`
权限与角色	高级权限、自定义角色	`references/base/lark-base-role-list.md`

所有 base 命令格式：lark-cli base +<verb>
执行前必须先读对应 reference，禁止直接调用。

lark-cli schema base.<resource>.<method>   # 查参数结构
lark-cli base <resource> <method> [flags] # 调用 API

§ 7. 电子表格（Sheets）

CRITICAL — 操作前必读 § 0 共享基础 CRITICAL — 执行 sheets 命令前必须先读对应 reference 文档。

操作前先用 lark-cli schema sheets.<resource>.<method> 查参数结构。

所有 sheets reference 文档在 references/sheets/，按功能分类：

基本操作：create/get/update/append/find — 查 lark-cli sheets --help
导出：+export-csv、+export-xlsx
数据类型：references/sheets/ 下各 .md 文件

lark-cli schema sheets.<resource>.<method>
lark-cli sheets <resource> <method> [flags]

§ 8. 演示文稿（Slides）

CRITICAL — 操作前必读 § 0 共享基础

Shortcuts

Shortcut	说明
`+create`	创建演示文稿
`+media-upload`	上传本地图片供 Slides XML 使用
`+replace-slide`	块级 XML 编辑（block_replace/block_insert）
`xml_presentations get`	读取演示文稿 XML 内容
`xml_presentation.slide create`	添加幻灯片页
`xml_presentation.slide delete`	删除幻灯片页
`xml_presentation.slide get`	读取单页幻灯片 XML
`xml_presentation.slide replace`	替换单页幻灯片 XML

所有 slides reference 文档在 references/slides/。
使用 +replace-slide 前必须读 references/slides/lark-slides-replace-slide.md。

lark-cli schema slides.<resource>.<method>
lark-cli slides <resource> <method> [flags]

§ 9. 任务（Task）

CRITICAL — 操作前必读 § 0 共享基础

搜索 vs 列取决策：

有明确查询关键字 → +search
无关键字，只有范围条件（"我关注的/由我创建/分配给我"）→ 优先 +get-related-tasks 或 +get-my-tasks
不要把时间范围词（"今年以来"）误当 query 参数
用户提到"todo"（待办）→ 优先理解为 task

创建/更新注意：

设置 repeat_rule 或 reminder 之前必须先设置 due
同时设置 start 和 due 时，开始时间 ≤ 截止时间
bot 身份无法跨租户添加任务成员

Task GUID：API 中的 guid 是全局唯一标识，不是客户端展示的任务编号（t104121）。从 applink 取 guid 参数。

输出要求：同时输出任务的 url 字段，便于用户点击跳转。

Shortcuts

lark-cli task +<verb> [flags]

Shortcut	说明
`+create`	创建任务
`+update`	更新任务
`+complete`	完成任务
`+reopen`	重新打开任务
`+assign`	分配/移除任务成员
`+comment`	添加评论
`+get-my-tasks`	列出分配给我的任务
`+get-related-tasks`	列出与我相关的任务
`+search`	搜索任务（有关键字时用）
`+tasklist-create`	创建清单并批量添加任务
`+tasklist-search`	搜索清单
`+tasklist-task-add`	将任务加入清单
`+tasklist-members`	管理清单成员
`+set-ancestor`	设置/清除父任务

权限表（部分）

方法	scope
tasks CRUD	`task:task:write` / `task:task:read`
tasklists CRUD	`task:tasklist:write` / `task:tasklist:read`
subtasks CRUD	`task:task:write` / `task:task:read`
custom_fields	`task:custom_field:write` / `task:custom_field:read`

§ 10. 邮件（Mail）

CRITICAL — 操作前必读 § 0 共享基础

所有 mail reference 文档在 references/mail/，执行对应操作前先读相应文档。

lark-cli schema mail.<resource>.<method>
lark-cli mail <resource> <method> [flags]

功能类别	相关 Reference
邮件列表/搜索/读取	`references/mail/` 下对应文档
发送/回复/转发	同上
草稿管理	同上
监听新邮件	同上
邮件分享到 IM	`references/mail/lark-mail-share-to-chat.md`

§ 11. 知识库（Wiki）

CRITICAL — 操作前必读 § 0 共享基础

成员管理限制：

--as bot + 部门 → 不支持，直接说明路径不可行，不要试错
bot 路径无法完成时不要静默切换到 user；若用户明确要求 bot，必须说明无法完成

快速决策：

用户给 wiki URL（.../wiki/<token>），后续要查/加/删成员 → 先 wiki spaces get_node 获取 space_id
删除知识空间只有名称/URL → 必须先解析出真实 space_id，展示候选让用户确认后再执行
命中 0 条 → 停下询问，不要改名重试
"我的文档库/My Document Library/个人知识库" → Wiki personal library，不是 Drive 根目录

成员添加流程：先把"人/群/部门"解析成正确 member_id 再调用：

用户 → contact +search-user 获取 open_id（member_type=openid）
群 → im +chat-search 获取 chat_id（member_type=openchat）
部门（user 身份）→ 搜索 open_department_id（member_type=opendepartmentid）

Shortcuts

Shortcut	说明
`+move`	移动 wiki 节点，或将 Drive 文档移入 Wiki
`+node-create`	创建 wiki 节点（自动解析 space）
`+delete-space`	删除知识空间（高风险，需显式 `--yes`）

API Resources

spaces: create/get/get_node/list members: create/delete/list nodes: copy/create/list

权限表

方法	scope
spaces.create	`wiki:space:write_only`
spaces.get/list	`wiki:space:read` / `wiki:space:retrieve`
spaces.get_node	`wiki:node:read`
members.create	`wiki:member:create`
members.delete	`wiki:member:update`
members.list	`wiki:member:retrieve`
nodes.copy	`wiki:node:copy`
nodes.create	`wiki:node:create`
nodes.list	`wiki:node:retrieve`

§ 12. 通讯录（Contact）

CRITICAL — 操作前必读 § 0 共享基础

Shortcuts

Shortcut	说明
`+search-user`	按姓名/邮箱/手机号搜索用户（按相关性排序）
`+get-user`	获取用户信息（省略 user_id 则查自己）

§ 13. 视频会议（VC）

CRITICAL — 操作前必读 § 0 共享基础

路由规则：

查询已结束的会议（历史日期/昨天/上周/今天已开的会）→ 使用本域
查询未来的会议日程/日历 → 使用 § 3 Calendar

核心概念

Meeting：视频会议实例，meeting_id 标识
Note：会议纪要，含 AI 总结、待办、章节（note_doc_token）
VerbatimDoc：逐字稿，含说话人和时间戳（verbatim_doc_token）
MeetingNotes：用户绑定的纪要文档（meeting_notes，仅 --calendar-event-ids 路径返回）
Minutes：来自录制产物的妙记，minute_token 标识 → 详见 § 17 Minutes

核心场景

搜索会议记录：仅支持已结束会议，支持关键词/时间段/参与人/组织者/会议室筛选，注意分页。

整理会议纪要：

默认给纪要文档和逐字稿链接即可，无需读取内容
用户明确要总结/待办/章节时才读文档
读 note_doc_token 时，第一个 <whiteboard> 标签是封面图，应一并下载展示

# 读纪要内容
lark-cli docs +fetch --api-version v2 --doc <note_doc_token> --doc-format markdown
# 下载封面图
lark-cli docs +media-download --type whiteboard --token <whiteboard_token> --output ./minutes/<minute_token>/cover

产物目录规范：同一会议所有下载产物统一放 ./minutes/{minute_token}/

用户意图区分：

"纪要/总结/纪要内容" → 同时返回 note_doc_token + meeting_notes（如有）
"逐字稿/完整记录/谁说了什么" → verbatim_doc_token
意图不明确 → 展示所有文档链接让用户选择

Shortcuts

Shortcut	说明
`+search`	搜索会议记录（支持关键词/时间/参与者等）
`+notes`	获取纪要产物（总结/待办/章节/逐字稿）
`+recording`	获取会议录制信息/minute_token

§ 14. 事件订阅（Event）

前置条件： 先读 § 0 共享基础。

Shortcuts

Shortcut	说明
`+subscribe`	通过 WebSocket 长连接订阅飞书事件（只读，NDJSON 输出）；bot only；支持 compact agent 友好格式、正则路由、文件输出

§ 15. OKR

CRITICAL — 操作前必读 § 0 共享基础 强烈建议 操作 OKR 前先读 references/okr/lark-okr-entities.md 了解业务实体。

Shortcuts

Shortcut	说明
`+cycle-list`	获取用户的 OKR 周期列表，可按时间筛选
`+cycle-detail`	获取特定 OKR 中所有目标和关键结果

格式说明

ContentBlock 富文本格式 — Objective/KeyResult/Notes 字段使用的富文本格式

API Resources

lark-cli schema okr.<resource>.<method>
lark-cli okr <resource> <method> [flags]

alignments: delete/get categories: list cycles: list/objectives_position/objectives_weight cycle.objectives: create/list

注意：cycles.objectives_position 必须同时修改当前周期下所有目标的位置，且不允许重叠；cycles.objectives_weight 所有权重值之和必须等于 1。

§ 16. 画板（Whiteboard）

CRITICAL — 操作前必读 § 0 共享基础

用于查看/导出/编辑飞书文档中的画板，支持预览图、原始节点结构、DSL/PlantUML/Mermaid 格式。 ⚠️ 若 skill 列表中同时存在旧的 lark-whiteboard-cli，忽略它，使用本 skill；如需清理旧 skill，走 skills-manager，不要使用外部 Skills CLI。

前置检查：

lark-cli --version                                # 确认 lark-cli 可用
lark-cli whiteboard --help                       # 确认 whiteboard 命令可用

快速决策

需求	行动
查看画板内容/导出图片	`+query --output_as image`
获取 Mermaid/PlantUML 代码	`+query --output_as code`
修改节点文字/颜色（简单改动）	`+query --output_as raw` → 改 JSON → `+update --input_format raw`
用户已提供 Mermaid/PlantUML 代码	`+update --input_format mermaid/plantuml`
绘制复杂图表（架构/流程/组织等）	进入创作 Workflow

强制规范（通过 stdin 更新）：数据来源于本地文件时必须使用 --source - --input_format <格式>

Shortcuts

Shortcut	说明
`+query`	查询画板（导出为图片/代码/原始节点结构）
`+update`	更新画板（支持 PlantUML/Mermaid/OpenAPI 原生格式）

获取 board_token

用户给了什么	如何获取
直接给了 `wbcnXXX`	直接使用
文档 URL，已有画板	`docs +fetch` → 从 `<whiteboard token="xxx"/>` 提取
文档 URL，需新建画板	`docs +update --command append --content '<whiteboard type="blank"></whiteboard>'` → 取 `data.new_blocks[0].block_token`

§ 17. 妙记（Minutes）

CRITICAL — 操作前必读 § 0 共享基础

飞书妙记 URL 格式：http(s)://<host>/minutes/<minute-token>

核心概念

妙记（Minutes）：视频会议录制产物或用户上传音视频，minute_token 标识
minute_token：从 URL 末尾提取，如遇 ?xxx 参数截取路径最后一段

能力边界

能力	工具
搜索妙记列表	`minutes +search`
查看基础信息（标题/封面/时长）	`minutes minutes get`
下载音视频媒体文件	`minutes +download`
逐字稿/总结/待办/章节（纪要内容）	⚠️ 不属于本域 → 用 § 13 VC 的 `vc +notes --minute-tokens`

路由规则

"我的妙记/某关键词/某段时间内的妙记" → minutes +search
同时提到"会议/开会/某场会" → 优先走 § 13 VC 先定位会议，再通过 vc +recording 获取 minute_token
"这个妙记的逐字稿/总结/待办/章节" → vc +notes --minute-tokens

Shortcuts

Shortcut	说明
`+search`	按关键词/所有者/参与者/时间范围搜索妙记
`+download`	下载妙记音视频文件（`--url-only` 只返回下载链接）

未显式指定路径时，文件默认落到 ./minutes/{minute_token}/<server-filename>

§ 18. 考勤（Attendance）

CRITICAL — 操作前必读 § 0 共享基础

默认参数（必须自动填充，禁止询问用户）

参数	固定值
`employee_type`	`"employee_no"`
`user_ids`（`--data` 中）	`[]`（空数组）

lark-cli schema attendance.user_tasks.query   # 查参数结构
lark-cli attendance user_tasks query --data '{"user_ids":[],"...":"..."}'

权限表

方法	scope
`user_tasks.query`	`attendance:task:readonly`

§ 19. 审批（Approval）

CRITICAL — 操作前必读 § 0 共享基础

lark-cli schema approval.<resource>.<method>
lark-cli approval <resource> <method> [flags]

API Resources

instances: get/cancel/cc/initiated tasks: remind/approve/reject/transfer/query

权限表

方法	scope
instances.get/initiated	`approval:instance:read`
instances.cancel/cc	`approval:instance:write`
tasks.remind/approve/reject/transfer	`approval:task:write` / `approval:instance:write`
tasks.query	`approval:task:read`

§ 20. OpenAPI Explorer

前置条件： 先读 § 0 共享基础。

当现有 skill 或 CLI 已注册命令无法覆盖用户需求时，用本域从飞书官方文档库挖掘原生 API。

文档库

llms.txt                    ← 顶层索引（所有模块文档链接）
  └─ llms-<module>.txt      ← 模块文档（功能概述 + API 文档链接）
       └─ <api-doc>.md      ← 单个 API（方法/路径/参数/响应/错误码）

品牌	入口
飞书	`https://open.feishu.cn/llms.txt`
Lark	`https://open.larksuite.com/llms.txt`

挖掘流程

Step 1：确认现有能力不足

lark-cli <service> --help   # 检查是否已有对应命令

如果已有对应命令或 shortcut → 直接使用，不继续挖掘。

Step 2：顶层索引定位模块 用 WebFetch 获取 llms.txt，找到相关模块文档链接。

Step 3：模块文档找 API 用 WebFetch 获取模块文档，找到相关 API 文档链接。

Step 4：读取 API 文档 获取完整的方法、路径、参数、权限信息。

Step 5：调用 API

lark-cli api GET /open-apis/<path> --params '{"key":"value"}'
lark-cli api POST /open-apis/<path> --data '{"key":"value"}'

§ 21. 自定义 Skill 创建

CLI 核心能力

lark-cli <service> <resource> <method>          # 已注册 API
lark-cli <service> +<verb>                      # Shortcut
lark-cli api <METHOD> <path> [--data/--params]  # 任意 OpenAPI
lark-cli schema <service.resource.method>       # 查参数定义

优先级：Shortcut > 已注册 API > api 裸调。

调研 API

lark-cli <service> --help                                           # 查已有资源和 Shortcut
lark-cli schema <service.resource.method>                           # 查参数
lark-cli api GET /open-apis/vc/v1/rooms --params '{"page_size":"50"}'  # 未注册 API 直接调用

未注册 API → 先用 § 20 OpenAPI Explorer 从官方文档挖掘。

SKILL.md 模板

---
name: lark-<name>
version: 1.0.0
description: "..."
metadata:
  requires:
    bins: ["lark-cli"]
  cliHelp: "lark-cli <service> --help"
---

# <name>

**CRITICAL — 开始前 MUST 先用 Read 工具读取 [§ 0 共享基础](../lark/SKILL.md#-0-共享基础所有域通用)**

## Shortcuts
...

§ 22. 工作流：会议纪要汇总

仅支持 user 身份。

lark-cli auth login --domain vc         # 基础（查询+纪要）
lark-cli auth login --domain vc,drive   # 含读取纪要文档正文/生成文档

工作流

{时间范围} ─► vc +search ──► 会议列表 (meeting_ids)
                   │
                   ▼
               vc +notes ──► 纪要文档 tokens
                   │
                   ▼
               drive metas batch_query 纪要元数据
                   │
                   ▼
               结构化报告

步骤

Step 1：确定时间范围（默认过去 7 天）

日期转换必须调用系统命令（如 date），不要心算。

"今天"→当天，"这周"→本周一～now，"上周"→上周一～上周日，"这个月"→1日～now

Step 2：查询会议记录

lark-cli vc +search --start "<YYYY-MM-DD>" --end "<YYYY-MM-DD>" --format json --page-size 30

--end 包含当天（查"今天"时 start 和 end 都填今天）
搜索范围最大 1 个月，更长时拆分多次查询
有 page_token 时继续翻页，收集所有 id（meeting_id）

Step 3：获取纪要文档

lark-cli vc +notes --meeting-ids "<meeting_id1>,<meeting_id2>"

Step 4：获取纪要元数据

lark-cli schema drive.metas.batch_query
lark-cli drive metas batch_query ...  # 最多 10 个文档

Step 5：汇总输出 按时间排序，输出会议标题、时间、参与人、纪要链接，合并同一天的会议。

§ 23. 工作流：日程待办摘要

仅支持 user 身份。

lark-cli auth login --domain calendar,task

工作流

{date} ─┬─► calendar +agenda ──► 日程列表
        └─► task +get-my-tasks ──► 未完成待办列表
                    │
                    ▼
              AI 汇总（冲突检测 + 排序）──► 摘要

步骤

Step 1：获取日程

# 今天（默认）
lark-cli calendar +agenda

# 指定日期（必须 ISO 8601，不支持 "tomorrow" 等自然语言）
lark-cli calendar +agenda --start "2026-03-26T00:00:00+08:00" --end "2026-03-26T23:59:59+08:00"

--start/--end 只支持 ISO 8601 或 Unix timestamp，不支持 "tomorrow"，需 AI 根据当前日期自行计算。

Step 2：获取未完成待办

lark-cli task +get-my-tasks              # 默认最多 20 条
lark-cli task +get-my-tasks --due-end "2026-03-26T23:59:59+08:00"  # 截止时间过滤

Step 3：AI 汇总

时间戳转本地时区可读时间
冲突检测：同一时间段有多个日程时标注
按时间排序
格式：先日程（含地点/参会人），再待办（含截止时间/优先级）

lark-cli okr

lark

Datos de origen

Opciones de instalación

Revisa los archivos de origen

Más de este repositorio

Más de este repositorio

lark-cli 全功能指南

§ 0. 共享基础（所有域通用）

配置初始化

身份类型

权限不足处理

更新检查

安全规则

§ 1. 域路由总表

§ 2. 消息（IM）

核心概念

身份注意

Shortcuts（推荐优先使用）

API Resources

权限表

§ 3. 日历（Calendar）

核心概念

核心场景

预约日程/会议、查询/搜索可用会议室

Shortcuts

API Resources

权限表

§ 4. 云文档（Doc）

嵌入对象路由

下游路由

Shortcuts

§ 5. 云空间（Drive）

快速决策

Wiki 链接特殊处理

Shortcuts

§ 6. 多维表格（Base）

触发条件

模块地图

§ 7. 电子表格（Sheets）

§ 8. 演示文稿（Slides）

Shortcuts

§ 9. 任务（Task）

Shortcuts

权限表（部分）

§ 10. 邮件（Mail）

§ 11. 知识库（Wiki）

Shortcuts

API Resources

权限表

§ 12. 通讯录（Contact）

Shortcuts

§ 13. 视频会议（VC）

核心概念

核心场景

Shortcuts

§ 14. 事件订阅（Event）

Shortcuts

§ 15. OKR

Shortcuts

格式说明

API Resources

§ 16. 画板（Whiteboard）

快速决策

Shortcuts

获取 board_token

§ 17. 妙记（Minutes）

核心概念

能力边界

路由规则

Shortcuts

§ 18. 考勤（Attendance）

默认参数（必须自动填充，禁止询问用户）

权限表

§ 19. 审批（Approval）

API Resources

权限表

§ 20. OpenAPI Explorer

文档库

挖掘流程

§ 21. 自定义 Skill 创建