@wecom/wecom-openclaw-plugin 2026.5.7 → 2026.5.14

package/skills/wecom-todo/examples/workflows.md

@@ -0,0 +1,163 @@
+# 典型工作流
+
+### 工作流 1：查看待办列表（标准三步流程）
+
+**用户意图**："看看我最近的待办" / "我有哪些待办事项？" / "我还有多少事要做？"
+
+**步骤：**
+
+1. **获取待办列表**（只有 ID 和状态，没有内容）：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '{}'`
+
+2. **用返回的 todo_id 列表获取完整详情**（禁止跳过！）：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_detail '{"todo_id_list": ["返回的TODO_ID_1", "返回的TODO_ID_2"]}'`
+
+3. **通过 wecom-contact 获取通讯录**，将 follower_id / creator_id 转为姓名：使用 `wecom_mcp` tool 调用 `wecom_mcp call contact get_userlist '{}'`
+
+用返回的 userlist 中的 userid 匹配 follower_id 和 creator_id，取 name 字段作为展示姓名。
+
+4. **检查分页**：检查第一步返回的 `has_more` 字段。如果为 `true`，在展示结果时必须提醒用户："以上是部分待办，还有更多待办未显示，需要我继续查看吗？"
+
+**展示格式（分派人和创建人必须显示为姓名，不是 ID）：**
+
+```
+📋 您当前的待办事项（共 3 项）
+
+1. 🔵 完成Q2规划文档
+   - 待办状态：进行中 | 我的状态：已接受
+   - 提醒时间：2025-06-01 09:00
+   - 分派人：张三、李四
+   - 创建时间：2025-01-15
+
+2. 🔵 提交周报
+   - 待办状态：进行中 | 我的状态：已接受
+   - 提醒时间：2025-03-17 18:00
+   - 创建时间：2025-03-10
+
+3. ☑️ 代码评审
+   - 待办状态：已完成 | 我的状态：已完成
+   - 创建时间：2025-03-01
+```
+
+---
+
+### 工作流 2：按时间范围查询待办
+
+**用户意图**："这个月创建的待办有哪些？"
+
+**步骤：**
+
+1. **按时间过滤获取列表**：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '{"create_begin_time": "2025-03-01 00:00:00", "create_end_time": "2025-03-31 23:59:59"}'`
+
+2. **获取详情**（同工作流 1 的第 2、3 步）。
+
+---
+
+### 工作流 3：创建待办并分派给同事
+
+**用户意图**："帮我创建一个待办，让张三下周一前完成需求文档"
+
+**步骤：**
+
+1. **通讯录查询**：通过 wecom-contact 技能查询张三的 userid，在返回结果中筛选姓名为"张三"的成员，获取其 userid。使用 `wecom_mcp` tool 调用 `wecom_mcp call contact get_userlist '{}'`
+
+2. **创建待办并分派**：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo create_todo '{"content": "<待办的内容>", "follower_list": {"followers": [{"follower_id": "zhangsan", "follower_status": 1}]}, "remind_time": "2025-03-24 09:00:00"}'`
+
+3. **展示结果**：
+```
+✅ 待办创建成功！
+
+📝 内容：完成需求文档
+👥 分派人：张三
+⏰ 提醒时间：2025-03-24 09:00
+```
+
+> `follower_id` 必须来自 `wecom-contact` 技能的 `get_userlist` 接口返回的 `userid`，禁止自行猜测。若搜索结果有多个同名人员，需展示候选列表让用户确认。
+
+---
+
+### 工作流 4：标记待办完成
+
+需要区分两种场景：**标记待办本身完成**（改 `todo_status`）和**标记我的参与状态为完成**（改 `user_status`）。
+
+#### 场景 A：标记待办本身完成
+
+**用户意图**："把'完成Q2规划文档'这个待办标记为完成" / "关闭这个待办"
+
+1. **查找目标待办**：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '{}'`
+2. **获取详情确认**：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_detail '{"todo_id_list": ["TODO_ID"]}'`
+3. **将待办状态改为已完成**：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo update_todo '{"todo_id": "TODO_ID", "todo_status": 0}'`
+
+#### 场景 B：标记我的参与状态为完成
+
+**用户意图**："我已经完成了这个待办" / "标记我的部分为完成"
+
+1. **查找目标待办**：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '{}'`
+2. **获取详情确认**：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_detail '{"todo_id_list": ["TODO_ID"]}'`
+3. **变更当前用户的参与状态为已完成**：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo change_todo_user_status '{"todo_id": "TODO_ID", "user_status": 2}'`
+
+> **如何判断用户意图：** 如果用户说"标记完成"且该待办是自己创建的、没有其他分派人，通常指场景 A（标记待办本身完成）。如果该待办有多个参与人，用户可能只是想标记自己那部分完成（场景 B）。不确定时应向用户确认。
+
+> 用户提供的是待办内容描述而非 ID，所以需要先通过 `get_todo_list` 和 `get_todo_detail` 查找再匹配。匹配到多个相似待办时，列出候选项让用户确认。
+
+---
+
+### 工作流 5：更新待办内容或提醒时间
+
+**用户意图**："把那个需求文档的待办提醒时间改到下周五"
+
+**步骤：**
+
+1. **查找目标待办**：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '{}'`
+
+再查详情：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_detail '{"todo_id_list": ["TODO_ID_1", "TODO_ID_2"]}'`
+
+2. **确认目标后更新**：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo update_todo '{"todo_id": "TODO_ID", "remind_time": "2025-03-28 09:00:00"}'`
+
+3. **展示结果**：
+```
+✅ 待办已更新！
+
+📝 内容：完成需求文档
+⏰ 新提醒时间：2025-03-28 09:00
+```
+
+---
+
+### 工作流 6：删除待办
+
+**用户意图**："删掉'代码评审'那个待办"
+
+**步骤：**
+
+1. **查找目标待办**：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '{}'`
+
+再查详情：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_detail '{"todo_id_list": ["TODO_ID"]}'`
+
+2. **向用户确认后删除**：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo delete_todo '{"todo_id": "TODO_ID"}'`
+
+3. **展示结果**：
+```
+✅ 待办已删除：代码评审
+```
+
+> 删除前必须向用户确认，确认措辞示例："确认删除待办'代码评审'吗？删除后不可恢复。"
+
+---
+
+### 工作流 7：分页获取大量待办
+
+当待办数量超过单页上限时，通过 `cursor` 循环分页拉取：
+
+- 首次请求（不传 cursor）：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '{"limit": 20}'`
+
+如果没有拉取完，还有更多的待办，会返回 has_more=true, next_cursor="CURSOR_1"
+
+- 第二次请求（传入上次的 next_cursor）：使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '{"limit": 20, "cursor": "CURSOR_1"}'`
+
+返回 has_more=false，拉取完毕
+
+**分页规则：**
+- 首次请求不传 `cursor`
+- `has_more` 为 `true` 时，将 `next_cursor` 作为下次请求的 `cursor` 传入
+- `has_more` 为 `false` 时停止请求
+- 分页过程中时间过滤参数保持不变
+- **如果选择不继续翻页（比如当前页数据已经够用），必须告诉用户还有更多待办未显示，问用户是否需要继续查看**

