feishu-task

Q: What does the feishu-task skill do?

飞书任务管理工具,用于创建、查询、更新任务和清单。 当以下情况时使用此 Skill: (1) 需要创建、查询、更新任务 (2) 需要创建、管理任务清单 (3) 需要查看任务列表或清单内的任务 (4) 用户提到"任务"、"待办"、"to-do"、"清单"、"task" (5) 需要设置任务负责人、关注人、截止时间、添加成员 (6) 需要追加任务步骤记录（Task 的 steps） (7) 需要上传任务附件（支持 task / taskdelivery） (8) 需要注册 Agent / 更新 Agent 信息（register / updateprofile）

Q: How do I install feishu-task?

Run npx skills add https://github.com/larksuite/openclaw-lark --skill feishu-task in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/feishu-task/ (personal) or .claude/skills/feishu-task/ (project).

by larksuiteProductivity & Automation

飞书任务管理工具,用于创建、查询、更新任务和清单。当以下情况时使用此 Skill: (1) 需要创建、查询、更新任务 (2) 需要创建、管理任务清单 (3) 需要查看任务列表或清单内的任务 (4) 用户提到"任务"、"待办"、"to-do"、"清单"、"task" (5) 需要设置任务负责人、关注人、截止时间、添加成员 (6) 需要追加任务步骤记录（Task 的 steps） (7) 需要上传任务附件（支持 task / taskdelivery） (8) 需要注册 Agent / 更新 Agent 信息（register / updateprofile）

Installs: 159
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/larksuite/openclaw-lark --skill feishu-task

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads feishu-task automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

飞书任务管理

🚨 执行前必读

✅ 时间格式：ISO 8601 / RFC 3339（带时区），例如 2026-02-28T17:00:00+08:00
✅ 身份授权：工具支持 auth_type 为 user（默认，用户身份）或 tenant（应用身份）。
✅ 任务 Agent（feishu_task_agent）：仅支持应用身份（tenant），不支持 user 身份
✅ 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"
✅ append_steps 的 task_steps[].timestamp：秒级 Unix 时间戳（10 位），不要用毫秒（13 位）

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

用户意图	工具	action	必填参数	强烈建议	常用可选
新建待办	feishu_task_task	create	summary	current_user_id（SenderId）	members, due, description, auth_type
查未完成任务	feishu_task_task	list	-	completed=false	page_size, auth_type, agent_task_status
获取任务详情	feishu_task_task	get	task_guid	-	auth_type
完成任务	feishu_task_task	patch	task_guid, completed_at	-	auth_type
反完成任务	feishu_task_task	patch	task_guid, completed_at="0"	-	auth_type
改截止时间	feishu_task_task	patch	task_guid, due	-	auth_type
添加任务成员	feishu_task_task	add_members	task_guid, members[]	-	auth_type
追加任务步骤记录	feishu_task_task	append_steps	task_guid, idempotent_key, task_steps[]	task_steps[].timestamp 用秒级（10 位）	-
创建清单	feishu_task_tasklist	create	name	-	members
查看清单任务	feishu_task_tasklist	tasks	tasklist_guid	-	completed
添加清单成员	feishu_task_tasklist	add_members	tasklist_guid, members[]	-	-
上传任务附件	feishu_task_attachment	upload	resource_id, file(base64)	name	resource_type
注册任务 Agent	feishu_task_agent	register	-	仅支持 tenant（应用身份）	-
更新任务 Agent Profile	feishu_task_agent	update_profile	profile_content	仅支持 tenant（应用身份）	-

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

1. 授权身份与可见性 (auth_type)

工具支持两种调用身份 auth_type：

user (默认)：用户身份（user_access_token）。用于需要严格代表用户操作或查询用户私有任务的场景。
- ⚠️ 使用 user 身份时，只能查看和编辑自己是成员的任务。
- ⚠️ 如果创建时没把自己加入成员，后续无法编辑该任务。
tenant：应用身份（tenant_access_token）。当用户身份不满足要求时，使用应用身份。如果创建的任务没有把用户加入成员，用户可能看不见。

自动保护机制：

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

2. 任务成员的角色与类型

角色 (role)：
- assignee（负责人）：负责完成任务，可以编辑任务
- follower（关注人）：关注任务进展，接收通知
类型 (type)：
- user（默认，用户）：普通的飞书用户
- app（应用/机器人）：如果是把机器人自己或者其他应用加入任务，必须指定 type: "app"

添加成员示例：

{
  "members": [
    {"id": "ou_xxx", "role": "assignee", "type": "user"},  // 负责人（用户）
    {"id": "cli_yyy", "role": "follower", "type": "app"}   // 关注人（机器人/应用）
  ]
}

