wecomcli-todo

Name: wecomcli-todo
Author: WecomTeam

2.5kstars172forks

How to install wecomcli-todo?

wecomteam/wecom-cli/wecomcli-todo

$npx -y skills add WecomTeam/wecom-cli --skill wecomcli-todo

Installs into the current project.

Summary

企业微信待办事项管理技能，支持创建待办、更新待办、更改用户在待办中的状态、获取待办列表、批量获取待办详情、删除待办。在用户说"帮我创建一个待办"、"把这个任务分派给张三"、"标记待办完成"、"接受/拒绝这个待办"、"把我在这个待办里的状态改成已完成"、"删掉那个待办"、"帮我建个提醒"、"更新一下待办内容"、"把提醒时间改到下周"、"看看这个待办的详情"、"待办分派给谁了"、"看看我有哪些待办"、"列一下我最近的待办"等需要对待办进行读写操作的场景时使用。

Files · 1

View on GitHub

SKILL.md

1	# 企业微信待办事项管理技能
2
3	> `wecom-cli` 是企业微信提供的命令行程序，所有操作通过执行 `wecom-cli` 命令完成。
4
5	## 概述
6
7	wecomcli-todo 提供企业微信待办事项的管理能力，包含以下功能：
8
9	1. 搜索 userid - 根据姓名或别名搜索用户的 userid，用于在创建/更新待办、更改用户状态、查询待办列表时把姓名解析为 userid
10	2. 创建待办 - 创建新的待办事项，可指定内容、参与人、截止时间和提醒方式
11	3. 更新待办 - 修改已有待办的内容、参与人、待办状态、截止时间和提醒方式
12	4. 更改用户状态 - 更改某位参与人在某个待办中的状态（拒绝/接受/已完成）
13	5. 获取待办列表 - 获取指定用户的待办列表，支持按创建时间和提醒时间过滤
14	6. 获取待办详情 - 根据待办 ID 列表批量获取完整信息
15	7. 删除待办 - 删除指定的待办事项
16
17	## 命令调用方式
18
19	执行指定命令：
20	```bash
21	wecom-cli todo <tool_name> '<json_params>'
22	```
23
24	---
25
26	## 命令详细说明
27
28	### 1. 搜索 userid (search_todo_userid)
29
30	基础接口，根据姓名或别名搜索用户的 userid，用于在创建待办、更新待办时把用户姓名解析为 userid 进行传参。
31
32	#### 执行命令
33
34	```bash
35	wecom-cli todo search_todo_userid '<json格式的入参>'
36	```
37
38	#### 入参说明
39
40	\| 参数 \| 类型 \| 必填 \| 说明 \|
41	\|------\|------\|------\|------\|
42	\| `keyword` \| string \| 是 \| 姓名或别名 \|
43
44	#### 调用示例
45
46	```bash
47	wecom-cli todo search_todo_userid '{"keyword": "张三"}'
48	```
49
50	#### 返回字段说明
51
52	- 返回与关键字匹配的用户的 `userid`（可能为多个候选）。
53	- 若有多个同名/相似用户，展示候选列表让用户确认后再使用；展示时只用姓名/别名/部门等可读信息区分，禁止向用户暴露 `userid`。
54	- 拿到的 `userid` 用于 `create_todo` / `update_todo` 的 `follower_list`，仅供内部传参，不在对话中展示。
55	- 调用前可先检查对话上下文是否已有该用户的 `userid`，若有则直接复用、无需再次查询；若本接口返回错误（查询失败、无结果等），则改用通讯录 `wecomcli-contact` 技能搜索（详见注意事项第 2 条）。
56
57	---
58
59	### 2. 创建待办 (create_todo)
60
61	创建一个新的待办事项，可指定内容、参与人、截止时间和提醒方式。
62
63	#### 执行命令
64
65	```bash
66	wecom-cli todo create_todo '<json格式的入参>'
67	```
68
69	#### 入参说明
70
71	\| 参数 \| 类型 \| 必填 \| 说明 \|
72	\|------\|------\|----\|-----------------------------------------------------------------\|
73	\| `content` \| string \| 是 \| 待办内容 \|
74	\| `follower_list` \| object \| 是 \| 参与人信息，对象中包含 `followers` 数组，格式见注意事项第 3 条 \|
75	\| `end_time` \| string \| 条件必填 \| 截止时间（到期时间），格式：`YYYY-MM-DD HH:mm:ss`；提醒方式基于此时间计算偏移。当 `remind_type_list` 含非 `0`（即设置了实际提醒）时必填 \|
76	\| `remind_type_list` \| uint32[] \| 否 \| 提醒方式，相对 `end_time` 计算，可传入多个。取值：`0`-不提醒，`1`-到期时，`3`-提前 15 分钟，`5`-提前 1 小时，`6`-提前 2 小时，`7`-提前 1 天，`8`-提前 2 天，`9`-提前 1 周（详见注意事项第 4 条） \|
77
78	#### 调用示例
79
80	```bash
81	wecom-cli todo create_todo '{"content": "<待办的内容>", "follower_list": {"followers": [{"follower_id": "FOLLOWER_ID", "follower_status": 1}]}, "end_time": "2025-06-01 09:00:00", "remind_type_list": [3, 7]}'
82	```
83
84	#### 返回字段说明
85
86	\| 字段 \| 类型 \| 说明 \|
87	\|------\|------\|------\|
88	\| `todo_id` \| string \| 新创建的待办唯一 ID \|
89
90	---
91
92	### 3. 更新待办 (update_todo)
93
94	修改已有待办事项的内容、参与人、待办状态、截止时间或提醒方式。
95
96	> 说明：本接口可更改待办状态（`todo_status`），但不能更改参与人状态（`follower_status`）。如需更改当前用户在某个待办中的状态，请使用 `change_todo_user_status`。
97
98	#### 执行命令
99
100	```bash
101	wecom-cli todo update_todo '<json格式的入参>'
102	```
103
104	#### 入参说明
105
106	\| 参数 \| 类型 \| 必填 \| 说明 \|
107	\|------\|------\|------\|----------------------------------------------------------\|
108	\| `todo_id` \| string \| 是 \| 待办 ID \|
109	\| `content` \| string \| 否 \| 新的待办内容 \|
110	\| `follower_list` \| object \| 否 \| 新的参与人信息（全量替换，非追加），对象中包含 `followers` 数组，格式见注意事项第 3 条。若要新增参与人，需先查出现有参与人，合并后一起提交。本接口不会更改参与人状态（`follower_status`），如需更改用户状态请使用 `change_todo_user_status` \|
111	\| `todo_status` \| uint32 \| 否 \| 新的待办状态：`0`-已完成，`1`-进行中 \|
112	\| `end_time` \| string \| 否 \| 新的截止时间（到期时间），格式：`YYYY-MM-DD HH:mm:ss`；提醒方式基于此时间计算偏移 \|
113	\| `remind_type_list` \| uint32[] \| 否 \| 新的提醒方式，相对 `end_time` 计算，可传入多个。取值：`0`-不提醒，`1`-到期时，`3`-提前 15 分钟，`5`-提前 1 小时，`6`-提前 2 小时，`7`-提前 1 天，`8`-提前 2 天，`9`-提前 1 周（详见注意事项第 4 条） \|
114
115	#### 调用示例
116
117	```bash
118	wecom-cli todo update_todo '{"todo_id": "TODO_ID", "content": "<待办的内容>", "end_time": "2025-07-01 09:00:00", "remind_type_list": [1]}'
119	```
120
121	---
122
123	### 4. 更改用户在某个待办的状态 (change_todo_user_status)
124
125	更改某位参与人在某个待办中的状态（拒绝/接受/已完成）。
126
127	#### 执行命令
128
129	```bash
130	wecom-cli todo change_todo_user_status '<json格式的入参>'
131	```
132
133	#### 入参说明
134
135	\| 参数 \| 类型 \| 必填 \| 说明 \|
136	\|------\|------\|------\|------\|
137	\| `todo_id` \| string \| 是 \| 待办 ID \|
138	\| `follower_id` \| string \| 是 \| 参与人 `userid`，指定要修改哪一位参与人的状态。来源遵循注意事项第 2 条的 userid 获取规则（上下文已有 → `search_todo_userid` → `wecomcli-contact` 技能兜底），禁止自行猜测或构造 \|
139	\| `user_status` \| uint32 \| 是 \| 用户状态：`0`-拒绝，`1`-接受，`2`-已完成 \|
140
141	#### 调用示例
142
143	```bash
144	wecom-cli todo change_todo_user_status '{"todo_id": "TODO_ID", "follower_id": "FOLLOWER_ID", "user_status": 2}'
145	```
146
147	---
148
149	### 5. 获取待办列表 (get_todo_list)
150
151	获取指定用户（由 `follower_id` 指定，可为任意用户）通过机器人的待办列表，支持当天前后一个月的待办，可按创建时间、提醒时间、截止时间和待办状态过滤。
152
153	#### 执行命令
154
155	```bash
156	wecom-cli todo get_todo_list '<json格式的入参>'
157	```
158
159	#### 入参说明
160
161	\| 参数 \| 类型 \| 必填 \| 说明 \|
162	\|------\|------\|------\|------\|
163	\| `follower_id` \| string \| 是 \| 参与人 `userid`，指定要查询哪一位用户的待办列表（可为任意用户），来源遵循注意事项第 2 条的 userid 获取规则，禁止自行猜测或构造 \|
164	\| `create_begin_time` \| string \| 否 \| 创建开始时间 \|
165	\| `create_end_time` \| string \| 否 \| 创建结束时

