飞书任务管理

🚨 执行前必读

• ✅ 时间格式：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"

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

🎯 核心约束（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 中移除（同一用户只能有一个角色）

建议：不要在 members 中包含创建人，只添加其他协作成员

4. completed_at 的三种用法

1) 完成任务（设置完成时间）：

{
  "action": "patch",
  "task_guid": "xxx",
  "completed_at": "2026-02-26 15:30:00"  // 北京时间字符串
}

2) 反完成（恢复未完成状态）：

{
  "action": "patch",
  "task_guid": "xxx",
  "completed_at": "0"  // 特殊值 "0" 表示反完成
}

3) 毫秒时间戳（不推荐，除非上层已严格生成）：

{
  "completed_at": "1740545400000"  // 毫秒时间戳字符串
}

5. 清单成员的角色

说明：创建清单时，创建者自动成为 owner，无需在 members 中指定。

📌 使用场景示例

场景 1: 创建任务并分配负责人

{
  "action": "create",
  "summary": "准备周会材料",
  "description": "整理本周工作进展和下周计划",
  "current_user_id": "ou_发送者的open_id",
  "due": {
    "timestamp": "2026-02-28 17:00:00",
    "is_all_day": false
  },
  "members": [
    {"id": "ou_协作者的open_id", "role": "assignee"}
  ]
}