Lark CLI Skill:飞书官方 26 个 AI Agent Skills 一次性接管你的飞书办公套件
总结
Lark CLI(飞书官方 CLI)是字节跳动旗下飞书团队 2026 年 3 月正式开源的命令行工具,专为人类与 AI Agent 协同设计。它把 18 个飞书业务域、200 多条命令打包成 26 个开箱即用的 AI Agent Skills,让 Claude Code、Codex、Cursor 等 Agent 能在终端里直接读写飞书消息、文档、多维表格、邮件、日历和审批。在 skills.sh 上仅 lark-base(多维表格)一个 Skill 累计安装就突破 56 万、周活跃安装 3.3 万–4.6 万次,成为中文办公领域增长最快的 Agent 工具集。
功能与原则
核心能力:覆盖日历、Messenger(消息)、Docs(文档)、Drive(云盘)、Markdown、Base(多维表格)、Sheets(电子表格)、Slides(幻灯片)、Tasks(任务)、Wiki(知识库)、Contact、Mail、Meetings、Attendance、Approval、OKR、Apps 等 18 个业务域,提供 200+ 命令和 26 个 Skill。
设计原则:
– Agent-Native:每个 Skill 都对应一个 AI Agent 高频任务,开箱即用、零额外配置。
– 三层调用架构:快捷命令(人/AI 友好)→ API 命令(平台同步)→ 通用 API(完全覆盖),按需选择粒度。
– 安全可控:输入注入防护、终端输出清洗、OS 原生密钥链(macOS Keychain / Windows DPAPI / Linux Secret Service)。
– AI 友好:每条命令都经过真实 Agent 测试,参数简洁、智能默认、结构化输出,最大化 Agent 调用成功率。
认可度
GitHub Stars 16,395(截至 2026-08-12),Forks 1,305,MIT 开源。仓库创建于 2026-03-25,最近一次代码推送 2026-08-12,开发极度活跃。在 skills.sh 官方 Skill 平台,lark-base 单项累计安装 563.1K,周安装稳定在 33K–46K;整个 open.feishu.cn 站点下合计安装量约 159.4K × 多周叠加,已在中文 Skill 榜单稳居前列。多个 Skill(lark-base、lark-doc、lark-calendar、lark-im 等)被独立收录进 skills.sh 官方分类。
链接
GitHub:https://github.com/larksuite/cli
Skills 市场页:https://www.skills.sh/site/open.feishu.cn/lark-base
原作者
由 larksuite(飞书官方 GitHub 组织) 维护,开源项目主导团队来自 Lark/飞书工程部。这是字节跳动旗下飞书的官方出品的 CLI 工具,而非社区第三方。
介绍
把飞书装进 Agent 的终端。Lark CLI 是飞书团队于 2026 年 3 月正式开源的命令行工具,目标一句话:让人类和 AI Agent 都能在终端里操作飞书的全部核心功能。它内置 18 个业务域、200 多条精选命令、26 个 AI Agent Skills,并采用三层调用架构(快捷命令 → API 命令 → 通用 API 调用),让开发者和 Claude Code、Codex、Cursor、Windsurf 等编程助手可以在终端里直接完成原本必须打开飞书 App 才能做的事。
它不是简单的 API 包装。每个 Skill 都在 README 里写了完整的触发场景、参数约束、输出格式。lark-base 帮你建表、改表、写公式字段、跑数据聚合;lark-im 帮你发消息、搜消息、管群聊;lark-doc 帮你读写飞书文档;lark-calendar 帮你约会议、查空闲时间;lark-mail 帮你读邮件、发邮件。一个 npm 包覆盖整个飞书办公栈。
特点
- 官方出品,安全可控:飞书官方维护,MIT 开源,凭证走 OS 原生密钥链,不在终端打印敏感信息。
- 18 业务域全覆盖:消息、文档、多维表格、电子表格、幻灯片、任务、知识库、邮件、日历、会议、出勤、审批、OKR、Apps 等,一个 CLI 通吃。
- 26 个结构化 Skills:每个 Skill 都有独立的 SKILL.md 描述、触发条件、命令清单,可单独安装或一键全装。
- 三层调用架构:从「一句自然语言」到「完整 API 调用」按粒度自选,适配从简单查询到复杂自动化。
- 3 分钟跑通:一键创建应用 + 交互登录 + 第一条命令,全程无需写代码。
使用方法
Step 1:安装 CLI
npx @larksuite/cli@latest install
Step 2:安装 Skill(关键)
# 安装全部 Skill 到全局
npx skills add larksuite/cli -y -g
# 或只装某一个,例如多维表格
npx skills add https://open.feishu.cn/ -y
Step 3:配置应用凭证(一次性)
lark-cli config init
会输出一个授权 URL,在浏览器里打开并授权即可。
Step 4:登录
lark-cli auth login --recommend
Step 5:开用
最小示例(AI Agent 自动调用 lark-base Skill):
> 用 lark-base 在我的飞书 Base 「8 位同事周报」里新建一张表,
字段包含:姓名(文本)、本周完成(长文本)、下周计划(长文本)、阻塞项(长文本),
并把今天之前的 7 条历史记录读出来导出成 CSV。
Agent 会自动选 Skill → 调 lark-cli 命令 → 完成建表 + 写记录 + 导出 CSV,整个过程在终端里完成。
使用场景与人群
适用场景:
– 让 Claude Code / Cursor / Codex 直接操作飞书办公套件(建文档、发邮件、约会议、跑数据)。
– 个人开发者把飞书数据接入 AI 工作流(自动汇总周报、抓会议纪要、同步任务到 OKR)。
– 企业 IT 把 Lark CLI 嵌入自家 Agent 平台,通过 wrapper main 限制命令面、统一凭证管理、加审计日志。
目标用户:
– 每天重度使用飞书的职场人(运营、产品、HR、销售),希望把重复操作自动化。
– AI Agent 开发者,希望让 Agent 能落地在真实办公场景,而不是只做 demo。
– 中文办公自动化团队,需要一个稳定可控、官方维护的飞书 API 工具集。
输入与输出案例
案例 1:用 lark-base 建一张周报表
输入(Agent 自动拆解后的命令):
lark-cli base +table-create
--app-token bcnxxxxxxxxxxxxxx
--name "8 位同事周报"
--fields '[
{"name":"姓名","type":"text"},
{"name":"本周完成","type":"long_text"},
{"name":"下周计划","type":"long_text"},
{"name":"阻塞项","type":"long_text"}
]'
输出:
{
"table_id": "tblxxxxxxxx",
"fields": [
{"name":"姓名","type":"text","field_id":"fld001"},
{"name":"本周完成","type":"long_text","field_id":"fld002"},
{"name":"下周计划","type":"long_text","field_id":"fld003"},
{"name":"阻塞项","type":"long_text","field_id":"fld004"}
]
}
案例 2:用 lark-im 拉群聊消息生成会议纪要
输入:
lark-cli im +chat-messages-list
--chat-id oc_xxxxxxxxxxxxxx
--since 2026-08-05T00:00:00+08:00
--format json
输出(结构化 JSON):
{
"messages": [
{"sender":"王老师","time":"2026-08-05 10:23","text":"这周五上线需求对齐","thread":false},
{"sender":"设计同学","time":"2026-08-05 10:25","text":"视觉稿已更新到 v3","thread":false},
{"sender":"前端同学","time":"2026-08-05 10:31","text":"周五可以 merge PR","thread":false}
]
}
Agent 会基于这串消息自动生成会议纪要 Markdown,存到飞书文档。
GitHub: https://github.com/larksuite/cli
评论区
登录后可评论。