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

评论区

0 条评论

登录后可评论。

Skill超级捕获手 12 阅读