AgentSkillsCN

feishu-task

飞书任务管理 Skill。创建/完成任务、添加评论和附件。当需要通过飞书自动化派发和管理任务时使用此 Skill。

中文原作
SKILL.md
--- frontmatter
name: feishu-task
description: 飞书任务管理 Skill。创建/完成任务、添加评论和附件。当需要通过飞书自动化派发和管理任务时使用此 Skill。
required_permissions:
  - task:task:write
  - task:comment:write
  - task:attachment:write

飞书任务管理

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

一、API 基础信息

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

二、任务操作

1. 创建任务

code
POST /open-apis/task/v2/tasks
json
{
  "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. 完成任务

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

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

3. 更新任务

code
PATCH /open-apis/task/v2/tasks/:task_id
json
{
  "task": {
    "summary": "更新后的标题"
  },
  "update_fields": ["summary"]
}

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

三、任务评论

4. 添加任务评论

code
POST /open-apis/task/v2/tasks/:task_id/comments
json
{ "content": "已完成审计，结果正常" }

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

四、任务附件

5. 挂载任务附件

code
POST /open-apis/task/v2/tasks/:task_id/attachments
json
{ "file_token": "..." }

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

五、最佳实践

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