lark

star 129

飞书/Lark 群聊管理能力。当用户在飞书中请求群管理(踢人、查成员、改群名)、 群聊创建/更新/解散、管理员设置/移除、用户查询或文件上传时使用。 即使用户没有提到飞书,只要上下文是 Lark 场景且涉及群聊或用户操作,就应触发。 仅有昵称时必须先 list_members 或 get_user 获取 user_id。

zhinjs By zhinjs schedule Updated 6/11/2026

name: lark platforms: - lark description: >- 飞书/Lark 群聊管理能力。当用户在飞书中请求群管理(踢人、查成员、改群名)、 群聊创建/更新/解散、管理员设置/移除、用户查询或文件上传时使用。 即使用户没有提到飞书,只要上下文是 Lark 场景且涉及群聊或用户操作,就应触发。 仅有昵称时必须先 list_members 或 get_user 获取 user_id。 keywords: - lark - 飞书 - adapter:lark - 群管理 - 管理员 - 群聊 - 文件上传 - 解散 - list_members tags: - group - management - im - enterprise tools: - lark_get_user - lark_create_chat - lark_update_chat - lark_add_members - lark_set_managers - lark_remove_managers - lark_dissolve_chat - lark_upload_file - lark_kick_member - lark_list_members - lark_get_group_info - lark_set_group_name

飞书/Lark 群聊管理技能

飞书的群聊模型偏向企业场景,有群聊创建/解散的完整生命周期管理,以及文件上传能力。

核心原则

企业级 ID 体系

飞书的用户 ID 有三种形式(open_id / union_id / user_id),不同 API 可能需要不同 ID 类型。通过 lark_get_user 可以查询用户详情并获取各种 ID。

群聊生命周期

飞书支持完整的群聊生命周期管理:创建 → 添加成员 → 设管理员 → 正常使用 → 更新设置 → 解散。

Example — 创建项目群:

步骤1: lark_create_chat(name="XX项目组", members=[user1, user2])
步骤2: lark_set_managers(chat_id, managers=[user1])  # 设管理员

工具分类

群聊管理

工具 用途 说明
lark_create_chat 创建群聊 需指定群名 + 初始成员
lark_update_chat 更新群设置 群名、群描述等
lark_dissolve_chat 解散群聊 不可逆,需群主权限
lark_add_members 添加成员
lark_kick_member 移除成员
lark_set_managers 设管理员
lark_remove_managers 移除管理员
lark_set_group_name 改群名
lark_list_members 成员列表
lark_get_group_info 群信息

用户与文件

工具 用途 说明
lark_get_user 查询用户信息 可获取多种 ID 形式
lark_upload_file 上传文件 返回 file_key,可在消息中引用

易错点

  1. 解散群聊不可逆,需群主权限。确认用户意图后再执行。
  2. 群聊创建至少需要群名和一个初始成员
  3. 文件上传返回 file_key,这个 key 用于在消息中引用文件,不是文件内容本身。
  4. 飞书有 open_id / union_id / user_id 三种 ID,操作时注意使用正确的 ID 类型。
Install via CLI
npx skills add https://github.com/zhinjs/zhin --skill lark
Repository Details
star Stars 129
call_split Forks 17
navigation Branch main
article Path SKILL.md
More from Creator