Lark Task

task (v2)

CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../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

API Resources

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

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

tasks

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

tasklists

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

subtasks

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

members

• add — 添加任务成员
• remove — 移除任务成员

权限表

task +assign

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules.

Assign or remove members (assignees) from a task.

Recommended Commands

# Add an assignee
lark-cli task +assign --task-id "t_xxx" --add "ou_aaa"

# Transfer an assignee (remove old, add new)
lark-cli task +assign --task-id "t_xxx" --remove "ou_old" --add "ou_new"

# Add multiple assignees
lark-cli task +assign --task-id "t_xxx" --add "ou_aaa,ou_bbb"

Parameters

Workflow

1. Confirm the task and members to add/remove. 2. Execute the command. 3. Report success and the new count of assignees.

[!CAUTION]

This is a Write Operation -- You must confirm the user's intent before executing.

EOF~

task +comment

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules.

Add a comment to an existing task.

Recommended Commands

# Add a comment
lark-cli task +comment --task-id "t_xxx" --content "Looks good!"

Parameters

Workflow

1. Confirm the task and comment content. 2. Execute lark-cli task +comment --task-id "..." --content "..." 3. Report success and comment ID.

[!CAUTION]

This is a Write Operation -- You must confirm the user's intent before executing.

task +complete

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules.

Mark a task as completed.

Recommended Commands

# Complete a task
lark-cli task +complete --task-id "t_xxx"

Parameters

Workflow

1. Confirm the task to complete. 2. Execute the command. 3. Report success.

[!CAUTION]

This is a Write Operation -- You must confirm the user's intent before executing.

task +create

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules.

Create a new task in Lark.

Recommended Commands

# Create a task with all details
lark-cli task +create \
  --summary "Quarterly Sales Review" \
  --description "Review the sales performance for the last quarter." \
  --assignee "ou_xxx" \
  --due "2026-03-25" \
  --tasklist-id "https://applink.larkoffice.com/client/todo/task_list?guid=a4b00000-000-000-000-00000000036c"

# Create a simple task
lark-cli task +create \
  --summary "Buy milk"

# Preview the API call without executing
lark-cli task +create --summary "Test Task" --dry-run

Parameters

Workflow

1. Confirm with the user: task summary, due date, assignee, and tasklist if necessary.

• Crucial Rule for Assignee: If the user explicitly or implicitly says "create a task for me" (给我创建一个任务), or "help me create a task" (帮我新建/创建一个任务), you MUST assign the task to the current logged-in user. You can get the current user's open_id by executing lark-cli auth status --json or lark-cli contact +get-user first, extracting the userOpenId or open_id, and then passing it to the --assignee parameter.

2. Execute lark-cli task +create --summary "..." ... 3. Report the result: task ID and summary.

[!CAUTION]

This is a Write Operation -- You must confirm the user's intent before executing.

References

• lark-task -- All task commands
• lark-shared -- Authentication and global parameters

task +followers

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules.

Manage task followers. Add or remove followers from an existing task.

Recommended Commands

# Add a follower
lark-cli task +followers --task-id "t_xxx" --add "ou_aaa"

# Remove a follower
lark-cli task +followers --task-id "t_xxx" --remove "ou_aaa"

Parameters

Workflow

1. Confirm the task and followers to add/remove. 2. Execute the command. 3. Report success.

[!CAUTION]

This is a Write Operation -- You must confirm the user's intent before executing.

task +get-my-tasks

If the user query only specifies a task name (e.g., "Complete task Lobster No. 1"), use this command to list and search for the task by its summary.

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules.

>

⚠️ Note: This API must be called with a user identity. Do NOT use an app identity, otherwise the call will fail.

List tasks assigned to the current user, with support for filtering by completion status, creation time, and due date. By default, the command will automatically paginate up to 20 times. Use --page-all to fetch more (up to 40 pages).

Recommended Commands

# Search for a specific task by name
lark-cli task +get-my-tasks --query "Lobster No. 1"

# Get my incomplete tasks (fetches up to 20 pages by default)
lark-cli task +get-my-tasks

# Fetch all tasks (up to 40 pages)
lark-cli task +get-my-tasks --page-all

# Fetch up to 10 pages
lark-cli task +get-my-tasks --page-limit 10

Parameters

Workflow