说明：id 默认使用 open_id。

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. 清单成员的角色

成员类型	角色	说明
user（用户）	owner	所有者，可转让所有权
user（用户）	editor	可编辑，可修改清单和任务
user（用户）	viewer	可查看，只读权限
chat（群组）	editor/viewer	整个群组获得权限

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

📌 使用场景示例

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

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

说明：

summary 是必填字段
current_user_id 强烈建议传入（从 SenderId 获取），工具会自动添加为 follower
members 可以只包含其他协作者，当前用户会被自动添加
时间使用带时区的 ISO 8601 格式

场景 2: 查询我负责的未完成任务

{
  "action": "list",
  "completed": false,
  "page_size": 20,
  "auth_type": "user"
}

场景 3: 为现有任务添加机器人或成员

{
  "action": "add_members",
  "task_guid": "任务的guid",
  "auth_type": "tenant",
  "members": [
    {"id": "cli_机器人的app_id", "role": "follower", "type": "app"}
  ]
}

场景 4: 完成任务

{
  "action": "patch",
  "task_guid": "任务的guid",
  "completed_at": "2026-02-26 15:30:00"
}

场景 5: 反完成任务（恢复未完成状态）

{
  "action": "patch",
  "task_guid": "任务的guid",
  "completed_at": "0"
}

场景 6: 创建清单并添加协作者

{
  "action": "create",
  "name": "产品迭代 v2.0",
  "members": [
    {"id": "ou_xxx", "role": "editor"},
    {"id": "ou_yyy", "role": "viewer"}
  ]
}

场景 7: 查看清单内的未完成任务

{
  "action": "tasks",
  "tasklist_guid": "清单的guid",
  "completed": false
}

场景 8: 全天任务

{
  "action": "create",
  "summary": "年度总结",
  "due": {
    "timestamp": "2026-03-01 00:00:00",
    "is_all_day": true
  }
}

场景 9: 注册任务 Agent（仅应用身份）

{
  "action": "register",
  "auth_type": "tenant"
}

场景 10: 更新任务 Agent Profile（仅应用身份）

{
  "action": "update_profile",
  "auth_type": "tenant",
  "profile_content": "some profile content"
}

🔍 常见错误与排查

错误现象	根本原因	解决方案
创建后无法编辑任务	创建时未将自己加入 members	创建时至少将当前用户（SenderId）加为 assignee 或 follower
patch 失败提示 task_guid 缺失	未传 task_guid 参数	patch/get/add_members 必须传 task_guid
tasks 失败提示 tasklist_guid 缺失	未传 tasklist_guid 参数	tasklist.tasks action 必须传 tasklist_guid
反完成失败	completed_at 格式错误	使用 `"0"` 字符串，不是数字 0
时间不对	使用了 Unix 时间戳	改用 ISO 8601 格式（带时区）：`2024-01-01T00:00:00+08:00`
添加机器人失败	未指定成员 type 为 app	将机器人的 type 指定为 `"app"`

📚 附录：背景知识

A. 资源关系

任务清单（Tasklist）
  └─ 自定义分组（Section，可选）
      └─ 任务（Task）
          ├─ 成员：负责人（assignee）、关注人（follower）
          ├─ 子任务（Subtask）
          ├─ 截止时间（due）、开始时间（start）
          └─ 附件、评论

核心概念：

任务（Task）：独立的待办事项，有唯一的 task_guid
清单（Tasklist）：组织多个任务的容器，有唯一的 tasklist_guid
负责人（assignee）：可以编辑任务并标记完成
关注人（follower）：接收任务更新通知
我负责的（MyTasks）：所有负责人为自己的任务集合

B. 如何获取 GUID

task_guid：创建任务后从返回值的 task.guid 获取，或通过 list 查询
tasklist_guid：创建清单后从返回值的 tasklist.guid 获取，或通过 list 查询

C. 如何将任务加入清单

创建任务时指定 tasklists 参数：

{
  "action": "create",
  "summary": "任务标题",
  "tasklists": [
    {
      "tasklist_guid": "清单的guid",
      "section_guid": "分组的guid（可选）"
    }
  ]
}

D. 重复任务如何创建

使用 repeat_rule 参数，采用 RRULE 格式：

{
  "action": "create",
  "summary": "每周例会",
  "due": {"timestamp": "2026-03-03 14:00:00", "is_all_day": false},
  "repeat_rule": "FREQ=WEEKLY;INTERVAL=1;BYDAY=MO"
}

说明：只有设置了截止时间的任务才能设置重复规则。

E. 数据权限

只能操作自己有权限的任务（作为成员的任务）
只能操作自己有权限的清单（作为成员的清单）
将任务加入清单需要同时拥有任务和清单的编辑权限