package/skills/wecom-doc-manager/references/api-smartpage-export-task.md

@@ -1,62 +0,0 @@
-# smartpage_export_task API
-
-发起智能文档（原智能主页）内容导出任务。该接口为异步操作的第一步，调用后返回 `task_id`，需配合 `smartpage_get_export_result` 轮询获取导出结果。
-
-## 技能定义
-
-```json
-{
-    "name": "smartpage_export_task",
-    "description": "发起智能文档（原智能主页）内容导出任务（异步）。传入 docid 和 content_type，返回 task_id。需配合 smartpage_get_export_result 轮询查询导出进度，直到任务完成后获取导出文件路径。",
-    "inputSchema": {
-        "properties": {
-            "docid": {
-                "description": "智能文档的 docid，由 smartpage_create 返回",
-                "title": "Doc ID",
-                "type": "string"
-            },
-            "content_type": {
-                "description": "导出内容格式。0: Text，1: Markdown",
-                "enum": [0, 1],
-                "title": "Content Type",
-                "type": "integer"
-            }
-        },
-        "required": ["docid", "content_type"],
-        "title": "smartpage_export_taskArguments",
-        "type": "object"
-    }
-}
-```
-
-## 参数说明
-
-| 参数 | 类型 | 必填 | 说明 |
-|---|---|---|---|
-| docid | string | 是 | 智能文档的 docid |
-| content_type | integer | 是 | 导出内容格式：0-Text，1-Markdown |
-
-## 请求示例
-
-```json
-{
-    "docid": "DOCID",
-    "content_type": 1
-}
-```
-
-## 响应示例
-
-```json
-{
-    "errcode": 0,
-    "errmsg": "ok",
-    "task_id": "TASK_ID"
-}
-```
-
-## 注意事项
-
-- 这是异步操作的第一步，调用后仅返回 `task_id`
-- 获取到 `task_id` 后，需调用 `smartpage_get_export_result` 轮询导出进度
-- `content_type` 建议使用 `1`（Markdown）以获取可编辑的文本格式

