lark-task

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

task (v2)

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

搜索技巧：如果用户的查询只指定了任务名称（例如“完成任务龙虾一号”），请直接使用
+get-my-tasks --query "龙虾一号"
命令搜索（不要带
--complete
参数，这样可以同时搜索未完成和已完成的任务）。 用户身份识别：在用户身份（user identity）场景下，如果用户提到了“我”（例如“分配给我”、“由我创建”），请默认获取当前登录用户的
open_id
作为对应的参数值。 术语理解：如果用户提到 “todo”（待办），应当思考其是否是指“task”（任务），并优先尝试使用本 Skill 提供的命令来处理。 友好输出：在输出任务（或清单）的执行结果给用户时，建议同时提取并输出命令返回结果中的
url
字段（任务链接），以便用户可以直接点击跳转查看详情。

重要提示 — 开始前必须先用 Read 工具读取
../lark-shared/SKILL.md
，其中包含认证、权限处理

搜索技巧：如果用户的查询只指定了任务名称（例如“完成任务龙虾一号”），请直接使用
+get-my-tasks --query "龙虾一号"
命令搜索（不要带
--complete
参数，这样可以同时搜索未完成和已完成的任务）。 用户身份识别：在用户身份（user identity）场景下，如果用户提到了“我”（例如“分配给我”、“由我创建”），请默认获取当前登录用户的
open_id
作为对应的参数值。 术语理解：如果用户提到 “todo”（待办），应当判断其是否指代“task”（任务），并优先尝试使用本 Skill 提供的命令来处理。 友好输出：在输出任务（或清单）的执行结果给用户时，建议同时提取并输出命令返回结果中的
url
字段（任务链接），以便用户可以直接点击跳转查看详情。

Shortcuts

快捷命令

```
+create
```
— Create a task
```
+update
```
— Update a task
```
+comment
```
— Add a comment to a task
```
+complete
```
— Complete a task
```
+reopen
```
— Reopen a task
```
+assign
```
— Assign or remove members from a task
```
+followers
```
— Manage task followers
```
+reminder
```
— Manage task reminders
```
+get-my-tasks
```
— List tasks assigned to me
```
+tasklist-create
```
— Create a tasklist and batch add tasks
```
+tasklist-task-add
```
— Add existing tasks to a tasklist
```
+tasklist-members
```
— Manage tasklist members

```
+create
```
— 创建任务
```
+update
```
— 更新任务
```
+comment
```
— 为任务添加评论
```
+complete
```
— 完成任务
```
+reopen
```
— 重新开启任务
```
+assign
```
— 为任务分配或移除成员
```
+followers
```
— 管理任务关注者
```
+reminder
```
— 管理任务提醒
```
+get-my-tasks
```
— 列出分配给我的任务
```
+tasklist-create
```
— 创建任务清单并批量添加任务
```
+tasklist-task-add
```
— 将现有任务添加到任务清单
```
+tasklist-members
```
— 管理任务清单成员

API Resources

API资源

bash

lark-cli schema task.<resource>.<method>   # 调用 API 前必须先查看参数结构
lark-cli task <resource> <method> [flags] # 调用 API

重要：使用原生 API 时，必须先运行
schema
查看
--data
/
--params
参数结构，不要猜测字段格式。

bash

lark-cli schema task.<resource>.<method>   # 调用API前必须先查看参数结构
lark-cli task <resource> <method> [flags] # 调用API

重要：使用原生API时，必须先运行
schema
查看
--data
/
--params
参数结构，不要猜测字段格式。

tasks

```
create
```
— 创建任务
- ```
delete
```
  — 删除任务
- ```
get
```
  — 获取任务详情
- ```
list
```
  — 列取任务列表
- ```
patch
```
  — 更新任务

```
create
```
— 创建任务
- ```
delete
```
  — 删除任务
- ```
get
```
  — 获取任务详情
- ```
list
```
  — 列取任务列表
- ```
patch
```
  — 更新任务

tasklists

```
add_members
```
— 添加清单成员
- ```
create
```
  — 创建清单
- ```
delete
```
  — 删除清单
- ```
get
```
  — 获取清单详情
- ```
list
```
  — 获取清单列表
- ```
patch
```
  — 更新清单
- ```
remove_members
```
  — 移除清单成员
- ```
tasks
```
  — 获取清单任务列表

```
add_members
```
— 添加清单成员
- ```
create
```
  — 创建清单
- ```
delete
```
  — 删除清单
- ```
get
```
  — 获取清单详情
- ```
list
```
  — 获取清单列表
- ```
patch
```
  — 更新清单
- ```
remove_members
```
  — 移除清单成员
- ```
tasks
```
  — 获取清单任务列表

subtasks

```
create
```
— 创建子任务
- ```
list
```
  — 获取任务的子任务列表

```
create
```
— 创建子任务
- ```
list
```
  — 获取任务的子任务列表

members

```
add
```
— 添加任务成员
- ```
remove
```
  — 移除任务成员

```
add
```
— 添加任务成员
- ```
remove
```
  — 移除任务成员

权限表

方法	所需 scope
`tasks.create`	`task:task:write`
`tasks.delete`	`task:task:write`
`tasks.get`	`task:task:read`
`tasks.list`	`task:task:read`
`tasks.patch`	`task:task:write`
`tasklists.add_members`	`task:tasklist:write`
`tasklists.create`	`task:tasklist:write`
`tasklists.delete`	`task:tasklist:write`
`tasklists.get`	`task:tasklist:read`
`tasklists.list`	`task:tasklist:read`
`tasklists.patch`	`task:tasklist:write`
`tasklists.remove_members`	`task:tasklist:write`
`tasklists.tasks`	`task:tasklist:read`
`subtasks.create`	`task:task:write`
`subtasks.list`	`task:task:read`
`members.add`	`task:task:write`
`members.remove`	`task:task:write`

方法	所需 scope
`tasks.create`	`task:task:write`
`tasks.delete`	`task:task:write`
`tasks.get`	`task:task:read`
`tasks.list`	`task:task:read`
`tasks.patch`	`task:task:write`
`tasklists.add_members`	`task:tasklist:write`
`tasklists.create`	`task:tasklist:write`
`tasklists.delete`	`task:tasklist:write`
`tasklists.get`	`task:tasklist:read`
`tasklists.list`	`task:tasklist:read`
`tasklists.patch`	`task:tasklist:write`
`tasklists.remove_members`	`task:tasklist:write`
`tasklists.tasks`	`task:tasklist:read`
`subtasks.create`	`task:task:write`
`subtasks.list`	`task:task:read`
`members.add`	`task:task:write`
`members.remove`	`task:task:write`