Smithery is now a part of Arcade.dev! Read more in our announcement here

lark-cli

urial-Q2rt/lark-cli

1 installs

About

SKILL.md

lark-cli

urial-Q2rt/lark-cli

1 installs

About

当用户要求 Codex 通过 lark-cli 操作飞书/Lark 时使用：安装配置、登录授权、scope 检查、消息、文档、云空间、知识库、日历、任务、审批、多维表格、电子表格、幻灯片、邮箱、妙记、会议、OKR、考勤、画板、应用或原生 OpenAPI 调用。

SKILL.md

Lark CLI

概览

把已安装的 lark-cli 作为飞书/Lark 操作的默认入口。优先使用 lark-cli 命令和它内置的领域 skill，不要优先写自定义 SDK 脚本、手动处理 token，或随手拼 HTTP 请求；只有 CLI 无法覆盖目标 API 时才考虑通用 OpenAPI 或其他方式。

安全规则

不要打印或暴露 app secret、access token、refresh token、cookie 或凭据文件内容。
发送消息/邮件、创建会议、修改文档、编辑表格或多维表格记录、审批/拒绝流程、删除/移动文件、修改应用可见范围前，先向用户确认。
只读请求使用能回答问题的最窄命令。
遇到权限或 scope 错误时，先运行 lark-cli auth status，再使用 lark-cli auth login --domain <domain> 或 --scope <scope> 补充授权，不要自己伪造 token。

安装与初始化

如果 lark-cli 未安装或未配置，按官方 README 的 AI Agent 快速开始执行： https://github.com/larksuite/cli/blob/main/README.zh.md

检查前置环境并通过 npm 安装：
```
node -v
npm -v
npx @larksuite/cli@latest install
```
除非用户另有要求，交互提示使用默认中文/英文选项。如果安装器在下载 release 二进制时卡住，先检查 command -v lark-cli；然后重新运行 lark-cli --version，等待自动下载完成。最终用 lark-cli --version 验证二进制可用。
配置应用凭证：
```
lark-cli config init --new
```
在后台/终端运行，提取命令输出的二维码或链接发给用户。用户必须自己在浏览器/飞书中完成授权，不要代替用户确认授权。
使用推荐 scope 登录：
```
lark-cli auth login --recommend
```
把设备验证链接发给用户，等待用户完成授权。
验证配置：
```
lark-cli auth status
lark-cli doctor
```
doctor 返回 "ok": true 才算完成。

工作流

如果当前会话还没有用过 CLI，先检查：

command -v lark-cli
lark-cli doctor
lark-cli auth status

选择业务域：

lark-cli skills list
lark-cli skills read lark-doc
lark-cli calendar --help

复杂或有副作用的调用前，先确认精确命令形态：

lark-cli <domain> --help
lark-cli <domain> <resource> --help
lark-cli schema <service.resource.method> --format pretty

使用结构化 JSON 参数执行。常见任务优先用快捷命令；需要精确端点时使用领域 API 命令。
安装、配置、授权或写操作后，用读回命令、lark-cli auth status 或 lark-cli doctor 验证结果。

业务域路由

以 lark-cli skills list 作为当前可信来源。常见路由：

用户意图	起始命令
安装配置、登录、scope、身份切换	`lark-cli config`, `lark-cli auth`, `lark-cli profile`, `lark-cli doctor`
收发/搜索消息、群聊、置顶、表情反应	`lark-cli im`
查找人员、解析 open_id	`lark-cli contact`
日历、会议、忙闲、会议室	`lark-cli calendar`
飞书任务和任务清单	`lark-cli task`
审批任务和审批实例	`lark-cli approval`
云文档/docx 内容	`lark-cli docs`
云空间文件、文件夹、上传下载、权限	`lark-cli drive`
云空间中的原生 Markdown 文件	`lark-cli markdown`
知识库空间和节点	`lark-cli wiki`
多维表格记录、字段、视图	`lark-cli base`
电子表格	`lark-cli sheets`
幻灯片	`lark-cli slides`
邮箱	`lark-cli mail`
妙记、会议纪要、视频会议记录	`lark-cli minutes`, `lark-cli note`, `lark-cli vc`
实时事件	`lark-cli event`
OKR、考勤、画板、应用	`lark-cli okr`, `attendance`, `whiteboard`, `apps`
CLI 未封装或不支持的 API	`lark-cli api <METHOD> <PATH>`

命令模式

# 面向人和 Agent 的快捷命令
lark-cli calendar +agenda

# 带 JSON 参数的领域 API 命令
lark-cli calendar events instance_view --params '{"calendar_id":"primary","start_time":"1781500000","end_time":"1781586400"}'

# 通用 OpenAPI 调用
lark-cli api GET /open-apis/calendar/v4/calendars

如果命令输出中包含 _notice、权限提示或建议 scope，按提示补充授权后重试。

常见错误

