| name | lark |
| version | 2.0.0 |
| description | Lark/Feishu CLI router: query and operate Lark/Feishu via lark-cli. Use `lark-cli skills read <sub-skill>` (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. |
| metadata | {"requires":{"bins":["lark-cli"]}} |
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
- Auth & Identity: Run
lark-cli skills read lark-shared once per session for auth state, --as identity rules, and domain permissions.
- Select Sub-skill: Match user intent to the domain in the Sub-skill Index table below.
- Load Sub-skill: Execute the corresponding read command:
lark-cli skills read <sub-skill>
(e.g., lark-cli skills read lark-doc, lark-cli skills read lark-base)
- 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)
- 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。 |
Routing Rules
- Always run
lark-cli skills read lark-shared first for authentication and permission rules.
- Match intent to the Use When column; run that row's Read Command (e.g.
lark-cli skills read lark-doc).
- Follow the returned guidance and read needed reference documents via
lark-cli skills read <sub-skill>/<path>.
- Multi-domain tasks: execute
lark-cli skills read for each relevant sub-skill in task order (auth shared once).
- Document-embedded whiteboards or spreadsheets: read
lark-doc first, then load lark-whiteboard or lark-sheets as instructed.
