task (v2)

CRITICAL, Before starting, you MUST use the Read tool to read ../lark-shared/SKILL.md, which contains information on authentication and permission handling.

Task search tips: First, distinguish whether the user has specifically requested to use the search skill and whether they have actually provided query keywords (such as task names, keywords, or snippet descriptions). If the user specifically requests the search skill or provides explicit task query keywords, prioritize +search when the target is a task. If the user does not specifically request the search skill and there are no query keywords in the intent, but only scope conditions (such as "since this year," "completed," "created by me," or "followed by me"), and both +search and +get-related-tasks / +get-my-tasks can achieve the goal, prioritize list-based capabilities over search-based ones. For "related to me / followed by me / created by me," prioritize +get-related-tasks; for lists of "tasks I am responsible for / assigned to me," prioritize +get-my-tasks. Do not mistake time range terms (such as "since this year") for a query to be used in a search. Tasklist search tips: Tasklists follow the same logic. First, distinguish whether the user has specifically requested to use the search skill and whether they have actually provided list query keywords (such as list names, keywords, or snippet descriptions). If the user specifically requests the search skill or provides explicit list query keywords, prioritize +tasklist-search. If the user does not specifically request the search skill and there are no query keywords in the intent, but only scope conditions (such as "tasklists created by me" or "lists created since this year"), and both search or native list retrieval can achieve the goal, prioritize the native tasklists.list interface (first schema task.tasklists.list, then lark-cli task tasklists list --as user ...), followed by local filtering and pagination control based on fields like creator or created_at. Intent distinction supplement: Expressions like "search for tasks I follow in Feishu since this year," while literally containing "search," should prioritize +get-related-tasks if there are no actual query keywords and the essence is limiting by "related to me + time range." Expressions like "search for tasklists created by me in Feishu," if there are no list keywords and the essence is limiting by "list scope + creator," should prioritize native tasklists.list followed by filtering, rather than a direct search-based shortcut. User identification: In user identity scenarios, if the user mentions "me" (e.g., "assigned to me," "created by me"), please default to retrieving the open_id of the currently logged-in user as the corresponding parameter value. Terminology understanding: If the user mentions "todo," consider whether they mean "task" and prioritize using the commands provided by this Skill to handle it. Friendly output: When outputting task (or list) execution results to the user, it is recommended to extract and output the url field (task link) from the command return results so the user can click to view details directly.

Creation/Update notes:

1. repeat_rule (repeat rule) and reminder (reminder time) can only be set if due (due time) is set.
2. If both start (start time) and due (due time) are set, the start time must be less than or equal to the due time.
3. When using tenant_access_token (app identity), you cannot add task members across tenants.

Query notes:

1. When outputting task details, if you need to render fields like assignee or creator, in addition to displaying the id (e.g., open_id), you must attempt to retrieve and display the person's real name through other means (e.g., calling the address book skill) to make it easier for the user to identify them.
2. When outputting list details, if you need to render fields like owner, member, or role members, you must also attempt to resolve and display the corresponding person's real name in addition to the id, just like with task members.
3. When outputting task or list details, if you need to render fields like creation time or due time, you must use the local time zone for rendering (format: 2006-01-02 15:04:05).

Task GUID definition: The guid used in the Task OpenAPI for updating/operating tasks is the global unique identifier (GUID) of the task, not the task number displayed on the client (e.g., t104121 / suite_entity_num). For Feishu task applinks (e.g., .../client/todo/task?guid=...), you must use the guid parameter from the URL query as the task guid.

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
• +get-related-tasks, List tasks related to me
• +search, Search tasks
• +subscribe-event, Subscribe to task events
• +set-ancestor, Set or clear a task ancestor
• +tasklist-create, Create a tasklist and batch add tasks
• +tasklist-search, Search tasklists
• +tasklist-task-add, Add existing tasks to a tasklist
• +tasklist-members, Manage tasklist members
• +upload-attachment, Upload a file as a task attachment

API Resources

lark-cli schema task.<resource>.<method>   # Must check parameter structure before calling API
lark-cli task <resource> <method> [flags] # Call API

Important: When using native APIs, you must first run schema to view the --data / --params parameter structure; do not guess the field format.

tasks

• create, Create task
• delete, Delete task
• get, Get task details
• list, List tasks
• patch, Update task

tasklists

• add_members, Add list members
• create, Create list
• delete, Delete list
• get, Get list details
• list, Get list of lists
• patch, Update list
• remove_members, Remove list members
• tasks, Get list of tasks in a list

subtasks

• create, Create subtask
• list, Get list of subtasks for a task

members

• add, Add task member
• remove, Remove task member

sections

• create, Create custom section
• delete, Delete custom section
• get, Get custom section details
• list, Get list of custom sections
• patch, Update custom section
• tasks, Get list of tasks in a custom section

custom_fields

• create, Create custom field
• get, Get custom field details
• patch, Update custom field
• list, Get list of custom fields
• add, Add custom field to resource
• remove, Remove custom field from resource

custom_field_options

• create, Create custom field option
• patch, Update custom field option

agent

• update_agent_profile, Update task agent profile data.
• register_agent, Register AI agent

agent_task_step_info

• append_task_steps, Write task record.

Permissions Table