1. Determine the filters based on the user's request. 2. Execute the command. The CLI will automatically loop up to the specified limit (default 20, or 40 with --page-all) to fetch records. 3. Show the results (ID, summary, due time, and created date).

task +reminder

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules.

Priority: For creating or modifying task reminder times, prioritize using this +reminder shortcut over other task update methods. It provides a more reliable and direct way to manage reminders.

Manage task reminders. Set new reminders or remove existing ones.

Recommended Commands

# Set a reminder (e.g., 30 minutes before due)
lark-cli task +reminder --task-id "t_xxx" --set "30"

# Set a reminder (e.g., 1 hour before due)
lark-cli task +reminder --task-id "t_xxx" --set "1h"

# Remove all reminders
lark-cli task +reminder --task-id "t_xxx" --remove "true"

Parameters

Workflow

1. Confirm the task and reminder action. 2. Execute the command. 3. Report success.

[!CAUTION]

This is a Write Operation -- You must confirm the user's intent before executing.

task +reopen

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules.

Reopen a previously completed task.

Recommended Commands

# Reopen a task
lark-cli task +reopen --task-id "t_xxx"

Parameters

Workflow

1. Confirm the task to reopen. 2. Execute the command. 3. Report success.

[!CAUTION]

This is a Write Operation -- You must confirm the user's intent before executing.

task +tasklist-create

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules.

Create a new tasklist, and optionally batch create tasks within it.

Recommended Commands

# Create an empty tasklist
lark-cli task +tasklist-create --name "Q1 Goals"

# Create a tasklist and add members
lark-cli task +tasklist-create --name "Project A" --member "ou_xxx,ou_yyy"

# Create a tasklist and batch create tasks within it
lark-cli task +tasklist-create --name "Launch Checklist" --data '[{"summary": "Code Review", "assignee": "ou_aaa"}, {"summary": "Deploy", "assignee": "ou_bbb"}]'

Parameters

Workflow

1. Confirm the tasklist name, members, and tasks (if any). 2. Execute the command lark-cli task +tasklist-create .... 3. Report success, including the new tasklist ID and the result of the batch task creation.

[!CAUTION]

This is a Write Operation -- You must confirm the user's intent before executing.

task +tasklist-members

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules.

Manage tasklist members (editors/owners).

Recommended Commands

# Add a member
lark-cli task +tasklist-members --tasklist-id "tl_xxx" --add "ou_aaa"

# Remove a member
lark-cli task +tasklist-members --tasklist-id "tl_xxx" --remove "ou_aaa"

# Replace all members exactly
lark-cli task +tasklist-members --tasklist-id "tl_xxx" --set "ou_aaa,ou_bbb"

Parameters

Workflow

1. Confirm the tasklist and members to add/remove/set. 2. Execute the command. 3. Report success.

[!CAUTION]

This is a Write Operation -- You must confirm the user's intent before executing.

task +tasklist-task-add

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules.

Add existing tasks to a tasklist.

Recommended Commands

# Add a single task to a tasklist
lark-cli task +tasklist-task-add --tasklist-id "tl_xxx" --task-id "t_aaa"

# Add multiple tasks to a tasklist
lark-cli task +tasklist-task-add --tasklist-id "tl_xxx" --task-id "t_aaa,t_bbb,t_ccc"

Parameters

Workflow

1. Confirm the tasklist and the tasks to add. 2. Execute the command lark-cli task +tasklist-task-add .... 3. Report the result (successful vs failed tasks).

[!CAUTION]

This is a Write Operation -- You must confirm the user's intent before executing.

task +update

Prerequisites: Please read ../lark-shared/SKILL.md to understand authentication, global parameters, and security rules.

Update an existing task in Lark.

Recommended Commands

# Update task summary
lark-cli task +update --task-id "t_xxx" --summary "New Summary"

# Update multiple tasks' due dates
lark-cli task +update --task-id "t_xxx,t_yyy" --due "+2d"

# Update with JSON data
lark-cli task +update --task-id "t_xxx" --data '{"description": "New description"}'

Parameters

Workflow

1. Confirm with the user the tasks to update and the fields. 2. Execute lark-cli task +update --task-id "..." ... 3. Report the successful updates.

[!CAUTION]

This is a Write Operation -- You must confirm the user's intent before executing.