FAQ

What does the feishu-task skill do?

How do I install feishu-task?

Run npx skills add https://github.com/larksuite/openclaw-lark --skill feishu-task in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/feishu-task/ (personal) or .claude/skills/feishu-task/ (project).

Which AI agents can use feishu-task?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is feishu-task safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains feishu-task?

It is published by larksuite in larksuite/openclaw-lark. It has 159 recorded installs.

More from larksuite/openclaw-lark

View all →

feishu-bitable

larksuite/openclaw-lark

飞书多维表格（Bitable）的创建、查询、编辑和管理工具。包含 27 种字段类型支持、高级筛选、批量操作和视图管理。当以下情况时使用此 Skill： (1) 需要创建或管理飞书多维表格 App (2) 需要在多维表格中新增、查询、修改、删除记录（行数据） (3) 需要管理字段（列）、视图、数据表 (4) 用户提到"多维表格"、"bitable"、"数据表"、"记录"、"字段" (5) 需要批量导入数据或批量更新多维表格

Productivity & Automation580 installs

feishu-create-doc

larksuite/openclaw-lark

创建飞书云文档。从 Lark-flavored Markdown 内容创建新的飞书云文档，支持指定创建位置（文件夹/知识库/知识空间）。

Productivity & Automation362 installs

feishu-im-read

larksuite/openclaw-lark

Open the skill to read its SKILL.md instructions.

Productivity & Automation283 installs

feishu-calendar

larksuite/openclaw-lark

Open the skill to read its SKILL.md instructions.

Productivity & Automation251 installs

feishu-fetch-doc

larksuite/openclaw-lark

Open the skill to read its SKILL.md instructions.

Productivity & Automation227 installs

feishu-update-doc

larksuite/openclaw-lark

更新飞书云文档。支持 7 种更新模式：追加、覆盖、定位替换、全文替换、前/后插入、删除。

Productivity & Automation189 installs

Popular productivity & automation skills

View category →

agent-browser

vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

OfficialProductivity & Automation1.3M installs

lark-doc

open.feishu.cn

飞书云文档（Docx / Wiki）内容操作：读取、创建、编辑文档，插入或下载图片附件，以及操作思维笔记。用户提供文档 URL/token（包括 doubao.com 的 /docx/、/wiki/）时使用；按 URL 路径/token 而非域名路由；/page/ 是妙搭应用，非飞书云文档。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive；随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。

Productivity & Automation815.7K installs

lark-base

open.feishu.cn

飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式（BaseApp/AppMode 页面与组件）、Workspace 目录、workflow、角色权限、模板中心（多维表格模板分类/列表/搜索）；遇到 Base/多维表格/bitable、BaseApp/AppMode、/base/ 或 /app/ 链接时使用。BaseApp 不走 lark-apps；文件导入/导出转 lark-drive，认证/授权转 lark-shared。

Productivity & Automation815K installs

lark-drive

open.feishu.cn

飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用；doubao.com 云空间 URL/token 也按资源路径和 token 路由，不回退 WebFetch。不负责：文档内容编辑（走 lark-doc）、表格/Base 表内数据操作（走 lark-sheets/lark-base）、知识空间节点/成员管理（走 lark-wiki）、原生 Markdown 文件读写/patch/diff（走 lark-markdown）。

Productivity & Automation815K installs

lark-shared

open.feishu.cn

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling notice JSON.

Productivity & Automation814.8K installs

lark-im

open.feishu.cn

飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive Card）、监听卡片按钮回调（card.action.trigger）。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶（添加/移除/查询置顶会话）、管理标签数据、处理卡片回调时使用。

Productivity & Automation814.1K installs

feishu-task

Install

Install

Describe the task

Review the result

SKILL.md

飞书任务管理

🚨 执行前必读

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

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

1. 授权身份与可见性 (auth_type)

2. 任务成员的角色与类型

3. 任务清单角色冲突

4. completed_at 的三种用法

5. 清单成员的角色

📌 使用场景示例

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

场景 2: 查询我负责的未完成任务

场景 3: 为现有任务添加机器人或成员

场景 4: 完成任务

场景 5: 反完成任务（恢复未完成状态）

场景 6: 创建清单并添加协作者

场景 7: 查看清单内的未完成任务

场景 8: 全天任务

场景 9: 注册任务 Agent（仅应用身份）

场景 10: 更新任务 Agent Profile（仅应用身份）

🔍 常见错误与排查

📚 附录：背景知识

A. 资源关系

B. 如何获取 GUID

C. 如何将任务加入清单

D. 重复任务如何创建

E. 数据权限

FAQ

More from larksuite/openclaw-lark

Popular productivity & automation skills