wecomcli-get-todo-detail

Original：🇨🇳 Chinese

Translated

Skill for batch querying WeCom to-do details, which obtains complete information (including to-do content and assignees) based on the to-do ID list. It is used in scenarios where users need to view the full content of to-dos, such as when users say "Check the details of this to-do", "What is the content of this to-do", "Who is this to-do assigned to", "Tell me the specific information of the to-do", etc. It is usually used in conjunction with wecomcli-get-todo-list -- first obtain the to-do ID list, and then use this skill to get the details.

940installs

Sourcewecomteam/wecom-cli

Added on2026-03-30

NPX Install

npx skill4agent add wecomteam/wecom-cli wecomcli-get-todo-detail

SKILL.md Content (Chinese)

View Translation Comparison →

WeCom To-Do Detail Query Skill

wecom-cli
is the official command line program provided by WeCom, all operations are completed by executing
wecom-cli
commands.

Batch query complete to-do details by

wecom-cli

based on the to-do ID list, including to-do content and assignee information.

Behavior Strategy

Convert personnel ID to name (key step): The

follower_id

and

creator_id

in the returned results are internal system IDs, which are meaningless to display directly to users -- users do not recognize these IDs, only names. Therefore, before displaying the to-do details to users, you must first call the

wecomcli-lookup-contact

skill to obtain the address book, and match all

follower_id

and

creator_id

to real names. The specific method is as follows:

bash

wecom-cli contact get_userlist '{}'

If an ID cannot be found in the address book, mark it as "Unknown user (ID: xxx)" when displaying.

Retry strategy: When encountering "return HTTP error" or "HTTP request failure", actively retry, up to three times.

Calling Method

bash

wecom-cli todo get_todo_detail '<JSON format input parameter>'

Parameter Description

Parameter	Type	Required	Description
`todo_id_list`	array	✅	To-do ID list, maximum 20 entries

Call example:

bash

wecom-cli todo get_todo_detail '{"todo_id_list": ["TODO_ID_1", "TODO_ID_2"]}'

Return Format

json

{
    "errcode": 0,
    "errmsg": "ok",
    "data_list": [
        {
            "todo_id": "TODO_ID",
            "todo_status": 1,
            "content": "Complete Q2 planning document",
            "follower_list": {
                "followers": [
                    {
                        "follower_id": "FOLLOWER_ID",
                        "follower_status": 1,
                        "update_time": "2025-01-16 14:20:00"
                    }
                ]
            },
            "creator_id": "CREATOR_ID",
            "user_status": 1,
            "remind_time": "2025-06-01 09:00:00",
            "create_time": "2025-01-15 10:30:00",
            "update_time": "2025-01-16 14:20:00"
        }
    ]
}

Return Field Description

Field	Type	Description
`data_list`	array	To-do detail list, maximum 20 entries
`data_list[].todo_id`	string	To-do ID
`data_list[].todo_status`	number	To-do status: `0` -Completed, `1` -In progress, `2` -Deleted
`data_list[].content`	string	To-do content
`data_list[].follower_list.followers`	array	Assignee list
`data_list[].follower_list.followers[].follower_id`	string	Assignee ID (i.e. userid) — Need to convert to name via wecomcli-lookup-contact before display
`data_list[].follower_list.followers[].follower_status`	number	Assignee status: `0` -Rejected, `1` -Accepted, `2` -Completed
`data_list[].follower_list.followers[].update_time`	string	Assignee status update time
`data_list[].creator_id`	string	Creator ID — Need to convert to name via wecomcli-lookup-contact before display
`data_list[].user_status`	number	Current user status
`data_list[].remind_time`	string	Reminder time
`data_list[].create_time`	string	Creation time
`data_list[].update_time`	string	Update time

Typical Workflow

List + Detail Joint Query (Three steps are indispensable)

User asks: "Check my recent to-dos" / "What to-do items do I have?"

Step 1: Obtain the to-do list via wecomcli-get-todo-list.

bash

wecom-cli todo get_todo_list '{}'

Step 2: Batch obtain details based on the returned todo_id.

bash

wecom-cli todo get_todo_detail '{"todo_id_list": ["TODO_ID_1", "TODO_ID_2", "TODO_ID_3"]}'

Step 3 (Do not skip!): Obtain the address book via wecomcli-lookup-contact, convert follower_id / creator_id to names. Match follower_id and creator_id with the userid in the returned userlist, and take the name field as the display name.

Step 3 is the prerequisite for displaying readable results. Without this step, users will see a string of meaningless IDs instead of names.

Display format (Note: Assignees and creators must be displayed as names, not IDs):

📋 Your current to-do items (3 items in total)

1. 🔵 Complete Q2 planning document
   - To-do status: In progress | My status: Accepted
   - Reminder time: 2025-06-01 09:00
   - Assignees: Zhang San, Li Si
   - Creation time: 2025-01-15

2. 🔵 Submit weekly report
   - To-do status: In progress | My status: Accepted
   - Reminder time: 2025-03-17 18:00
   - Creation time: 2025-03-10

3. ☑️ Code review
   - To-do status: Completed | My status: Completed
   - Creation time: 2025-03-01

Notes

Personnel ID must be converted to name
- The
```
follower_id
```
  and
```
creator_id
```
  in the returned results are internal system identifiers, which cannot be recognized by users
- Before displaying to-do details, first
bash
```
wecom-cli contact get_userlist '{}'
```
to obtain the address book
- Match
```
follower_id
```
  /
```
creator_id
```
  with the
```
userid
```
  in the address book, and replace the display with
```
name
```
todo_id source rules
- ```
todo_id
```
  must come from the results returned by
```
wecomcli-get-todo-list
```
  , and it is forbidden to speculate or construct it by yourself
- Users usually provide to-do content descriptions instead of IDs, you should first check the list through
```
wecomcli-get-todo-list
```
  and then match
Status value meaning
- To-do status (
```
todo_status
```
  ):
```
0
```
  -Completed,
```
1
```
  -In progress,
```
2
```
  -Deleted
- User status (
```
user_status
```
  ):
```
0
```
  -Rejected,
```
1
```
  -Accepted,
```
2
```
  -Completed
- Assignee status (
```
follower_status
```
  ):
```
0
```
  -Rejected,
```
1
```
  -Accepted,
```
2
```
  -Completed
Error handling: If
```
errcode
```
is not
```
0
```
, inform the user of the error information in
```
errmsg
```
Single limit:
```
todo_id_list
```
can pass up to 20 IDs at a time, and requests need to be made in batches if exceeded

wecomcli-get-todo-detail

NPX Install

Tags

SKILL.md Content (Chinese)

WeCom To-Do Detail Query Skill

Behavior Strategy

Calling Method

Parameter Description

Return Format

Return Field Description

Typical Workflow

List + Detail Joint Query (Three steps are indispensable)

Notes