People who liked this also viewed

6 picks

Type

wecomcli-todo

2.5kstars172forks

View on GitHub

How to install wecomcli-todo?

wecomteam/wecom-cli/wecomcli-todo

$npx -y skills add WecomTeam/wecom-cli --skill wecomcli-todo

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# 企业微信待办事项管理技能
2
3	> `wecom-cli` 是企业微信提供的命令行程序，所有操作通过执行 `wecom-cli` 命令完成。
4
5	## 概述
6
7	wecomcli-todo 提供企业微信待办事项的管理能力，包含以下功能：
8
9	1. 搜索 userid - 根据姓名或别名搜索用户的 userid，用于在创建/更新待办、更改用户状态、查询待办列表时把姓名解析为 userid
10	2. 创建待办 - 创建新的待办事项，可指定内容、参与人、截止时间和提醒方式
11	3. 更新待办 - 修改已有待办的内容、参与人、待办状态、截止时间和提醒方式
12	4. 更改用户状态 - 更改某位参与人在某个待办中的状态（拒绝/接受/已完成）
13	5. 获取待办列表 - 获取指定用户的待办列表，支持按创建时间和提醒时间过滤
14	6. 获取待办详情 - 根据待办 ID 列表批量获取完整信息
15	7. 删除待办 - 删除指定的待办事项
16
17	## 命令调用方式
18
19	执行指定命令：
20	```bash
21	wecom-cli todo <tool_name> '<json_params>'
22	```
23
24	---
25
26	## 命令详细说明
27
28	### 1. 搜索 userid (search_todo_userid)
29
30	基础接口，根据姓名或别名搜索用户的 userid，用于在创建待办、更新待办时把用户姓名解析为 userid 进行传参。
31
32	#### 执行命令
33
34	```bash
35	wecom-cli todo search_todo_userid '<json格式的入参>'
36	```
37
38	#### 入参说明
39
40	\| 参数 \| 类型 \| 必填 \| 说明 \|
41	\|------\|------\|------\|------\|
42	\| `keyword` \| string \| 是 \| 姓名或别名 \|
43
44	#### 调用示例
45
46	```bash
47	wecom-cli todo search_todo_userid '{"keyword": "张三"}'
48	```
49
50	#### 返回字段说明
51
52	- 返回与关键字匹配的用户的 `userid`（可能为多个候选）。
53	- 若有多个同名/相似用户，展示候选列表让用户确认后再使用；展示时只用姓名/别名/部门等可读信息区分，禁止向用户暴露 `userid`。
54	- 拿到的 `userid` 用于 `create_todo` / `update_todo` 的 `follower_list`，仅供内部传参，不在对话中展示。
55	- 调用前可先检查对话上下文是否已有该用户的 `userid`，若有则直接复用、无需再次查询；若本接口返回错误（查询失败、无结果等），则改用通讯录 `wecomcli-contact` 技能搜索（详见注意事项第 2 条）。
56
57	---
58
59	### 2. 创建待办 (create_todo)
60
61	创建一个新的待办事项，可指定内容、参与人、截止时间和提醒方式。
62
63	#### 执行命令
64
65	```bash
66	wecom-cli todo create_todo '<json格式的入参>'
67	```
68
69	#### 入参说明
70
71	\| 参数 \| 类型 \| 必填 \| 说明 \|
72	\|------\|------\|----\|-----------------------------------------------------------------\|
73	\| `content` \| string \| 是 \| 待办内容 \|
74	\| `follower_list` \| object \| 是 \| 参与人信息，对象中包含 `followers` 数组，格式见注意事项第 3 条 \|
75	\| `end_time` \| string \| 条件必填 \| 截止时间（到期时间），格式：`YYYY-MM-DD HH:mm:ss`；提醒方式基于此时间计算偏移。当 `remind_type_list` 含非 `0`（即设置了实际提醒）时必填 \|
76	\| `remind_type_list` \| uint32[] \| 否 \| 提醒方式，相对 `end_time` 计算，可传入多个。取值：`0`-不提醒，`1`-到期时，`3`-提前 15 分钟，`5`-提前 1 小时，`6`-提前 2 小时，`7`-提前 1 天，`8`-提前 2 天，`9`-提前 1 周（详见注意事项第 4 条） \|
77
78	#### 调用示例
79
80	```bash
81	wecom-cli todo create_todo '{"content": "<待办的内容>", "follower_list": {"followers": [{"follower_id": "FOLLOWER_ID", "follower_status": 1}]}, "end_time": "2025-06-01 09:00:00", "remind_type_list": [3, 7]}'
82	```
83
84	#### 返回字段说明
85
86	\| 字段 \| 类型 \| 说明 \|
87	\|------\|------\|------\|
88	\| `todo_id` \| string \| 新创建的待办唯一 ID \|
89
90	---
91
92	### 3. 更新待办 (update_todo)
93
94	修改已有待办事项的内容、参与人、待办状态、截止时间或提醒方式。
95
96	> 说明：本接口可更改待办状态（`todo_status`），但不能更改参与人状态（`follower_status`）。如需更改当前用户在某个待办中的状态，请使用 `change_todo_user_status`。
97
98	#### 执行命令
99
100	```bash
101	wecom-cli todo update_todo '<json格式的入参>'
102	```
103
104	#### 入参说明
105
106	\| 参数 \| 类型 \| 必填 \| 说明 \|
107	\|------\|------\|------\|----------------------------------------------------------\|
108	\| `todo_id` \| string \| 是 \| 待办 ID \|
109	\| `content` \| string \| 否 \| 新的待办内容 \|
110	\| `follower_list` \| object \| 否 \| 新的参与人信息（全量替换，非追加），对象中包含 `followers` 数组，格式见注意事项第 3 条。若要新增参与人，需先查出现有参与人，合并后一起提交。本接口不会更改参与人状态（`follower_status`），如需更改用户状态请使用 `change_todo_user_status` \|
111	\| `todo_status` \| uint32 \| 否 \| 新的待办状态：`0`-已完成，`1`-进行中 \|
112	\| `end_time` \| string \| 否 \| 新的截止时间（到期时间），格式：`YYYY-MM-DD HH:mm:ss`；提醒方式基于此时间计算偏移 \|
113	\| `remind_type_list` \| uint32[] \| 否 \| 新的提醒方式，相对 `end_time` 计算，可传入多个。取值：`0`-不提醒，`1`-到期时，`3`-提前 15 分钟，`5`-提前 1 小时，`6`-提前 2 小时，`7`-提前 1 天，`8`-提前 2 天，`9`-提前 1 周（详见注意事项第 4 条） \|
114
115	#### 调用示例
116
117	```bash
118	wecom-cli todo update_todo '{"todo_id": "TODO_ID", "content": "<待办的内容>", "end_time": "2025-07-01 09:00:00", "remind_type_list": [1]}'
119	```
120
121	---
122
123	### 4. 更改用户在某个待办的状态 (change_todo_user_status)
124
125	更改某位参与人在某个待办中的状态（拒绝/接受/已完成）。
126
127	#### 执行命令
128
129	```bash
130	wecom-cli todo change_todo_user_status '<json格式的入参>'
131	```
132
133	#### 入参说明
134
135	\| 参数 \| 类型 \| 必填 \| 说明 \|
136	\|------\|------\|------\|------\|
137	\| `todo_id` \| string \| 是 \| 待办 ID \|
138	\| `follower_id` \| string \| 是 \| 参与人 `userid`，指定要修改哪一位参与人的状态。来源遵循注意事项第 2 条的 userid 获取规则（上下文已有 → `search_todo_userid` → `wecomcli-contact` 技能兜底），禁止自行猜测或构造 \|
139	\| `user_status` \| uint32 \| 是 \| 用户状态：`0`-拒绝，`1`-接受，`2`-已完成 \|
140
141	#### 调用示例
142
143	```bash
144	wecom-cli todo change_todo_user_status '{"todo_id": "TODO_ID", "follower_id": "FOLLOWER_ID", "user_status": 2}'
145	```
146
147	---
148
149	### 5. 获取待办列表 (get_todo_list)
150
151	获取指定用户（由 `follower_id` 指定，可为任意用户）通过机器人的待办列表，支持当天前后一个月的待办，可按创建时间、提醒时间、截止时间和待办状态过滤。
152
153	#### 执行命令
154
155	```bash
156	wecom-cli todo get_todo_list '<json格式的入参>'
157	```
158
159	#### 入参说明
160
161	\| 参数 \| 类型 \| 必填 \| 说明 \|
162	\|------\|------\|------\|------\|
163	\| `follower_id` \| string \| 是 \| 参与人 `userid`，指定要查询哪一位用户的待办列表（可为任意用户），来源遵循注意事项第 2 条的 userid 获取规则，禁止自行猜测或构造 \|
164	\| `create_begin_time` \| string \| 否 \| 创建开始时间 \|
165	\| `create_end_time` \| string \| 否 \| 创建结束时

People who liked this also viewed

6 picks

Type