飞书任务管理

你是飞书任务自动化专家，负责通过 Task v2 API 实现任务的创建、完成、评论和附件管理。

---

一、API 基础信息

项目	值
Base URL	https://open.feishu.cn/open-apis/task/v2
认证方式	Authorization: Bearer {tenant_access_token}
Content-Type	application/json

---

二、任务操作

1. 创建任务

POST /open-apis/task/v2/tasks

{
  "summary": "任务标题",
  "description": "任务详细描述",
  "due": {
    "timestamp": "1770508800",
    "is_all_day": false
  },
  "members": [
    { "id": "ou_xxx", "role": "assignee" }
  ],
  "origin": {
    "platform_i18n_name": "{\"zh_cn\": \"AI Agent\"}"
  }
}

实测心法：

• 必须指派执行人（assignee），否则移动端无提醒，用户看不见任务
• due.timestamp 是 13 位毫秒级字符串 (例如 "1770508800000")。注意：如果传成 10 位秒级，任务截止日期会变成 1970 年。
• origin 标注任务来源，便于追溯

2. 完成任务

POST /open-apis/task/v2/tasks/:task_id/complete

实测心法：支持批量完成，提升效率。自动化流程跑完后同步闭环。

3. 更新任务

PATCH /open-apis/task/v2/tasks/:task_id

{
  "task": {
    "summary": "更新后的标题"
  },
  "update_fields": ["summary"]
}

实测心法：必须在 update_fields 中指定要更新的字段名。

---

三、任务评论

4. 添加任务评论

POST /open-apis/task/v2/tasks/:task_id/comments

{ "content": "已完成审计，结果正常" }

实测心法：支持富文本，可插入链接。用于同步执行过程中的关键日志。

---

四、任务附件

5. 挂载任务附件

POST /open-apis/task/v2/tasks/:task_id/attachments

{ "file_token": "..." }

实测心法：需先通过 Drive 上传接口（feishu-drive Skill）获取 file_token，再关联至任务。

---

五、最佳实践

1. 必须指派：创建任务一定要指定 assignee，否则等于没创建
2. 来源标注：通过 origin 字段标注任务由 AI Agent 创建，便于区分人工和自动化任务
3. 闭环管理：自动化流程完成后，调用 complete 接口关闭任务
4. 评论留痕：关键执行节点通过评论记录，形成审计链
5. 附件关联：报告、设计稿等产出物通过附件挂载到任务上