community skill
LarkSuite CLI Skills
Lark/Feishu 官方 lark-cli 仓库中的 AI Agent Skills 套件,覆盖飞书消息、文档、云盘、表格、多维表格、日历、邮件、任务、会议和审批等业务域。
communityskill packagelarkfeishucliproductivityautomation
LarkSuite CLI Skills
LarkSuite CLI Skills 是 Lark/Feishu 官方 larksuite/cli 仓库中的 AI Agent Skills 套件,配合 lark-cli 让 agent 操作飞书 / Lark 的消息、文档、云盘、知识库、表格、多维表格、日历、邮件、任务、会议、审批、OKR 等业务域。上游 README 标注该 CLI 面向人类和 AI Agents,包含 200+ commands 和 20+ AI Agent Skills。
来源
- 上游 skills 目录:https://github.com/larksuite/cli/tree/main/skills
- 上游仓库:https://github.com/larksuite/cli
- 英文 README:https://github.com/larksuite/cli/blob/main/README.md
- 中文 README:https://github.com/larksuite/cli/blob/main/README.zh.md
- npm 包:https://www.npmjs.com/package/@larksuite/cli
- 许可证:MIT
适合什么时候用
- 需要让 agent 读取、创建、更新或整理飞书文档、知识库页面、云盘文件和 Markdown 文件。
- 需要通过飞书电子表格、多维表格、图表、透视表、条件格式和筛选视图完成数据分析或办公自动化。
- 需要收发飞书消息、搜索聊天记录、管理群聊、下载消息附件或处理表情回复。
- 需要读取日历、安排会议、查询会议纪要、生成站会报告或汇总会议待办。
- 需要处理飞书用户 / 机器人身份、scope 授权、二维码登录、权限不足和高风险写操作确认。
套件内容
上游 skills/ 目录包含多个业务域 skill,核心条目包括:
| Skill | 用途 |
|---|---|
lark-shared | 应用配置、认证登录、用户 / 机器人身份切换、scope、更新提示和安全规则 |
lark-doc | 飞书云文档 / Docx / Wiki 文档的创建、读取、编辑、改写、翻译、审阅和素材处理 |
lark-drive | 云盘文件上传下载、搜索、权限、评论等 |
lark-markdown | Drive-native Markdown 文件创建、获取、补丁和覆盖 |
lark-sheets | 飞书电子表格读取、写入、公式、样式、图表、透视表、筛选和条件格式 |
lark-base | 多维表格表、字段、记录、视图、仪表盘、表单、角色权限和分析 |
lark-im | 飞书即时通讯、群聊、消息搜索、附件下载、消息回复和 reaction |
lark-calendar | 日程、忙闲、会议室、邀请和 RSVP |
lark-mail | 邮件读取、搜索、发送、回复、转发、草稿和新邮件监听 |
lark-task | 任务、任务清单、子任务、评论、提醒和成员分配 |
lark-vc / lark-minutes | 会议记录、妙记元数据、AI 摘要、待办和录音录像素材 |
lark-openapi-explorer | 从官方文档探索底层 OpenAPI |
lark-skill-maker | 自定义 Lark skill 创建框架 |
lark-workflow-meeting-summary / lark-workflow-standup-report | 会议纪要汇总和站会 / 待办报告工作流 |
此外还包含 lark-approval、lark-attendance、lark-apps、lark-contact、lark-event、lark-okr、lark-slides、lark-vc-agent、lark-whiteboard、lark-wiki 等业务域 skill。
安装提示
这是一个多 skill 目录。上游推荐先安装 CLI;从 npm 安装时使用:
npx @larksuite/cli@latest install
如果需要通过 skills CLI 安装上游 skills,可指向 skills 目录:
npx skills add https://github.com/larksuite/cli/tree/main/skills
从源码安装时,上游 README 也给出:
git clone https://github.com/larksuite/cli.git
cd cli
make install
npx skills add larksuite/cli -y -g
首次配置与认证通常需要用户在浏览器中完成授权:
lark-cli config init --new
lark-cli auth login --recommend
lark-cli auth status
使用注意
- 多数业务域 skill 都要求先读取
lark-shared,因为认证、身份选择、scope、权限不足、更新提示和高风险写操作规则都在那里。 --as user和--as bot行为差异很大:bot 不能访问用户个人资源,user 需要用户授权;应按目标资源选择身份。- 帮用户发起认证时,上游推荐 split-flow:先用
--no-wait --json取verification_url和device_code,展示链接 / 二维码,等用户授权后再执行--device-code完成登录。 - 高风险写操作会以 exit code 10 和
confirmation_requiredenvelope 要求确认;不能静默追加--yes,必须让用户明确同意。 - 飞书文档、表格、多维表格、会议纪要等对象都有严格 token / URL / scope 规则;不要凭直觉拼参数,应按对应业务域 skill 的 reference 执行。