--- description: | Lark/Feishu CLI skills for Stella sessions. Covers workspace operations — calendar, docs, tasks, mail, and messenger — via the lark-cli tool. In Stella, lark-cli runs under an env-var auth model with binaries resolved from $STELLA_HOME/bin: LARKSUITE_CLI_USER_ACCESS_TOKEN, LARKSUITE_CLI_APP_ID, and LARKSUITE_CLI_BRAND are injected at session start; no manual config init or auth login is needed. Always read lark-shared first for identity selection (--as user vs --as bot), scope / permission-denied handling, token refresh, and the Stella-specific rules that override upstream documentation. metadata: generated: true owner_plugin: tool/lark-cli source_ref: 2e4cfb49219d source_repo: larksuite/cli name: lark-cli tags: - lark - feishu - workspace --- # Lark This skill aggregates Lark/Feishu CLI modules synced from `larksuite/cli` and adapted for Stella sessions. **Stella auth model** — `lark-cli` runs directly from Stella-managed `$STELLA_HOME/bin` with `LARKSUITE_CLI_USER_ACCESS_TOKEN`, `LARKSUITE_CLI_APP_ID`, and `LARKSUITE_CLI_BRAND` injected at startup. Do not run `lark-cli config init` or `lark-cli auth login` unless the user explicitly wants a standalone local setup outside Stella. **Identity** — default to `--as user` for personal resources (calendar, docs, tasks, mail). `--as bot` requires manual app configuration outside Stella and cannot see user-private resources. **Token expiry** — user access tokens expire after ~2 hours. Stella proactively refreshes them within 10 minutes of expiry. If a token expires mid-session, use the `oauth` tool (oauth status, then oauth connect with provider=lark) or go to Credentials → OAuth CLI Credentials to reconnect; Stella restarts the sandbox automatically on the next message. ## Modules | Module | Description | Reference | | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | lark-shared | 飞书/Lark CLI 共享基础（Stella 适配版）：说明 Stella 会话中的 `$STELLA_HOME/bin` + 环境变量认证模型、`--as user` / `--as bot` 选择、scope / Permission denied 处理，以及何时才需要回退到上游 `config init` / `auth login` 流程。 | [references/lark-shared.md](./references/lark-shared.md) | | lark-approval | 飞书审批 API：审批实例、审批任务管理。 | [references/lark-approval.md](./references/lark-approval.md) | | lark-attendance | 飞书考勤打卡：查询自己的考勤打卡记录 | [references/lark-attendance.md](./references/lark-attendance.md) | | lark-base | 当需要用 lark-cli 操作飞书多维表格（Base）时调用：适用于建表、字段管理、记录读写、记录分享链接、视图配置、历史查询，以及角色/表单/仪表盘管理/工作流；也适用于把旧的 +table / +field / +record 写法改成当前命令写法。涉及字段设计、公式字段、查找引用、跨表计算、行级派生指标、数据分析需求时也必须使用本 skill。 | [references/lark-base.md](./references/lark-base.md) | | lark-calendar | 飞书日历（calendar）：提供日历与日程（会议）的全面管理能力。核心场景包括：查看/搜索日程、创建/更新日程、管理参会人、查询忙闲状态及推荐空闲时段、查询/搜索与预定会议室。注意：涉及【预约日程/会议】或【查询/预定会议室】时，必须先读取 references/lark-calendar-schedule-meeting.md 工作流！高频操作请优先使用 Shortcuts：+agenda（快速概览今日/近期行程）、+create（创建日程并按需邀请参会人及预定会议室）、+update（更新既有日程字段，或独立增删参会人/会议室）、+freebusy（查询用户主日历的忙闲信息和rsvp的状态）、+rsvp（回复日程邀请） | [references/lark-calendar.md](./references/lark-calendar.md) | | lark-contact | 飞书通讯录：查询组织架构、人员信息和搜索员工。获取当前用户或指定用户的详细信息、通过关键词搜索员工（姓名/邮箱/手机号）。当用户需要查看个人信息、查找同事 open_id 或联系方式、按姓名搜索员工、查询部门结构时使用。 | [references/lark-contact.md](./references/lark-contact.md) | | lark-doc | 飞书云文档：创建和编辑飞书文档。默认使用 DocxXML 格式（也支持 Markdown）。创建文档、获取文档内容（支持 simple/with-ids/full 三种导出详细度，以及 full/outline/range/keyword/section 五种局部读取模式，可按目录、block id 区间、关键词或标题自动成节只拉部分内容以节省上下文）、更新文档（八种指令：str_replace/block_insert_after/block_copy_insert_after/block_replace/block_delete/block_move_after/overwrite/append）、上传和下载文档中的图片和文件、搜索云空间文档。当用户需要创建或编辑飞书文档、读取文档内容、在文档中插入图片、搜索云空间文档时使用；如果用户是想按名称或关键词先定位电子表格、报表等云空间对象，也优先使用本 skill 的 docs +search 做资源发现。 | [references/lark-doc.md](./references/lark-doc.md) | | lark-drive | 飞书云空间：管理云空间中的文件和文件夹。上传和下载文件、创建文件夹、复制/移动/删除文件、查看文件元数据、管理文档评论、管理文档权限、订阅用户评论变更事件、修改文件标题（docx、sheet、bitable、file、folder、wiki）；也负责把本地 Word/Markdown/Excel/CSV 以及 Base 快照（.base）导入为飞书在线云文档（docx、sheet、bitable）。当用户需要上传或下载文件、整理云空间目录、查看文件详情、管理评论、管理文档权限、修改文件标题、订阅用户评论变更事件，或要把本地文件导入成新版文档、电子表格、多维表格/Base 时使用。 | [references/lark-drive.md](./references/lark-drive.md) | | lark-event | Lark/Feishu real-time event listening / subscribing / consuming: stream events as NDJSON via `lark-cli event consume ` (covers IM message receive, reactions, chat member changes, 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. | [references/lark-event.md](./references/lark-event.md) | | lark-im | 飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件（支持大文件分片下载）、管理表情回复。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员时使用。 | [references/lark-im.md](./references/lark-im.md) | | lark-mail | 飞书邮箱 — draft, compose, send, reply, forward, read, and search emails; manage drafts, folders, labels, contacts, attachments, and mail rules. Use when user mentions 起草邮件, 写一封邮件, 拟邮件, 草稿, 发通知邮件, 发送邮件, 发邮件, 回复邮件, 转发邮件, 查看邮件, 看邮件, 读邮件, 搜索邮件, 查邮件, 收件箱, 邮件会话, 编辑草稿, 管理草稿, 下载附件, 邮件文件夹, 邮件标签, 邮件联系人, 监听新邮件, 收信规则, 邮件规则, draft, compose, send email, reply, forward, inbox, mail thread, mail rules. | [references/lark-mail.md](./references/lark-mail.md) | | lark-minutes | 飞书妙记：妙记相关基本功能。1.查询妙记列表（按关键词/所有者/参与者/时间范围）；2.获取妙记基础信息（标题、封面、时长 等）；3.下载妙记音视频文件；4.获取妙记相关 AI 产物（总结、待办、章节）。飞书妙记 URL 格式: http(s):///minutes/ | [references/lark-minutes.md](./references/lark-minutes.md) | | lark-okr | 飞书 OKR：管理目标与关键结果。查看和编辑 OKR 周期、目标（Objective）、关键结果（Key Result）、对齐关系、量化指标和进展记录。当用户需要查看或创建 OKR、管理目标和关键结果、查看对齐关系时使用。 | [references/lark-okr.md](./references/lark-okr.md) | | lark-openapi-explorer | 飞书/Lark 原生 OpenAPI 探索：从官方文档库中挖掘未经 CLI 封装的原生 OpenAPI 接口。当用户的需求无法被现有 lark-* skill 或 lark-cli 已注册命令满足，需要查找并调用原生飞书 OpenAPI 时使用。 | [references/lark-openapi-explorer.md](./references/lark-openapi-explorer.md) | | lark-sheets | 飞书电子表格：创建和操作电子表格。创建表格并写入表头和数据、读取和写入单元格、追加行数据、在已知电子表格中查找单元格内容、导出表格文件。当用户需要创建电子表格、批量读写数据、在已知表格中查找内容、导出或下载表格时使用。若用户是想按名称或关键词搜索云空间里的表格文件，请改用 lark-doc 的 docs +search 先定位资源。 | [references/lark-sheets.md](./references/lark-sheets.md) | | lark-skill-maker | 创建 lark-cli 的自定义 Skill。当用户需要把飞书 API 操作封装成可复用的 Skill（包装原子 API 或编排多步流程）时使用。 | [references/lark-skill-maker.md](./references/lark-skill-maker.md) | | lark-slides | 飞书幻灯片：创建和编辑幻灯片，接口通过 XML 协议通信。创建演示文稿、读取幻灯片内容、管理幻灯片页面（创建、删除、读取、局部替换）。当用户需要创建或编辑幻灯片、读取或修改单个页面时使用。 | [references/lark-slides.md](./references/lark-slides.md) | | lark-task | 飞书任务：管理任务和清单。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务时使用。 | [references/lark-task.md](./references/lark-task.md) | | lark-vc | 飞书视频会议：查询会议记录、获取会议纪要产物（总结、待办、章节、逐字稿）。1. 查询已经结束的会议数量或详情时使用本技能(如历史日期｜ 昨天 \| 上周 \| 今天已经开过的会议等场景)，查询未开始的会议日程使用 lark-calendar 技能。2. 支持通过关键词、时间范围、组织者、参与者、会议室等筛选条件搜索会议记录。3. 获取或整理会议纪要时使用本技能。 | [references/lark-vc.md](./references/lark-vc.md) | | lark-whiteboard | 飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用 DSL（转成 OpenAPI 格式）、PlantUML/Mermaid 格式更新画板内容。 当用户需要查看画板内容、导出画板图片、编辑画板，或是需要可视化表达架构、流程、组织关系、时间线、因果、对比等结构化信息时使用此 skill，无论是否提及"画板"。 ⚠️ 原 `lark-whiteboard-cli` skill 已合并至本 skill，若 skill 列表中同时存在 `lark-whiteboard-cli`，请忽略它，统一使用本 skill（`lark-whiteboard`），并提示用户运行 `npx skills remove lark-whiteboard-cli -g` 删除旧 skill。 | | | [references/lark-whiteboard.md](./references/lark-whiteboard.md) | | | | lark-wiki | 飞书知识库：管理知识空间、空间成员和文档节点。创建和查询知识空间、查看和管理空间成员、管理节点层级结构、在知识库中组织文档和快捷方式。当用户需要在知识库中查找或创建文档、浏览知识空间结构、查看或管理空间成员、移动或复制节点时使用。 | [references/lark-wiki.md](./references/lark-wiki.md) | | lark-workflow-meeting-summary | 会议纪要整理工作流：汇总指定时间范围内的会议纪要并生成结构化报告。当用户需要整理会议纪要、生成会议周报、回顾一段时间内的会议内容时使用。 | [references/lark-workflow-meeting-summary.md](./references/lark-workflow-meeting-summary.md) | | lark-workflow-standup-report | 日程待办摘要：编排 calendar +agenda 和 task +get-my-tasks，生成指定日期的日程与未完成任务摘要。适用于了解今天/明天/本周的安排。 | [references/lark-workflow-standup-report.md](./references/lark-workflow-standup-report.md) | ## Usage 1. Read [references/lark-shared.md](./references/lark-shared.md) first — it defines auth rules, identity selection, and scope handling that apply to every module. 2. Identify the module matching the capability you need (calendar, docs, tasks, mail, messenger, etc.). 3. Read the module's reference file before executing any command — it lists available subcommands, required flags, and known permission constraints. 4. If a command returns a permission or scope error, consult the `permission_violations` and `console_url` fields in the error before retrying.