feishu-tasklist-manage

name	feishu-tasklist-manage
description	飞书任务清单管理。触发词：创建清单、管理清单、清单成员、tasklist、任务清单、查看飞书任务、创建飞书任务。
metadata	{"openclaw":{"emoji":"📝","requires":{"config":["channels.feishu"]}}}

飞书任务清单管理 Skill

概述

清单(tasklist)是飞书任务的容器。bot 作为应用身份，只能通过自己创建或被加入的清单来访问任务。本 Skill 指导你使用 feishu_tasklist 工具管理清单。

触发词：创建清单、管理清单、清单成员、tasklist、任务清单、查看飞书任务、创建飞书任务

工具：feishu_tasklist

action	说明	必需参数
create	创建清单	可选 name, chat_id（传 chat_id 自动加群为 editor 并保存到 DB）
list	列出 bot 可见的所有清单	无
get	获取清单详情（含成员列表）	tasklist_guid
delete	删除清单（不可恢复）	tasklist_guid
patch	更新清单名称	tasklist_guid + name
add_members	添加清单成员	tasklist_guid + member_ids + member_type + member_role
remove_members	移除清单成员	tasklist_guid + member_ids + member_type
list_tasks	列出清单内所有任务	tasklist_guid

清单权限模型

• 所有者(owner)：读取 + 编辑 + 管理（删除清单、改 owner）
• 可编辑(editor)：读取 + 编辑（改名、增删成员、增删任务）
• 可阅读(viewer)：只能读取

群组作为成员：将群组加为 editor/viewer 后，该群所有成员都自动获得对应权限。

bot 创建清单时自动成为 owner。

关键工作流

为群组初始化清单（最常用）

1. feishu_tasklist list → 看有没有已关联此群的清单
   - 检查每个清单的 members，看有没有当前 chat_id
2. 如果找到了 → 直接用这个清单的 tasklist_guid
3. 如果没找到 → feishu_tasklist create (name="群组任务", chat_id=当前群)
4. 拿到 tasklist_guid 后，后续 feishu_task 操作都传这个 guid

DB 被清但飞书清单还在

1. feishu_tasklist list → 搜索已有清单的关联群组
2. 找到包含当前 chat_id 的清单 → 直接用，不要重复创建

跨群共享清单

1. feishu_tasklist add_members (tasklist_guid=..., member_ids=[其他群chat_id], member_type="chat", member_role="editor")

查看清单内任务

1. feishu_tasklist list_tasks (tasklist_guid=...)

与 feishu_task 的分工

• 清单管理 → 用 feishu_tasklist（创建/查找/删除清单、管理成员）
• 任务操作 → 用 feishu_task（创建/查看/更新/完成任务）

feishu_task 的 create 和 list 操作需要 tasklist_guid。如果 DB 有缓存可以自动读取，否则需要先用 feishu_tasklist 查找或创建清单。

注意事项

• 删除清单不可恢复，慎用
• 一个群可以关联一个清单（DB 层面是 1:1 映射）
• 创建清单时传 chat_id 会同时保存到 DB 和加群为 editor
• 不要重复创建清单，先用 list 检查