飞书任务管理

🚨 执行前必读

• ✅ 时间格式：ISO 8601 / RFC 3339（带时区），例如 2026-02-28T17:00:00+08:00
• ✅ current_user_id 强烈建议：从消息上下文的 SenderId 获取（ou_...），工具会自动添加为 follower（如不在 members 中），确保创建者可以编辑任务
• ✅ patch/get 必须：task_guid
• ✅ tasklist.tasks 必须：tasklist_guid
• ✅ 完成任务：completed_at = "2026-02-26 15:00:00"
• ✅ 反完成（恢复未完成）：completed_at = "0"

---

📋 快速索引：意图 → 工具 → 必填参数

用户意图	工具	action	必填参数	强烈建议	常用可选
新建待办	feishu_task_task	create	summary	current_user_id（SenderId）	members, due, description
查未完成任务	feishu_task_task	list	-	completed=false	page_size
获取任务详情	feishu_task_task	get	task_guid	-	-
完成任务	feishu_task_task	patch	task_guid, completed_at	-	-
反完成任务	feishu_task_task	patch	task_guid, completed_at="0"	-	-
改截止时间	feishu_task_task	patch	task_guid, due	-	-
创建清单	feishu_task_tasklist	create	name	-	members
查看清单任务	feishu_task_tasklist	tasks	tasklist_guid	-	completed
添加清单成员	feishu_task_tasklist	add_members	tasklist_guid, members[]	-	-

---

🎯 核心约束（Schema 未透露的知识）

1. 当前工具使用用户身份（已内置保护）

工具使用 user_access_token（用户身份）

这意味着：

• ✅ 创建任务时可以指定任意成员（包括只分配给别人）
• ⚠️ 只能查看和编辑自己是成员的任务
• ⚠️ 如果创建时没把自己加入成员，后续无法编辑该任务

自动保护机制：

• 传入 current_user_id 参数（从 SenderId 获取）
• 如果 members 中不包含 current_user_id，工具会自动添加为 follower
• 确保创建者始终可以编辑任务

推荐用法：创建任务时始终传 current_user_id，工具会自动处理成员关系。

2. 任务成员的角色说明

• assignee（负责人）：负责完成任务，可以编辑任务
• follower（关注人）：关注任务进展，接收通知

添加成员示例：

{
  "members": [
    {"id": "ou_xxx", "role": "assignee"},  // 负责人
    {"id": "ou_yyy", "role": "follower"}   // 关注人
  ]
}

说明：id 使用用户的 open_id（从消息上下文的 SenderId 获取）

3. 任务清单角色冲突

现象：创建清单（tasklist.create）时传了 members，但返回的 tasklist.members 为空或缺少成员

原因：创建人自动成为清单 owner（所有者），如果 members 中包含创建人，该用户最终成为 owner 并从 members 中移除（同一用户只能有一个角色）