feishu-task-manage

name	feishu-task-manage
description	飞书任务管理（创建、查看、更新、完成、删除任务）。触发词：任务、todo、完成任务、创建任务、飞书任务、task、负责人、截止时间、提醒。
metadata	{"openclaw":{"emoji":"✅","requires":{"config":["channels.feishu"]}}}

飞书任务管理 Skill

概述

本 Skill 指导你使用 feishu_task 工具管理飞书任务。任务通过清单管理，操作前需确保群组已关联清单（参考 feishu-tasklist-manage）。

工具：feishu_task

action	说明	必需参数
create	创建任务	summary，可选 description/assignee_ids/due_timestamp/mode 等
get	获取任务详情	task_guid
list	列出清单内所有任务	可选 tasklist_guid/chat_id/status_filter
update	更新任务	task_guid + 要更新的字段
complete	标记任务完成	task_guid
uncomplete	恢复任务为未完成	task_guid
delete	删除任务	task_guid
add_members	添加负责人/关注人	task_guid + assignee_ids 或 follower_ids
remove_members	移除成员	task_guid + member_ids + member_role
add_subtask	创建子任务	task_guid + summary
add_reminder	添加提醒	task_guid + reminder_minutes
remove_reminder	移除提醒	task_guid

任务完成模式

mode	名称	说明
1	会签	所有负责人均需完成，任务才算完成（默认）
2	或签	任一负责人完成即可

识别消息中的飞书任务链接

飞书任务链接格式：https://applink.feishu.cn/client/todo/detail?guid=<task_guid>&suite_entity_num=<编号>

• guid= 后面的值就是 task_guid，用于 get/update/complete 等操作
• suite_entity_num= 是人类可读编号（如 t100939），不是 API 参数
• 示例：https://applink.feishu.cn/client/todo/detail?guid=ec5957fb-c594-4f51-8af2-729e89ba90d3 → task_guid = ec5957fb-c594-4f51-8af2-729e89ba90d3

获取消息详情

当引用消息内容不完整（如 [卡片消息]、[interactive消息]）时，可以用 feishu_get_message 工具通过 message_id 获取完整内容。

⚠️ 会签任务完成规则（重要）

飞书 API 不支持为会签任务单独标记某个负责人完成。调用 complete 会将整个任务标记为完成，所有负责人都会被标记为已完成。

当用户要求完成一个任务时，必须执行以下流程：

1. 先用 feishu_task get 获取任务详情
2. 检查任务的 mode 和负责人数量
3. 如果是会签任务（mode=1）且有多个负责人：
   • 明确告知用户：「这是会签任务，点击完成会将所有负责人都标记为已完成，包括 XXX 和 YYY。确认要全部完成吗？」
   • 使用 feishu_propose_task 发送一个确认卡片，让用户点击按钮快捷确认（参考下方卡片流程）
   • 不要直接调用 complete，等用户确认后再执行
4. 如果是或签任务（mode=2）或只有一个负责人：可以直接完成

确认完成的卡片流程

会签任务需先用 feishu_propose_task 发确认卡片（summary="完成任务: <标题>", assignee_ids=[原负责人], description="会签任务，确认后标记所有人完成"）。用户点确认后再调 complete，点取消则不执行。

典型场景

• 创建任务 → feishu_task create (summary + assignee_ids + due_timestamp, mode 默认 1)
• 查看群组任务 → feishu_task list (status_filter="open")
• 改完成模式 → feishu_task update (task_guid + mode=2)
• 完成任务 → 先 get 检查 mode 和负责人 → 会签+多人则发确认卡片 → 确认后 complete

铁律

• 完成任务前必须先 get 检查 mode 和负责人，会签任务必须提醒用户
• 会签任务不要直接 complete，先发卡片确认
• mode 1 = 会签（全部完成），mode 2 = 或签（任一完成）
• 任务链接中 guid= 是 task_guid，直接用于 API 调用
• 创建任务时不传 mode 默认为 1（会签）
• 回复简洁：操作完成后给出简短确认即可，不要把所有 API 返回字段都发给用户