package/skills/wecom-doc-manager/references/api-smartpage-get-export-result.md

@@ -1,74 +0,0 @@
-# smartpage_get_export_result API
-
-查询智能文档（原智能主页）导出任务的执行进度。配合 `smartpage_export_task` 使用，通过轮询 `task_id` 获取导出结果。当 `task_done` 为 `true` 时，返回导出内容的本地文件路径。
-
-## 技能定义
-
-```json
-{
-    "name": "smartpage_get_export_result",
-    "description": "查询智能文档（原智能主页）导出任务进度。传入 task_id 轮询，当 task_done 为 true 时返回导出内容的本地文件路径 content_filepath，可通过读取该文件获取 Markdown 内容。",
-    "inputSchema": {
-        "properties": {
-            "task_id": {
-                "description": "导出任务 ID，由 smartpage_export_task 返回",
-                "title": "Task ID",
-                "type": "string"
-            }
-        },
-        "required": ["task_id"],
-        "title": "smartpage_get_export_resultArguments",
-        "type": "object"
-    }
-}
-```
-
-## 参数说明
-
-| 参数 | 类型 | 必填 | 说明 |
-|---|---|---|---|
-| task_id | string | 是 | 导出任务 ID，由 `smartpage_export_task` 返回 |
-
-## 请求示例
-
-```json
-{
-    "task_id": "TASK_ID"
-}
-```
-
-## 响应示例
-
-任务未完成：
-
-```json
-{
-    "errcode": 0,
-    "errmsg": "ok",
-    "task_done": false
-}
-```
-
-任务完成：
-
-```json
-{
-    "errcode": 0,
-    "errmsg": "ok",
-    "task_done": true,
-    "content_filepath": "/path/to/exported-content.md"
-}
-```
-
-## 异步轮询机制
-
-1. **调用 smartpage_export_task** 获取 `task_id`
-2. **首次轮询**：传入 `task_id` 调用本接口
-3. **检查响应**：若 `task_done` 为 `false`，继续轮询
-4. **获取内容**：当 `task_done` 为 `true` 时，读取 `content_filepath` 指向的本地文件获取导出内容
-
-## 注意事项
-
-- `content_filepath` 仅在 `task_done` 为 `true` 时返回
-- `content_filepath` 是本地文件路径，使用 Read 工具读取文件内容即可
-- 如果轮询多次仍未完成，建议适当增加轮询间隔

package/skills/wecom-edit-todo/SKILL.md

