lark-task

Name: lark-task
Author: larksuite

380kinstalls1.1kforks

How to install lark-task?

larksuite/cli/lark-task

$npx -y skills add larksuite/cli --skill lark-task

Installs into the current project.

Summary

飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册注销任务智能体、更新智能体主页数据、写入任务记录时使用。

Files · 1

View on GitHub

SKILL.md

1	# task (v2)
2
3	CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理
4
5	> 任务搜索技巧：先区分用户是否特地指定使用搜索 skill，以及是否真的提供了查询关键字（例如任务名称、关键词、片段描述）。如果用户特地指定使用搜索 skill，或明确给出了任务查询关键字，则目标是任务时优先使用 `+search`。如果用户没有特地指定使用搜索 skill，且意图里没有查询关键字，只有范围条件（例如“今年以来”“已完成”“由我创建”“我关注的”），并且使用 `+search` 与 `+get-related-tasks` / `+get-my-tasks` 都能达到目的时，应优先使用列表型能力，而不是搜索型能力。其中，“与我相关 / 我关注的 / 由我创建”等优先考虑 `+get-related-tasks`；“我负责的 / 分配给我”的列表优先考虑 `+get-my-tasks`。不要把时间范围词（例如“今年以来”）本身误当成 `query` 去走搜索。
6	> 任务搜索相关性提示：`+search` 当前不会自动判断搜索结果与搜索发起人的相关性。如果用户明确要求搜索“与我相关”的任务，必须先识别具体关系，获取当前用户的 `open_id`，并显式传入对应的 `--assignee`（负责人）、`--creator`（创建人）或 `--follower`（关注人）过滤条件；不能只依赖 `query` 期待自动返回与当前用户相关的任务。
7	> 任务清单搜索技巧：任务清单也遵循同样的判断逻辑。先区分用户是否特地指定使用搜索 skill，以及是否真的提供了清单查询关键字（例如清单名称、关键词、片段描述）。如果用户特地指定使用搜索 skill，或明确给出了清单查询关键字，则优先使用 `+tasklist-search`。如果用户没有特地指定使用搜索 skill，且意图里没有查询关键字，只有范围条件（例如“由我创建的任务清单”“今年以来创建的清单”），并且使用搜索或原生列取清单都能达到目的时，应优先使用原生 `tasklists.list` 接口列取清单（先 `schema task.tasklists.list`，再 `lark-cli task tasklists list --as user ...`），再按 `creator`、`created_at` 等字段做本地筛选和分页控制。
8	> 意图区分补充：像“搜索飞书中今年以来我关注的任务”这类表达，虽然字面带有“搜索”，但如果没有真正的查询关键字，且本质是在限定“与我相关 + 时间范围”，则应优先走 `+get-related-tasks`；像“搜索飞书中由我创建的任务清单”这类表达，如果没有清单关键字，且本质是在限定“清单范围 + 创建者”，则应优先走原生 `tasklists.list` 后筛选，而不是直接走搜索型 shortcut。
9	> 用户身份识别：在用户身份（user identity）场景下，如果用户提到了“我”（例如“分配给我”、“由我创建”），请默认获取当前登录用户的 `open_id` 作为对应的参数值。
10	> 术语理解 — 待办 disambiguation（必读）：
11	> - 用户提到「待办 / todo / 任务」时，先判断归属，不要默认走本 skill。
12	> - 走 [lark-minutes](../lark-minutes/SKILL.md) 的 `minutes +todo`（禁止本 skill）：上下文含妙记 / 会议纪要 / minute_token / 妙记 URL（`/minutes/`）；或「在某某妙记里新建/修改待办」「妙记 AI 待办」「会议录制里的待办」。
13	> - 走本 skill（lark-task）：任务清单、分配给我、项目待办、截止日期/提醒、子任务、任务清单成员；或 applink 含 `client/todo/task?guid=`；或明确说「飞书任务」「任务中心」「我的任务清单」。
14	> - 禁止：用户要在妙记里加待办时，不要调用 `task tasklists list`、`task +create` 或任何 task 命令去「找清单再放任务」。
15	> 友好输出：在输出任务（或清单）的执行结果给用户时，建议同时提取并输出命令返回结果中的 `url` 字段（任务链接），以便用户可以直接点击跳转查看详情。
16
17	> 创建/更新注意：
18	> 1. 只有在设置了 `due`（截止时间）的情况下，才能设置 `repeat_rule`（重复规则）和 `reminder`（提醒时间）。
19	> 2. 若同时设置了 `start`（开始时间）和 `due`（截止时间），开始时间必须小于或等于截止时间。
20	> 3. 使用 tenant_access_token（应用身份）时，无法跨租户添加任务成员。
21
22	> 查询注意：
23	> 1. 在输出任务详情时，如果需要渲染负责人、创建人等人员字段，除了展示 `id` (例如 open_id) 外，还必须通过其他方式（例如调用通讯录技能）尝试获取并展示这个人的真实名字，以便用户更容易识别。
24	> 2. 在输出清单详情时，如果需要渲染 owner、member、角色成员等人员字段，也必须像任务成员展示一样，除了展示 `id` 外，尽量解析并展示对应人员的真实名字。
25	> 3. 在输出任务或清单详情时，如果需要渲染创建时间、截止时间等字段，需要使用本地时区来渲染（格式为2006-01-02 15:04:05）。
26
27	> Task GUID 定义：
28	> Task OpenAPI 中用于更新/操作任务的 `guid` 是任务的全局唯一标识（GUID），不是客户端展示的任务编号（例如 `t104121` / `suite_entity_num`）。
29	> 对于 Feishu 的任务 applink（例如 `.../client/todo/task?guid=...`），必须使用 URL query 里的 `guid` 参数作为 task guid。
30
31	\| Shortcut \| 说明 \|
32	\|----------\|------\|
33	\| [`+create`](references/lark-task-create.md) \| create a task \|
34	\| [`+update`](references/lark-task-update.md) \| update task attributes \|
35	\| [`+set-ancestor`](references/lark-task-set-ancestor.md) \| set or clear a task ancestor \|
36	\| [`+comment`](references/lark-task-comment.md) \| add a comment to a task \|
37	\| [`+complete`](references/lark-task-complete.md) \| mark a task as complete \|
38	\| [`+reopen`](references/lark-task-reopen.md) \| reopen a completed task \|
39	\| [`+assign`](references/lark-task-assign.md) \| assign or remove task members \|
40	\| [`+followers`](references/lark-task-followers.md) \| manage task followers \|
41	\| [`+reminder`](references/lark-task-reminder.md) \| manage task reminders \|
42	\| [`+get-my-tasks`](references/lark-task-get-my-tasks.md) \| List tasks assigned to me \|
43	\| [`+get-related-tasks`](references/lark-task-get-related-tasks.md) \| list tasks related to me \|
44	\| [`+search`](references/lark-task-search.md) \| search tasks \|
45	\| [`+upload-attachment`](references/lark-task-upload-attachment.md) \| upload a local file as an attachment to a task \|
46	\| [`+tasklist-create`](references/lark-task-tasklist-create.md) \| create a tasklist and optionally add tasks \|
47	\| [`+tasklist-search`](references/lark-task-tasklist-search.md) \| search tasklists \|
48	\| [`+tasklist-task-add`](references/lark-task-tasklist-task-add.md) \| add tasks to a tasklist \|
49	\| [`+tasklist-members`](references/lark-task-tasklist-members.md) \| manage tasklist members \|
50
51	## API Resources
52
53	```bash
54	lark-cli schema task.<resource>.<method> # 调用 API 前必须先查看参数结构
55	lark-cli task <resource> <method> [flags] # 调用 API
56	```
57
58	> 重要：使用原生 API 时，必须先运行 `schema` 查看 `--data` / `--params` 参数结构，不要猜测字段格式。
59
60	### tasks
61
62	- `create` — 创建任务
63	- `delete` — 删除任务
64	- `get` — 获取任务详情
65	- `list` — 列取任务列表
66	- `patch` — 更新任务
67
68	### tasklists
69
70	- `add_members` — 添加清单成员
71	- `create` — 创建清单
72	- `delete` — 删除清单
73	- `get` — 获取清单详情
74	- `list` — 获取清单列表
75	- `patch` — 更新清单
76	- `remove_members` — 移除清单成员
77	- `tasks` — 获取清单任务列表
78
79	### sub

