# Lark

> Lark/Feishu CLI router: query and operate Lark/Feishu via lark-cli. Use `lark-cli skills read subskill` (e.g. lark-doc, lark-base, lark-im) to load domain skills for docs, sheets, base, calendar, im, mail, tasks, okr, drive, wiki, slides, whiteboard, apps/miaoda, approval, attendance, contact, vc, minutes, note, events, etc.

- Skill: `fradser/lark-2` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add fradser/lark-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fradser/lark-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: FradSer (https://skillmd.com/u/fradser)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/fradser/lark-2

---


# Lark CLI Skills

**CRITICAL** -- Before any lark-cli operation, MUST first run `lark-cli skills read lark-shared` for authentication, identity (`--as user` vs `--as bot`), permissions, and security rules. If unauthenticated, run `lark-cli auth login`.

This skill is a **router only**. Do not invent CLI commands from memory. Sub-skills and reference guides are embedded in the `lark-cli` binary. Match user intent to one row in the index below, then execute `lark-cli skills read <sub-skill>` via bash.

## How to Route & Execute

1. **Auth & Identity**: Run `lark-cli skills read lark-shared` once per session for auth state, `--as` identity rules, and domain permissions.
2. **Select Sub-skill**: Match user intent to the domain in the **Sub-skill Index** table below.
3. **Load Sub-skill**: Execute the corresponding read command:
   ```bash
   lark-cli skills read <sub-skill>
   ```
(e.g., `lark-cli skills read lark-doc`, `lark-cli skills read lark-base`)
4. **Follow References**: When a loaded skill refers to sub-documents or other skills:
   - Intra-skill reference: `lark-cli skills read <sub-skill>/<path>` (e.g., `lark-cli skills read lark-doc/references/lark-doc-fetch.md` or `lark-cli skills read lark-doc references/lark-doc-fetch.md`)
   - Cross-skill reference: `lark-cli skills read <other-skill>/<path>` (e.g., `lark-cli skills read lark-shared/references/lark-wiki-token-routing.md` or `lark-cli skills read lark-shared`)
5. **Inspect Commands & Schemas**:
   - Prefer shortcuts: `lark-cli <domain> +<shortcut> --help`
   - Method schema: `lark-cli schema <service>.<resource>.<method>`
   - Dynamic discovery: `lark-cli skills list` / `lark-cli skills list <sub-skill>`

## Sub-skill Index

| Sub-skill | Read Command | Version | Use When |
|-----------|--------------|---------|----------|
| lark-shared | `lark-cli skills read lark-shared` | 1.0.0 | Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling _notice JSON. |
| lark-approval | `lark-cli skills read lark-approval` | 1.2.0 | 飞书审批：查询和处理审批待办/已办/实例，搜索可发起审批定义、查看定义详情并发起原生审批实例。当用户要处理审批任务、查看审批实例、搜索或发起审批时使用。审批待办不是飞书任务；非审批类待办走 lark-task。不负责创建审批定义；三方审批定义不走原生提单。 |
| lark-apps | `lark-cli skills read lark-apps` | 1.0.0 | 妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用协作者与协作权限设置、应用角色与成员管理、自动化触发器（定时/记录变更/Webhook/飞书审批）。当用户要开发/新建一个系统·工具·平台·应用，或要本地开发 / 云端开发 / 修改 / 部署 / 发布 / 上线 / 拿可分享链接，或用 HTML 做页面·网站·部署到妙搭，或要设计 / design / mockup / prototype / wireframe / 做 PPT / deck / 视觉探索，或提到妙搭/Spark/Miaoda（应用运行时域名形如 *.aiforce.cloud）、应用数据库、应用文件存储、开放 API Key、可见范围、应用协作者/开发权限、应用角色/角色成员、线上日志、接口请求量、错误量、延迟、访问量、环境变量、给妙搭应用配自动化任务/定时触发/审批通过后自动触发时使用。不负责普通云盘文件上传（lark-drive）、飞书文档编辑（lark-doc）、原生幻灯片创建（lark-slides）。 |
| lark-attendance | `lark-cli skills read lark-attendance` | 1.0.0 | 飞书考勤打卡：查询自己的考勤打卡记录 |
| lark-base | `lark-cli skills read lark-base` | 1.2.6 | 飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式（BaseApp/AppMode 页面与组件）、Workspace 目录、workflow、角色权限；遇到 Base/多维表格/bitable、BaseApp/AppMode，或应用模式的 /app/ 链接（可能同时包含 /base/workspace/<workspace_token>）时使用。BaseApp 不走 lark-apps；文件导入/导出转 lark-drive，认证/授权转 lark-shared。 |
| lark-calendar | `lark-cli skills read lark-calendar` | 1.0.0 | 飞书日历：管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责：查询过去的视频会议记录（走 lark-vc）、待办任务（走 lark-task）。 |
| lark-contact | `lark-cli skills read lark-contact` | 1.0.0 | 飞书 / Lark 通讯录:按姓名 / 邮箱解析成 open_id,或按 open_id 反查姓名 / 部门 / 邮箱 / 联系方式 / 个人状态 / 签名,以及按关键词搜索当前用户可见的机器人 / 智能体(agent)。当用户提到一个名字要下一步发消息 / 排日程,或拿到 open_id 想查具体信息时使用。不负责部门树遍历、按部门列员工、组织架构图,这类需求走原生 OpenAPI。 |
| lark-doc | `lark-cli skills read lark-doc` |  | 飞书云文档（Docx / Wiki）内容操作：读取、创建、编辑文档，插入或下载图片附件，以及操作思维笔记。用户提供文档 URL/token（包括 doubao.com 的 /docx/、/wiki/）时使用；按 URL 路径/token 而非域名路由。文档内嵌资源按读取参考中的统一规则分流。文档评论走 lark-drive；表格或 Base 内部数据操作不在本 skill。 |
| lark-drive | `lark-cli skills read lark-drive` | 1.0.0 | 飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用；doubao.com 云空间 URL/token 也按资源路径和 token 路由，不回退 WebFetch。不负责：文档内容编辑（走 lark-doc）、表格/Base 表内数据操作（走 lark-sheets/lark-base）、知识空间节点/成员管理（走 lark-wiki）、原生 Markdown 文件读写/patch/diff（走 lark-markdown）。 |
| lark-event | `lark-cli skills read lark-event` | 1.0.0 | Lark/Feishu real-time event listening / subscribing / consuming: stream events as NDJSON via `lark-cli event consume <EventKey>` (covers IM messages/reactions/chat changes, Approval status changes, Task updates, VC meeting started/joined/ended, Minutes generated, Whiteboard updated, etc.). Use for Lark bots, real-time message processing, long-running subscribers, streaming webhook/push handlers. Supports `--max-events` / `--timeout` bounded runs and a stderr ready-marker contract — designed for AI agents running as subprocesses. |
| lark-im | `lark-cli skills read lark-im` | 1.0.0 | 飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive Card）、监听卡片按钮回调（card.action.trigger）。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶（添加/移除/查询置顶会话）、管理标签数据、处理卡片回调时使用。 |
| lark-mail | `lark-cli skills read lark-mail` | 1.0.0 | 飞书邮箱：Use when user mentions 起草邮件、写邮件、草稿、发送/回复/转发邮件、查阅邮件、看邮件、搜索邮件、邮件文件夹、邮件标签、邮件联系人、监听新邮件、邮件收信规则等；use for mail/email intent only. Do not use for docs/sheets/calendar/auth setup/pure contact lookup/IM chat tasks. |
| lark-markdown | `lark-cli skills read lark-markdown` | 1.2.2 | 飞书 Markdown：查看、创建、上传、编辑和比较 Markdown 文件。当用户需要创建或编辑 Markdown 文件、读取、修改、局部 patch 或比较差异时使用。不负责将 Markdown 导入为飞书在线文档，也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。 |
| lark-minutes | `lark-cli skills read lark-minutes` | 1.0.0 | 飞书妙记：搜索妙记、查看妙记基础信息、下载/上传音视频、读取或编辑妙记的产物内容、改标题、替换说话人/关键词、申请妙记查看/编辑权限。当给出minute_token、本地音视频文件，要查/改/转妙记产物，或用户明确要主动申请妙记权限时使用；本地音视频转纪要/逐字稿优先走本 skill，不要用 ffmpeg/whisper 本地转写。不负责：获取会议关联妙记，或仅按自然语言标题定位纪要 |
| lark-note | `lark-cli skills read lark-note` | 1.0.0 | 飞书会议纪要（Note）直查：已知 note_id 时查询纪要详情、展示类型、关联文档 token，并读取 unified 原始逐字记录。当用户已持有 note_id，或从文档显式 vc-node-id 获得 note_id 时使用。不负责会议/日程/妙记定位、文档标题搜索或 Docx 正文读取。 |
| lark-okr | `lark-cli skills read lark-okr` | 1.0.0 | 飞书 OKR：管理目标与关键结果。查看和编辑 OKR 周期、目标、关键结果、对齐关系、量化指标和进展记录。当用户需要查看或创建 OKR、管理目标和关键结果、查看对齐关系时使用。不负责：待办任务管理（lark-task）、日程/会议安排（lark-calendar）、绩效评估 |
| lark-openapi-explorer | `lark-cli skills read lark-openapi-explorer` | 1.0.0 | 飞书/Lark 原生 OpenAPI 探索：从官方文档库中挖掘未经 CLI 封装的原生 OpenAPI 接口。当用户的需求无法被现有 lark-* skill 或 lark-cli 已注册命令满足，需要查找并调用原生飞书 OpenAPI 时使用。 |
| lark-sheets | `lark-cli skills read lark-sheets` | 3.1.2 | 飞书电子表格：创建和操作电子表格。支持创建表格、管理工作表与行列结构（增删/合并/调整尺寸/隐藏/冻结）、读写单元格（值/公式/样式/批注/单元格图片）、查找替换、多操作批量更新，以及图表、透视表、条件格式、筛选器、迷你图、浮动图片等对象的创建与维护。当用户需要创建电子表格、管理工作表、批量读写或编辑数据、统计汇总与可视化、表格美化、公式计算（含 Excel 公式迁移）、金融/财务建模（DCF、三张表、预算、Sensitivity 等）等任务时使用。若用户是想按名称或关键词搜索云空间（云盘/云存储）里的表格文件，请改用 lark-drive 的 drive +search 先定位资源。当用户给出 doubao.com 的 /sheets/ URL/token 时，也应直接使用本 skill，不要因为域名不是飞书而回退到 WebFetch；路由依据是 URL 路径模式和 token，而不是域名。 |
| lark-skill-maker | `lark-cli skills read lark-skill-maker` | 1.0.0 | 创建 lark-cli 的自定义 Skill。当用户需要把飞书 API 操作封装成可复用的 Skill（包装原子 API 或编排多步流程）时使用。 |
| lark-slides | `lark-cli skills read lark-slides` | 1.0.0 | 飞书幻灯片：创建和编辑幻灯片。创建演示文稿、读取幻灯片内容、管理幻灯片页面（创建、删除、读取、局部替换）。当用户需要创建或编辑幻灯片、读取或修改单个页面时使用。当用户给出 doubao.com 的 /slides/ URL/token 时，也应直接使用本 skill，不要因为域名不是飞书而回退到 WebFetch；路由依据是 URL 路径模式和 token，而不是域名。不负责：云文档内容编辑（走 lark-doc）、云文档里的独立画板对象（走 lark-whiteboard）、上传或下载普通文件（走 lark-drive）。 |
| lark-task | `lark-cli skills read lark-task` | 1.0.0 | 飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册注销任务智能体、更新智能体主页数据、写入任务记录时使用。 |
| lark-vc | `lark-cli skills read lark-vc` | 1.0.0 | 飞书视频会议：查询进行中的会议列表（含会议 ID）、读取会中实时内容（发言、聊天、共享等）、发送会中消息，以及搜索历史会议、查询会议纪要（总结/待办/章节/逐字稿）和参会人快照。Agent 真实入会/离会走 lark-vc-agent；查询未来日程走 lark-calendar。 |
| lark-vc-agent | `lark-cli skills read lark-vc-agent` | 1.0.0 | 飞书视频会议会中能力：用于让应用机器人真实加入或离开正在进行的会议，并读取当前身份可见的会中事件、发送会中文本消息或会中表情。适用于用户询问正在开的会议发生了什么、谁在发言、是否共享内容，或需要发现当前可读的进行中会议 ID。不负责已结束会议搜索、参会人快照、纪要、逐字稿或录制查询，这些使用 lark-vc 技能。 |
| lark-whiteboard | `lark-cli skills read lark-whiteboard` | 1.0.0 | 飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。 当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责：飞书云文档内容编辑（lark-doc）、文档内嵌电子表格/Base（lark-sheets / lark-base）。 |
| lark-wiki | `lark-cli skills read lark-wiki` | 1.0.3 | 飞书知识库：管理知识空间、空间成员和文档节点。创建和查询知识空间、查看和管理空间成员、管理节点层级结构、在知识库中组织文档和快捷方式。当用户需要在知识库中查找或创建文档、浏览知识空间结构、查看或管理空间成员、移动或复制节点时使用。当用户给出 doubao.com 的 /wiki/ URL/token 时，也应直接使用本 skill，不要因为域名不是飞书而回退到 WebFetch；路由依据是 URL 路径模式和 token，而不是域名。不负责：上传文件到知识库节点下（走 lark-drive）、编辑文档/表格/Base 内容（走 lark-doc / lark-sheets / lark-base）。 |
| lark-workflow-meeting-summary | `lark-cli skills read lark-workflow-meeting-summary` | 1.0.0 | 会议纪要整理工作流：汇总指定时间范围内的会议纪要并生成结构化报告。当用户需要整理会议纪要、生成会议周报、回顾一段时间内的会议内容时使用。 |
| lark-workflow-standup-report | `lark-cli skills read lark-workflow-standup-report` | 1.0.0 | 日程待办摘要：编排 calendar +agenda 和 task +get-my-tasks，生成指定日期的日程与未完成任务摘要。适用于了解今天/明天/本周的安排。 |

## Routing Rules

1. **Always** run `lark-cli skills read lark-shared` first for authentication and permission rules.
2. Match intent to the **Use When** column; run that row's **Read Command** (e.g. `lark-cli skills read lark-doc`).
3. Follow the returned guidance and read needed reference documents via `lark-cli skills read <sub-skill>/<path>`.
4. Multi-domain tasks: execute `lark-cli skills read` for each relevant sub-skill in task order (auth shared once).
5. Document-embedded whiteboards or spreadsheets: read `lark-doc` first, then load `lark-whiteboard` or `lark-sheets` as instructed.