mcpField
F
feishu-task

feishu-task

github.com/m1heng生产力4.2k175 次安装30 周前更新
代码仓库

关于 feishu-task

feishu-task 是用于管理 Feishu 任务的 skill，可创建和维护任务、评论、附件及任务清单。它还支持管理清单成员与角色，并说明任务可见性和机器人所有权注意事项。

主要功能

  1. 01创建、更新和删除任务
  2. 02创建子任务并管理评论
  3. 03上传和管理附件
  4. 04创建和管理任务清单
  5. 05管理清单成员及角色

适用场景

  1. 01跟踪带截止日期的分配任务
  2. 02将机器人创建的任务拆分为子任务
  3. 03通过评论讨论任务
  4. 04在共享任务清单中整理任务

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/m1heng/clawdbot-feishu --skill feishu-task

安装后在 Claude Code 中输入/feishu-task确认已加载。

详细介绍

飞书任务工具

工具：

  • feishu_task_create
  • feishu_task_subtask_create
  • feishu_task_get
  • feishu_task_update
  • feishu_task_delete
  • feishu_task_comment_create
  • feishu_task_comment_list
  • feishu_task_comment_get
  • feishu_task_comment_update
  • feishu_task_comment_delete
  • feishu_task_attachment_upload
  • feishu_task_attachment_list
  • feishu_task_attachment_get
  • feishu_task_attachment_delete
  • feishu_task_add_tasklist
  • feishu_task_remove_tasklist
  • feishu_tasklist_create
  • feishu_tasklist_get
  • feishu_tasklist_list
  • feishu_tasklist_update
  • feishu_tasklist_delete
  • feishu_tasklist_add_members
  • feishu_tasklist_remove_members

说明

  • task_guid 可从任务 URL（guid 查询参数）或 feishu_task_get 的输出中获取。
  • comment_id 可从 feishu_task_comment_list 的输出中获取。
  • attachment_guid 可从 feishu_task_attachment_list 的输出中获取。
  • user_id_type 用于控制返回或接受的用户身份类型（open_id、user_id、union_id）。
  • 如果未指定负责人，请将任务分配给发起请求的用户。避免创建未分配任务，因为用户可能无法查看这些任务。
  • 任务可见性：用户只有在被设为负责人时才能查看任务。
  • 当前限制：机器人只能为自己创建的任务创建子任务。
  • 附件上传支持本地 file_path 和远程 file_url。远程 URL 会经过运行时媒体安全检查，并受大小限制（mediaMaxMb）。
  • 请将任务清单所有者保留为机器人。将用户添加为成员，以免机器人失去访问权限。
  • 使用任务清单工具更改任务清单成员资格；不要使用 feishu_task_update 将任务移至其他任务清单。

创建任务

{
  "summary": "Quarterly review",
  "description": "Prepare review notes",
  "due": { "timestamp": "1735689600000", "is_all_day": true },
  "members": [
    { "id": "ou_xxx", "role": "assignee", "type": "user" }
  ],
  "user_id_type": "open_id"
}

创建子任务

{
  "task_guid": "e297ddff-06ca-4166-b917-4ce57cd3a7a0",
  "summary": "Draft report outline",
  "description": "Collect key metrics",
  "due": { "timestamp": "1735689600000", "is_all_day": true },
  "members": [
    { "id": "ou_xxx", "role": "assignee", "type": "user" }
  ],
  "user_id_type": "open_id"
}

创建评论

{
  "task_guid": "e297ddff-06ca-4166-b917-4ce57cd3a7a0",
  "content": "Looks good to me",
  "user_id_type": "open_id"
}

上传附件（file_path）

{
  "task_guid": "e297ddff-06ca-4166-b917-4ce57cd3a7a0",
  "file_path": "/path/to/report.pdf",
  "user_id_type": "open_id"
}

上传附件（file_url）

{
  "task_guid": "e297ddff-06ca-4166-b917-4ce57cd3a7a0",
  "file_url": "https://oss-example.com/bucket/report.pdf",
  "filename": "report.pdf",
  "user_id_type": "open_id"
}

任务的任务清单成员资格

将任务添加到任务清单
{
  "task_guid": "e297ddff-06ca-4166-b917-4ce57cd3a7a0",
  "tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004",
  "section_guid": "6d0f9f48-2e06-4e3d-8a0f-acde196e8c61",
  "user_id_type": "open_id"
}
从任务清单中移除任务
{
  "task_guid": "e297ddff-06ca-4166-b917-4ce57cd3a7a0",
  "tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004",
  "user_id_type": "open_id"
}

任务清单

任务清单支持三种角色：所有者（读取／编辑／管理）、编辑者（读取／编辑）、查看者（读取）。

创建任务清单
{
  "name": "Project Alpha Tasklist",
  "members": [
    { "id": "ou_xxx", "type": "user", "role": "editor" }
  ],
  "user_id_type": "open_id"
}
获取任务清单
{
  "tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004",
  "user_id_type": "open_id"
}
列出任务清单
{
  "page_size": 50,
  "page_token": "aWQ9NzEwMjMzMjMxMDE=",
  "user_id_type": "open_id"
}
更新任务清单
{
  "tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004",
  "tasklist": {
    "name": "Renamed Tasklist",
    "owner": { "id": "ou_xxx", "type": "user", "role": "owner" }
  },
  "update_fields": ["name", "owner"],
  "origin_owner_to_role": "editor",
  "user_id_type": "open_id"
}
删除任务清单
{
  "tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004"
}
添加任务清单成员
{
  "tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004",
  "members": [
    { "id": "ou_xxx", "type": "user", "role": "editor" }
  ],
  "user_id_type": "open_id"
}
移除任务清单成员
{
  "tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004",
  "members": [
    { "id": "ou_xxx", "type": "user", "role": "viewer" }
  ],
  "user_id_type": "open_id"
}

评论

支持 Markdown