larksuitePublisher · 48 listings

Preview

larksuite/cli

# task (v2)

**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理**

> **任务搜索技巧**：先区分用户是否**特地指定使用搜索 skill**，以及是否真的提供了**查询关键字**（例如任务名称、关键词、片段描述）。如果用户特地指定使用搜索 skill，或明确给出了任务查询关键字，则目标是**任务**时优先使用 `+search`。如果用户没有特地指定使用搜索 skill，且意图里没

> **任务搜索相关性提示**：`+search` 当前不会自动判断搜索结果与搜索发起人的相关性。如果用户明确要求搜索“与我相关”的任务，必须先识别具体关系，获取当前用户的 `open_id`，并显式传入对应的 `--assignee`（负责人）、`--creator`（创建人）或 `--follower`（关注人）过

Repolarksuite/cli

LicenseMIT

TypeSkills

CategoryProductivity

UpdatedJul 2026

Repo stars16k

People who liked this also viewed

6 picks

Type

lark-task

380kinstalls1.1kforks

View on GitHub

How to install lark-task?

larksuite/cli/lark-task

$npx -y skills add larksuite/cli --skill lark-task

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# task (v2)
2
3	CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理
4
5	> 任务搜索技巧：先区分用户是否特地指定使用搜索 skill，以及是否真的提供了查询关键字（例如任务名称、关键词、片段描述）。如果用户特地指定使用搜索 skill，或明确给出了任务查询关键字，则目标是任务时优先使用 `+search`。如果用户没有特地指定使用搜索 skill，且意图里没有查询关键字，只有范围条件（例如“今年以来”“已完成”“由我创建”“我关注的”），并且使用 `+search` 与 `+get-related-tasks` / `+get-my-tasks` 都能达到目的时，应优先使用列表型能力，而不是搜索型能力。其中，“与我相关 / 我关注的 / 由我创建”等优先考虑 `+get-related-tasks`；“我负责的 / 分配给我”的列表优先考虑 `+get-my-tasks`。不要把时间范围词（例如“今年以来”）本身误当成 `query` 去走搜索。
6	> 任务搜索相关性提示：`+search` 当前不会自动判断搜索结果与搜索发起人的相关性。如果用户明确要求搜索“与我相关”的任务，必须先识别具体关系，获取当前用户的 `open_id`，并显式传入对应的 `--assignee`（负责人）、`--creator`（创建人）或 `--follower`（关注人）过滤条件；不能只依赖 `query` 期待自动返回与当前用户相关的任务。
7	> 任务清单搜索技巧：任务清单也遵循同样的判断逻辑。先区分用户是否特地指定使用搜索 skill，以及是否真的提供了清单查询关键字（例如清单名称、关键词、片段描述）。如果用户特地指定使用搜索 skill，或明确给出了清单查询关键字，则优先使用 `+tasklist-search`。如果用户没有特地指定使用搜索 skill，且意图里没有查询关键字，只有范围条件（例如“由我创建的任务清单”“今年以来创建的清单”），并且使用搜索或原生列取清单都能达到目的时，应优先使用原生 `tasklists.list` 接口列取清单（先 `schema task.tasklists.list`，再 `lark-cli task tasklists list --as user ...`），再按 `creator`、`created_at` 等字段做本地筛选和分页控制。
8	> 意图区分补充：像“搜索飞书中今年以来我关注的任务”这类表达，虽然字面带有“搜索”，但如果没有真正的查询关键字，且本质是在限定“与我相关 + 时间范围”，则应优先走 `+get-related-tasks`；像“搜索飞书中由我创建的任务清单”这类表达，如果没有清单关键字，且本质是在限定“清单范围 + 创建者”，则应优先走原生 `tasklists.list` 后筛选，而不是直接走搜索型 shortcut。
9	> 用户身份识别：在用户身份（user identity）场景下，如果用户提到了“我”（例如“分配给我”、“由我创建”），请默认获取当前登录用户的 `open_id` 作为对应的参数值。
10	> 术语理解 — 待办 disambiguation（必读）：
11	> - 用户提到「待办 / todo / 任务」时，先判断归属，不要默认走本 skill。
12	> - 走 [lark-minutes](../lark-minutes/SKILL.md) 的 `minutes +todo`（禁止本 skill）：上下文含妙记 / 会议纪要 / minute_token / 妙记 URL（`/minutes/`）；或「在某某妙记里新建/修改待办」「妙记 AI 待办」「会议录制里的待办」。
13	> - 走本 skill（lark-task）：任务清单、分配给我、项目待办、截止日期/提醒、子任务、任务清单成员；或 applink 含 `client/todo/task?guid=`；或明确说「飞书任务」「任务中心」「我的任务清单」。
14	> - 禁止：用户要在妙记里加待办时，不要调用 `task tasklists list`、`task +create` 或任何 task 命令去「找清单再放任务」。
15	> 友好输出：在输出任务（或清单）的执行结果给用户时，建议同时提取并输出命令返回结果中的 `url` 字段（任务链接），以便用户可以直接点击跳转查看详情。
16
17	> 创建/更新注意：
18	> 1. 只有在设置了 `due`（截止时间）的情况下，才能设置 `repeat_rule`（重复规则）和 `reminder`（提醒时间）。
19	> 2. 若同时设置了 `start`（开始时间）和 `due`（截止时间），开始时间必须小于或等于截止时间。
20	> 3. 使用 tenant_access_token（应用身份）时，无法跨租户添加任务成员。
21
22	> 查询注意：
23	> 1. 在输出任务详情时，如果需要渲染负责人、创建人等人员字段，除了展示 `id` (例如 open_id) 外，还必须通过其他方式（例如调用通讯录技能）尝试获取并展示这个人的真实名字，以便用户更容易识别。
24	> 2. 在输出清单详情时，如果需要渲染 owner、member、角色成员等人员字段，也必须像任务成员展示一样，除了展示 `id` 外，尽量解析并展示对应人员的真实名字。
25	> 3. 在输出任务或清单详情时，如果需要渲染创建时间、截止时间等字段，需要使用本地时区来渲染（格式为2006-01-02 15:04:05）。
26
27	> Task GUID 定义：
28	> Task OpenAPI 中用于更新/操作任务的 `guid` 是任务的全局唯一标识（GUID），不是客户端展示的任务编号（例如 `t104121` / `suite_entity_num`）。
29	> 对于 Feishu 的任务 applink（例如 `.../client/todo/task?guid=...`），必须使用 URL query 里的 `guid` 参数作为 task guid。
30
31	\| Shortcut \| 说明 \|
32	\|----------\|------\|
33	\| [`+create`](references/lark-task-create.md) \| create a task \|
34	\| [`+update`](references/lark-task-update.md) \| update task attributes \|
35	\| [`+set-ancestor`](references/lark-task-set-ancestor.md) \| set or clear a task ancestor \|
36	\| [`+comment`](references/lark-task-comment.md) \| add a comment to a task \|
37	\| [`+complete`](references/lark-task-complete.md) \| mark a task as complete \|
38	\| [`+reopen`](references/lark-task-reopen.md) \| reopen a completed task \|
39	\| [`+assign`](references/lark-task-assign.md) \| assign or remove task members \|
40	\| [`+followers`](references/lark-task-followers.md) \| manage task followers \|
41	\| [`+reminder`](references/lark-task-reminder.md) \| manage task reminders \|
42	\| [`+get-my-tasks`](references/lark-task-get-my-tasks.md) \| List tasks assigned to me \|
43	\| [`+get-related-tasks`](references/lark-task-get-related-tasks.md) \| list tasks related to me \|
44	\| [`+search`](references/lark-task-search.md) \| search tasks \|
45	\| [`+upload-attachment`](references/lark-task-upload-attachment.md) \| upload a local file as an attachment to a task \|
46	\| [`+tasklist-create`](references/lark-task-tasklist-create.md) \| create a tasklist and optionally add tasks \|
47	\| [`+tasklist-search`](references/lark-task-tasklist-search.md) \| search tasklists \|
48	\| [`+tasklist-task-add`](references/lark-task-tasklist-task-add.md) \| add tasks to a tasklist \|
49	\| [`+tasklist-members`](references/lark-task-tasklist-members.md) \| manage tasklist members \|
50
51	## API Resources
52
53	```bash
54	lark-cli schema task.<resource>.<method> # 调用 API 前必须先查看参数结构
55	lark-cli task <resource> <method> [flags] # 调用 API
56	```
57
58	> 重要：使用原生 API 时，必须先运行 `schema` 查看 `--data` / `--params` 参数结构，不要猜测字段格式。
59
60	### tasks
61
62	- `create` — 创建任务
63	- `delete` — 删除任务
64	- `get` — 获取任务详情
65	- `list` — 列取任务列表
66	- `patch` — 更新任务
67
68	### tasklists
69
70	- `add_members` — 添加清单成员
71	- `create` — 创建清单
72	- `delete` — 删除清单
73	- `get` — 获取清单详情
74	- `list` — 获取清单列表
75	- `patch` — 更新清单
76	- `remove_members` — 移除清单成员
77	- `tasks` — 获取清单任务列表
78
79	### sub

larksuitePublisher · 48 listings

Preview

larksuite/cli

# task (v2)

**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理**

Repolarksuite/cli

LicenseMIT

TypeSkills

CategoryProductivity

UpdatedJul 2026

Repo stars16k

People who liked this also viewed

6 picks

Type