不要再为新任务使用旧的 feishu Python SDK skill 或它的 .env token 流程。
不要假设当前 scope 覆盖所有业务域。写操作前先检查 auth status。
已有 lark-cli 命令或 OpenAPI 端点时，不要抓取飞书网页。
不要把审批任务当作飞书任务；审批流程用 approval，待办用 task。
不要用视频会议历史命令查未来日程；未来事件用 calendar，已结束会议产物用 vc/minutes/note。

About

SKILL.md

About

SKILL.md

Lark CLI

概览

安全规则

不要打印或暴露 app secret、access token、refresh token、cookie 或凭据文件内容。
发送消息/邮件、创建会议、修改文档、编辑表格或多维表格记录、审批/拒绝流程、删除/移动文件、修改应用可见范围前，先向用户确认。
只读请求使用能回答问题的最窄命令。
遇到权限或 scope 错误时，先运行 lark-cli auth status，再使用 lark-cli auth login --domain <domain> 或 --scope <scope> 补充授权，不要自己伪造 token。

安装与初始化

如果 lark-cli 未安装或未配置，按官方 README 的 AI Agent 快速开始执行： https://github.com/larksuite/cli/blob/main/README.zh.md

检查前置环境并通过 npm 安装：
```
node -v
npm -v
npx @larksuite/cli@latest install
```
除非用户另有要求，交互提示使用默认中文/英文选项。如果安装器在下载 release 二进制时卡住，先检查 command -v lark-cli；然后重新运行 lark-cli --version，等待自动下载完成。最终用 lark-cli --version 验证二进制可用。
配置应用凭证：
```
lark-cli config init --new
```
在后台/终端运行，提取命令输出的二维码或链接发给用户。用户必须自己在浏览器/飞书中完成授权，不要代替用户确认授权。
使用推荐 scope 登录：
```
lark-cli auth login --recommend
```
把设备验证链接发给用户，等待用户完成授权。
验证配置：
```
lark-cli auth status
lark-cli doctor
```
doctor 返回 "ok": true 才算完成。

工作流

如果当前会话还没有用过 CLI，先检查：

command -v lark-cli
lark-cli doctor
lark-cli auth status

选择业务域：

lark-cli skills list
lark-cli skills read lark-doc
lark-cli calendar --help

复杂或有副作用的调用前，先确认精确命令形态：

lark-cli <domain> --help
lark-cli <domain> <resource> --help
lark-cli schema <service.resource.method> --format pretty

使用结构化 JSON 参数执行。常见任务优先用快捷命令；需要精确端点时使用领域 API 命令。
安装、配置、授权或写操作后，用读回命令、lark-cli auth status 或 lark-cli doctor 验证结果。

业务域路由

以 lark-cli skills list 作为当前可信来源。常见路由：

用户意图	起始命令
安装配置、登录、scope、身份切换	`lark-cli config`, `lark-cli auth`, `lark-cli profile`, `lark-cli doctor`
收发/搜索消息、群聊、置顶、表情反应	`lark-cli im`
查找人员、解析 open_id	`lark-cli contact`
日历、会议、忙闲、会议室	`lark-cli calendar`
飞书任务和任务清单	`lark-cli task`
审批任务和审批实例	`lark-cli approval`
云文档/docx 内容	`lark-cli docs`
云空间文件、文件夹、上传下载、权限	`lark-cli drive`
云空间中的原生 Markdown 文件	`lark-cli markdown`
知识库空间和节点	`lark-cli wiki`
多维表格记录、字段、视图	`lark-cli base`
电子表格	`lark-cli sheets`
幻灯片	`lark-cli slides`
邮箱	`lark-cli mail`
妙记、会议纪要、视频会议记录	`lark-cli minutes`, `lark-cli note`, `lark-cli vc`
实时事件	`lark-cli event`
OKR、考勤、画板、应用	`lark-cli okr`, `attendance`, `whiteboard`, `apps`
CLI 未封装或不支持的 API	`lark-cli api <METHOD> <PATH>`

命令模式

# 面向人和 Agent 的快捷命令
lark-cli calendar +agenda

# 带 JSON 参数的领域 API 命令
lark-cli calendar events instance_view --params '{"calendar_id":"primary","start_time":"1781500000","end_time":"1781586400"}'

# 通用 OpenAPI 调用
lark-cli api GET /open-apis/calendar/v4/calendars

如果命令输出中包含 _notice、权限提示或建议 scope，按提示补充授权后重试。

常见错误

不要再为新任务使用旧的 feishu Python SDK skill 或它的 .env token 流程。
不要假设当前 scope 覆盖所有业务域。写操作前先检查 auth status。
已有 lark-cli 命令或 OpenAPI 端点时，不要抓取飞书网页。
不要把审批任务当作飞书任务；审批流程用 approval，待办用 task。
不要用视频会议历史命令查未来日程；未来事件用 calendar，已结束会议产物用 vc/minutes/note。