@@ -1,249 +0,0 @@
----
-name: wecom-edit-todo
-description: 企业微信待办事项编辑技能，支持创建、更新、删除待办及变更用户处理进度状态。在用户说"帮我创建一个待办"、"把这个任务分派给张三"、"标记待办完成"、"删掉那个待办"、"帮我建个提醒"、"更新一下待办内容"、"把提醒时间改到下周"、"接受这个待办"、"拒绝这个待办"等需要对待办进行写操作的场景时使用。
----
-
-# 企业微信待办事项编辑技能
-
-> `wecom_mcp` 是一个 MCP tool，所有操作通过调用该 tool 完成。
-
-> ⚠️ **前置条件**：首次调用 `wecom_mcp` 前，必须按 `wecom-preflight` 技能执行前置条件检查，确保工具已加入白名单。
-
-通过 `wecom_mcp` tool 对企业微信待办事项进行写操作，支持四种操作：创建待办、更新待办、删除待办、变更用户状态。
-
-## 行为策略
-
-**重试策略**: 遭遇"返回 HTTP 错误"或"HTTP 请求失败"时，主动重试，最多重试三次。
-
----
-
-## 操作
-
-### 1. 创建待办
-
-创建一个新的待办事项，可指定内容、分派人和提醒时间：
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call todo create_todo '<json格式的入参>'`
-
-**参数说明：**
-
-需要遵循 “注意事项”中的格式要求：
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `content` | string | ✅ | 待办内容 |
-| `follower_list` | object | ❌ | 分派人列表，格式见注意事项第 7 条 |
-| `remind_time` | string | ❌ | 提醒时间，格式：`YYYY-MM-DD HH:mm:ss` |
-
-
-**调用示例：**
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call todo create_todo '{"content": "<待办的内容>", "remind_time": "2025-06-01 09:00:00"}'`
-
-**返回格式：**
-
-```json
-{
-    "errcode": 0,
-    "errmsg": "ok",
-    "todo_id": "TODO_ID"
-}
-```
-
----
-
-### 2. 更新待办
-
-修改已有待办事项的内容、分派人、状态或提醒时间：
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call todo update_todo '<json格式的入参>'`
-
-**参数说明：**
-
-需要遵循 “注意事项”中的格式要求：
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `todo_id` | string | ✅ | 待办 ID |
-| `content` | string | ❌ | 新的待办内容 |
-| `follower_list` | object | ❌ | 新的分派人列表（全量替换，非追加），格式见注意事项第 7 条。若要新增分派人，需先查出现有分派人，合并后一起提交 |
-| `todo_status` | number | ❌ | 新的待办状态：`0`-已完成，`1`-进行中。删除请使用 `delete_todo` |
-| `remind_time` | string | ❌ | 新的提醒时间 |
-
-**调用示例：**
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call todo update_todo '{"todo_id": "TODO_ID", "content": "<待办的内容>", "remind_time": "2025-07-01 09:00:00"}'`
-
-**返回格式：**
-
-```json
-{
-    "errcode": 0,
-    "errmsg": "ok"
-}
-```
-
----
-
-### 3. 删除待办
-
-删除指定的待办事项：
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call todo delete_todo '<json格式的入参>'`
-
-**参数说明：**
-
-需要遵循 “注意事项”中的格式要求：
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `todo_id` | string | ✅ | 待办 ID |
-
-**调用示例：**
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call todo delete_todo '{"todo_id": "TODO_ID"}'`
-
-**返回格式：**
-
-```json
-{
-    "errcode": 0,
-    "errmsg": "ok"
-}
-```
-
-> 删除操作不可撤销，执行前应向用户确认。
-> 注意：`delete_todo` 与 `update_todo` 设置 `todo_status=2` 效果相同，优先使用 `delete_todo`。
-
----
-
-### 4. 变更用户待办状态
-
-更改当前用户在某个待办中的状态（拒绝/接受/已完成）：
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call todo change_todo_user_status '<json格式的入参>'`
-
-**参数说明：**
-
-需要遵循 “注意事项”中的格式要求：
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `todo_id` | string | ✅ | 待办 ID |
-| `user_status` | number | ✅ | 用户状态：`0`-拒绝，`1`-接受，`2`-已完成 |
-
-**调用示例：**
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call todo change_todo_user_status '{"todo_id": "TODO_ID", "user_status": 2}'`
-
-**返回格式：**
-
-```json
-{
-    "errcode": 0,
-    "errmsg": "ok"
-}
-```
-
----
-
-## 典型工作流
-
-### 创建待办并分派给同事
-
-用户问："帮我创建一个待办，让张三下周一前完成需求文档"
-
-1. 第一步：通过 wecom-contact-lookup 技能查询张三的 userid，在返回结果中筛选姓名为"张三"的成员，获取其 userid
-2. 第二步：创建待办并分派，使用 `wecom_mcp` tool 调用 `wecom_mcp call todo create_todo '{"content": "<待办的内容>", "follower_list": {"followers": [{"follower_id": "zhangsan", "follower_status": 1}]}, "remind_time": "2025-03-24 09:00:00"}'`
-
-> `follower_id` 必须来自 `wecom-contact-lookup` 技能的 `get_userlist` 接口返回的 `userid`，禁止自行猜测。若搜索结果有多个同名人员，需展示候选列表让用户确认。
-
-### 标记待办完成
-
-需要区分两种场景：**标记待办本身完成**（改 `todo_status`）和**标记我的参与状态为完成**（改 `user_status`）。
-
-#### 场景 A：标记待办本身完成
-
-用户问："把'完成Q2规划文档'这个待办标记为完成" / "关闭这个待办"
-
-1. 第一步：通过 wecom-get-todo-list 获取待办列表，找到目标待办的 todo_id。使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '{}'`
-2. 第二步：通过 wecom-get-todo-detail 获取详情，确认是目标待办。使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_detail '{"todo_id_list": ["TODO_ID"]}'`
-3. 第三步：确认后，将待办状态改为已完成。使用 `wecom_mcp` tool 调用 `wecom_mcp call todo update_todo '{"todo_id": "TODO_ID", "todo_status": 0}'`
-
-#### 场景 B：标记我的参与状态为完成
-
-用户问："我已经完成了这个待办" / "标记我的部分为完成"
-
-1. 第一步：通过 wecom-get-todo-list 获取待办列表，找到目标待办的 todo_id。使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '{}'`
-2. 第二步：通过 wecom-get-todo-detail 获取详情，确认是目标待办。使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_detail '{"todo_id_list": ["TODO_ID"]}'`
-3. 第三步：确认后，变更当前用户的参与状态为已完成。使用 `wecom_mcp` tool 调用 `wecom_mcp call todo change_todo_user_status '{"todo_id": "TODO_ID", "user_status": 2}'`
-
-> **如何判断用户意图：** 如果用户说"标记完成"且该待办是自己创建的、没有其他分派人，通常指场景 A（标记待办本身完成）。如果该待办有多个参与人，用户可能只是想标记自己那部分完成（场景 B）。不确定时应向用户确认。
-
-> 用户提供的是待办内容描述而非 ID，所以需要先通过 wecom-get-todo-list 和 wecom-get-todo-detail 查找再匹配。匹配到多个相似待办时，列出候选项让用户确认。
-
-### 更新待办内容或提醒时间
-
-用户问："把那个需求文档的待办提醒时间改到下周五"
-
-1. 第一步：查找目标待办。使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '{}'`，再使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_detail '{"todo_id_list": ["TODO_ID_1", "TODO_ID_2"]}'`
-2. 第二步：确认目标后更新。使用 `wecom_mcp` tool 调用 `wecom_mcp call todo update_todo '{"todo_id": "TODO_ID", "remind_time": "2025-03-28 09:00:00"}'`
-
-### 删除待办
-
-用户问："删掉'代码评审'那个待办"
-
-1. 第一步：查找目标待办。使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '{}'`，再使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_detail '{"todo_id_list": ["TODO_ID"]}'`
-2. 第二步：向用户确认后删除。使用 `wecom_mcp` tool 调用 `wecom_mcp call todo delete_todo '{"todo_id": "TODO_ID"}'`
-
-> 删除前必须向用户确认，确认措辞示例："确认删除待办'代码评审'吗？删除后不可恢复。"
-
----
-
-## 注意事项
-
-1. **todo_id 来源规则**
-   - `todo_id` 必须来自 `wecom-get-todo-list` 返回的结果，禁止自行推测或构造
-   - 用户通常提供待办内容描述而非 ID，应先通过 wecom-get-todo-list 查列表再匹配
-   - 若匹配到多个相似待办，展示候选列表让用户确认
-
-2. **follower_id 来源规则**
-   - `follower_id` 即 `userid`，必须通过 `wecom-contact-lookup` 技能的 `get_userlist` 接口获取
-   - 禁止根据用户姓名自行猜测 userid
-   - 若搜索结果有多个同名人员，展示候选列表让用户选择
-
-3. **时间格式**
-   - 所有时间参数使用 `YYYY-MM-DD HH:mm:ss` 格式
-   - 用户说"明天"、"下周一"等相对时间时，根据当前日期推算具体日期
-
-4. **状态值含义**
-   - 待办状态（`todo_status`）：`0`-已完成，`1`-进行中，`2`-已删除
-   - 用户状态（`user_status`）：`0`-拒绝，`1`-接受，`2`-已完成
-   - 分派人状态（`follower_status`）：`0`-拒绝，`1`-接受，`2`-已完成
-
-5. **破坏性操作确认**
-   - 删除待办（`delete_todo`）前必须向用户确认
-   - 变更状态为"拒绝"（`user_status=0`）前建议向用户确认
-
-6. **错误处理**
-   - 若 `errcode` 不为 `0`，说明接口调用失败，告知用户 `errmsg` 中的错误信息
-
-7. **follower_list** 的格式（作为输入参数的时候）
-
-    ```json
-    "follower_list": {                    // 分派人列表
-        "followers": [                    // 注意里面还有一层是 "followers"，它的value才是真正的列表数组
-            {
-                "follower_id": "FOLLOWER_ID",      // 分派人id
-                "follower_status": 1              // 分派人状态：0-拒绝, 1-接受, 2-已完成
-            }
-        ]
-    }
-    ```
-    > `follower_id` 即 userid，需要通过 `wecom-contact-lookup` 查询获取，禁止自行猜测或构造。
-
-## 相关技能
-
-- **获取待办列表**：`wecom-get-todo-list` — 查询待办概要列表，获取 todo_id
-- **获取待办详情**：`wecom-get-todo-detail` — 根据 todo_id 获取完整内容
-- **通讯录查询**：`wecom-contact-lookup` 的 `get_userlist` — 获取成员 userid，用于 `follower_id`