@lanmers/wecom-openclaw-plugin 1.0.12

package/skills/wecom-get-todo-list/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: wecom-get-todo-list
+description: 企业微信待办列表查询技能，支持按创建时间和提醒时间过滤，支持分页。在用户说"看看我的待办列表"、"我有哪些待办"、"这周的待办有哪些"、"最近有什么待办"、"查一下我的待办"、"列出所有待办"等需要浏览待办概览的场景时使用。注意：此技能仅返回待办概要信息（不含内容和分派人），如需完整详情请配合 wecom-get-todo-detail 使用。
+---
+
+# 企业微信待办列表查询技能
+
+> `wecom_mcp` 是一个 MCP tool，所有操作通过调用该 tool 完成。
+
+> ⚠️ **前置条件**：首次调用 `wecom_mcp` 前，必须按 `wecom-preflight` 技能执行前置条件检查，确保工具已加入白名单。
+
+通过 `wecom_mcp` tool 查询企业微信待办列表，支持按时间过滤和分页。
+
+## 行为策略
+
+**查完列表必须查详情**: 本接口只返回待办 ID 和状态等概要信息，不包含待办的实际内容和分派人。对用户来说，没有内容的待办列表毫无用处——他们想知道的是"要做什么"，而不是一串 ID。因此，每次调用 get_todo_list 拿到结果后，都要紧接着用返回的 todo_id 列表调用 `wecom-get-todo-detail` 获取完整详情（内容、分派人等），然后再向用户展示。这不是可选步骤，而是完成用户请求的必要环节。
+
+**分页未拉完时必须提醒用户**: 接口是分页的，不要求一次性拉完所有数据。但如果响应中 `has_more` 为 `true`，说明后面还有待办没有返回——这时你在展示当前结果的同时，必须明确告诉用户"还有更多待办未显示，是否需要继续查看？"。用户可能不知道后面还有数据，如果你不说，他们会以为看到的就是全部，这会导致遗漏重要待办。这是一个容易被忽略但后果严重的点，请务必执行。
+
+**重试策略**: 遭遇"返回 HTTP 错误"或"HTTP 请求失败"时，主动重试，最多重试三次。
+
+---
+
+## 调用方式
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '<json格式的入参>'`
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `create_begin_time` | string | ❌ | 创建开始时间，格式：`YYYY-MM-DD HH:mm:ss` |
+| `create_end_time` | string | ❌ | 创建结束时间，格式：`YYYY-MM-DD HH:mm:ss` |
+| `remind_begin_time` | string | ❌ | 提醒开始时间，格式：`YYYY-MM-DD HH:mm:ss` |
+| `remind_end_time` | string | ❌ | 提醒结束时间，格式：`YYYY-MM-DD HH:mm:ss` |
+| `limit` | number | ❌ | 最大返回数量，默认 10，最大 20 |
+| `cursor` | string | ❌ | 分页游标，首次请求不传，后续传入上次响应的 `next_cursor` |
+
+## 返回格式
+
+```json
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "index_list": [
+        {
+            "todo_id": "TODO_ID",
+            "todo_status": 1,
+            "user_status": 1,
+            "creator_id": "CREATOR_ID",
+            "remind_time": "2025-06-01 09:00:00",
+            "create_time": "2025-01-15 10:30:00",
+            "update_time": "2025-01-16 14:20:00"
+        }
+    ],
+    "next_cursor": "NEXT_CURSOR",
+    "has_more": false
+}
+```
+
+## 返回字段说明
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `index_list` | array | 待办列表 |
+| `index_list[].todo_id` | string | 待办唯一 ID |
+| `index_list[].todo_status` | number | 待办状态：`0`-已完成，`1`-进行中，`2`-已删除 |
+| `index_list[].user_status` | number | 用户状态：`0`-拒绝，`1`-接受，`2`-已完成 |
+| `index_list[].creator_id` | string | 创建人 ID |
+| `index_list[].remind_time` | string | 提醒时间 |
+| `index_list[].create_time` | string | 创建时间 |
+| `index_list[].update_time` | string | 更新时间 |
+| `next_cursor` | string | 下一页游标 |
+| `has_more` | boolean | 是否还有更多记录 |
+
+> 列表返回的是待办概要信息（不含内容和分派人）。拿到列表后，必须调用 `wecom-get-todo-detail` 获取完整详情再展示给用户。
+
+---
+
+## 典型工作流
+
+### 查看待办列表（标准两步流程）
+
+用户问："看看我最近的待办" / "我有哪些待办事项？" / "我还有多少事要做？"
+
+1. 第一步：获取待办列表（只有 ID 和状态，没有内容）。使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_list '{}'`
+2. 第二步（禁止跳过！）：用返回的 todo_id 列表调用 wecom-get-todo-detail 获取完整详情。使用 `wecom_mcp` tool 调用 `wecom_mcp call todo get_todo_detail '{"todo_id_list": ["返回的TODO_ID_1", "返回的TODO_ID_2"]}'`
+
+两步缺一不可——只有拿到详情后，才能向用户展示有意义的待办内容。
+
+3. 第三步（条件执行）：检查第一步返回的 `has_more` 字段。如果为 `true`，在展示结果时必须提醒用户："以上是部分待办，还有更多待办未显示，需要我继续查看吗？"——不提醒的话，用户会以为这就是全部。
+
+### 按时间范围查询
+
+用户问："这个月创建的待办有哪些？"
+
+使用 `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"}'`
+
+### 分页获取大量待办
+
+当待办数量超过单页上限时，通过 `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` 时停止请求
+- 分页过程中时间过滤参数保持不变
+- **如果选择不继续翻页（比如当前页数据已经够用），必须告诉用户还有更多待办未显示，问用户是否需要继续查看**
+
+---
+
+## 注意事项
+
+1. **时间格式**：所有时间参数使用 `YYYY-MM-DD HH:mm:ss` 格式，用户说"明天"、"下周一"等相对时间时，根据当前日期推算具体日期
+
+2. **状态值含义**
+   - 待办状态（`todo_status`）：`0`-已完成，`1`-进行中，`2`-已删除
+   - 用户状态（`user_status`）：`0`-拒绝，`1`-接受，`2`-已完成
+
+3. **错误处理**：若 `errcode` 不为 `0`，告知用户 `errmsg` 中的错误信息
+
+4. **必须查详情**：本接口返回的是概要信息（不含内容和分派人），拿到列表后必须紧接着调用 `wecom-get-todo-detail` 获取完整内容再展示给用户，不要只展示列表概要
+
+5. **分页未拉完必须提醒**：如果返回的 `has_more` 为 `true`，在向用户展示结果时必须明确说明"还有更多待办未显示"并询问用户是否需要继续查看。用户不知道后面还有数据，不提醒会导致遗漏

package/skills/wecom-meeting-create/SKILL.md

@@ -0,0 +1,158 @@
+---
+name: wecom-meeting-create
+description: 企业微信会议创建技能, 支持创建预约会议. 当用户需要"创建会议", "预约会议", "约会议", "安排会议"时触发.
+---
+# 企业微信会议创建技能
+
+> `wecom_mcp` 是一个 MCP tool，所有操作通过调用该 tool 完成。
+
+> ⚠️ **前置条件**：首次调用 `wecom_mcp` 前，必须按 `wecom-preflight` 技能执行前置条件检查，确保工具已加入白名单。
+
+## 概述
+
+wecom-meeting-create 提供企业微信预约会议的创建能力, 支持设置会议参数, 邀请参与人等.
+
+## 命令调用方式
+
+查看可用命令列表：使用 `wecom_mcp` tool 调用 `wecom_mcp list meeting`
+
+执行指定命令：使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting <tool_name> '<json_params>'`
+
+---
+
+## 命令详细说明
+
+### 创建预约会议 (create_meeting)
+
+创建一个预约会议, 支持设置会议参数配置等.
+
+#### 执行命令
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting create_meeting '{"title": "<会议标题>", "meeting_start_datetime": "<会议开始时间>", "meeting_duration": <会议持续时长(秒)>}'`
+
+#### 入参说明
+
+| 参数                       | 类型    | 必填 | 说明                                              |
+| -------------------------- | ------- | ---- | ------------------------------------------------- |
+| `title`                  | string  | 是   | 会议标题                                          |
+| `meeting_start_datetime` | string  | 是   | 会议开始时间, 格式:`YYYY-MM-DD HH:mm`           |
+| `meeting_duration`       | integer | 是   | 会议持续时长 (秒), 例如 3600 = 1 小时             |
+| `description`            | string  | 否   | 会议描述                                          |
+| `location`               | string  | 否   | 会议地点                                          |
+| `invitees`               | object  | 是   | 被邀请人, 格式:`{"userid": ["lisi", "wangwu"]}` |
+| `settings`               | object  | 否   | 会议设置 (详见下方)                               |
+
+> 被邀请人 userid 通过 `wecom-contact-lookup` 技能获取
+
+**settings 字段:**
+
+| 参数                        | 类型    | 说明                                          |
+| --------------------------- | ------- | --------------------------------------------- |
+| `password`                | string  | 会议密码                                      |
+| `enable_waiting_room`     | boolean | 是否启用等候室                                |
+| `allow_enter_before_host` | boolean | 是否允许成员在主持人进入前加入                |
+| `enable_enter_mute`       | integer | 入会时静音设置 (枚举: 0: 关闭, 1: 开启)       |
+| `allow_external_user`     | boolean | 是否允许外部用户入会                          |
+| `enable_screen_watermark` | boolean | 是否开启屏幕水印                              |
+| `remind_scope`            | integer | 提醒范围 (1: 不提醒, 2: 仅提醒主持人, 3: 提醒所有成员, 4: 指定部分人响铃, 默认仅提醒主持人) |
+| `ring_users`              | object  | 响铃用户, 格式:`{"userid": ["lisi"]}`   |
+
+> 响铃用户 userid 通过 `wecom-contact-lookup` 技能获取
+
+#### 返回参数
+
+```json
+{
+  "errcode": 0,
+  "errmsg": "ok",
+  "meetingid": "会议ID字符串",
+  "meeting_code": "会议号码字符串",
+  "meeting_link": "会议链接URL",
+  "excess_users": ["无效会议账号的userid"]
+}
+```
+
+| 字段             | 类型   | 说明                                                                                                               |
+| ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------ |
+| `meetingid`    | string | 会议 ID                                                                                                            |
+| `meeting_code` | string | 会议号码, 向用户展示时需在回复**开头**单独一行纯文字展示, 格式 `#会议号: xxx-xxx-xxx` (每3位用 `-` 分隔) |
+| `meeting_link` | string | 会议链接                                                                                                           |
+| `excess_users` | array  | 参会人中包含无效会议账号的 userid, 仅在购买会议专业版企业由于部分参会人无有效会议账号时返回                        |
+
+---
+
+## 典型工作流
+
+### 工作流 1: 最简创建 (无邀请人)
+
+**用户意图**: "帮我约一个明天下午3点的会议, 主题是周例会, 时长1小时"
+
+**步骤:**
+
+1. **解析用户意图**: 时间 + 主题已有, 邀请人未提及则默认留空, 直接创建.
+2. **调用创建命令**:
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting create_meeting '{"title": "周例会", "meeting_start_datetime": "2026-03-18 15:00", "meeting_duration": 3600}'`
+
+3. **展示结果**:
+
+#会议号: <会议号>
+
+```
+✅ 会议创建成功!
+
+📅 <会议标题>
+🕐 时间: <开始时间>, 时长 <时长>
+🔗 会议链接: <会议链接>
+```
+
+### 工作流 2: 带邀请人 + 地点 + 描述
+
+**用户意图**: "帮我约一个明天下午3点的会议, 主题是技术方案评审, 邀请张三和李四, 地点在3楼会议室, 时长1小时"
+
+**步骤:**
+
+1. **解析用户意图**: 有邀请人, 需先查询通讯录获取 userid.
+2. **通讯录查询**: 调用 `wecom-contact-lookup` 技能获取通讯录成员, 按姓名筛选出参与者的 userid.
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call contact get_userlist '{}'`
+
+在返回的 `userlist` 中筛选 `name` 包含 "张三" 和 "李四" 的成员, 获取其 `userid`.
+
+3. **信息已充分, 直接调用创建命令** (禁止暴露内部 ID):
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting create_meeting '{"title": "技术方案评审", "meeting_start_datetime": "2026-03-18 15:00", "meeting_duration": 3600, "location": "3楼会议室", "invitees": {"userid": ["zhangsan", "lisi"]}}'`
+
+4. **展示结果**:
+
+#会议号: <会议号>
+
+```
+✅ 会议创建成功!
+
+📅 <会议标题>
+🕐 时间: <开始时间>, 时长 <时长>
+👥 参与人: <参与者姓名列表>
+🔗 会议链接: <会议链接>
+```
+
+---
+
+## 复杂场景样例
+
+按场景按需加载, 避免一次性引入过多无关示例:
+
+| 文件 | 适用场景 |
+| ---- | -------- |
+| [references/example-security.md](references/example-security.md) | 会议密码, 等候室, 外部用户限制 |
+| [references/example-reminder.md](references/example-reminder.md) | 响铃提醒, 指定部分人响铃 |
+| [references/example-full.md](references/example-full.md) | 全参数综合场景 (含静音, 屏幕水印, 等候室等设置) |
+
+---
+
+## 注意事项
+
+- **信息追问**: 缺少时间或主题时, 简洁追问用户; 未提及邀请人则默认留空
+- **通讯录查询**: 涉及参与人时, 需先通过 `wecom-contact-lookup` 技能的 `get_userlist` 接口获取全量通讯录成员, 再按姓名/别名本地筛选匹配出对应的 `userid`. 该接口无入参, 返回当前用户可见范围内的成员列表 (含 `userid`, `name`, `alias`)
+- **直接创建**: 时间 + 主题已知即可直接创建, 邀请人有则带上, 无则留空; 无论信息是一次性提供还是上下文可推断, 非必要则均不请求确认, 直接创建即可
+- **时间格式**: 统一使用 `YYYY-MM-DD HH:mm` 格式

package/skills/wecom-meeting-create/references/example-full.md

@@ -0,0 +1,30 @@
+# 创建会议 - 全参数综合场景示例
+
+## 场景 1: 高规格会议 (全参数)
+
+**用户意图**: "帮我创建一个高规格的季度战略会议: 下周一上午9点, 时长4小时, 邀请全团队, 设置密码, 开启等候室, 开启屏幕水印, 全员静音"
+
+```json
+{
+  "title": "Q2季度战略规划会",
+  "meeting_start_datetime": "2026-03-23 09:00",
+  "meeting_duration": 14400,
+  "description": "Q2季度战略规划, 请各部门负责人提前准备汇报材料",
+  "location": "总部大会议室",
+  "invitees": {
+    "userid": ["zhangsan", "lisi", "wangwu", "zhaoliu", "sunqi"]
+  },
+  "settings": {
+    "password": "2026",
+    "enable_waiting_room": true,
+    "allow_enter_before_host": false,
+    "enable_enter_mute": 1,
+    "allow_external_user": false,
+    "enable_screen_watermark": true,
+    "remind_scope": 3,
+    "ring_users": {
+      "userid": ["zhangsan", "lisi", "wangwu", "zhaoliu", "sunqi"]
+    }
+  }
+}
+```

package/skills/wecom-meeting-create/references/example-reminder.md

@@ -0,0 +1,46 @@
+# 创建会议 - 响铃提醒场景示例
+
+## 场景 2: 仅提醒主持人 + 提前提醒时间
+
+**用户意图**: "帮我创建一个会议, 只提醒主持人, 并在会议开始前15分钟和1小时各提醒一次"
+
+```json
+{
+  "title": "项目启动会",
+  "meeting_start_datetime": "2026-03-21 10:00",
+  "meeting_duration": 3600,
+  "invitees": {
+    "userid": ["zhangsan", "lisi"]
+  },
+  "settings": {
+    "remind_scope": 2,
+    "ring_users": {
+      "userid": ["zhangsan"]
+    }
+  }
+}
+```
+
+---
+
+## 场景 3: 指定部分人响铃 (remind_scope=4)
+
+**用户意图**: "帮我创建一个会议, 只响铃提醒张三和李四, 其他人不提醒"
+
+```json
+{
+  "title": "紧急故障复盘",
+  "meeting_start_datetime": "2026-03-18 20:00",
+  "meeting_duration": 3600,
+  "invitees": {
+    "userid": ["zhangsan", "lisi", "wangwu", "zhaoliu"]
+  },
+  "settings": {
+    "remind_scope": 4,
+    "ring_users": {
+      "userid": ["zhangsan", "lisi"]
+    },
+    "allow_enter_before_host": true
+  }
+}
+```

package/skills/wecom-meeting-create/references/example-security.md

@@ -0,0 +1,22 @@
+# 创建会议 - 安全设置场景示例
+
+## 场景 4: 会议密码 + 等候室 + 主持人设置
+
+**用户意图**: "帮我创建一个重要的客户汇报会议, 需要设置密码1234, 开启等候室, 不允许外部人员入会"
+
+```json
+{
+  "title": "客户汇报会议",
+  "meeting_start_datetime": "2026-03-19 14:00",
+  "meeting_duration": 5400,
+  "invitees": {
+    "userid": ["zhangsan", "lisi", "wangwu"]
+  },
+  "settings": {
+    "password": "1234",
+    "enable_waiting_room": true,
+    "allow_enter_before_host": false,
+    "allow_external_user": false
+  }
+}
+```

package/skills/wecom-meeting-manage/SKILL.md

@@ -0,0 +1,136 @@
+---
+name: wecom-meeting-manage
+description: 企业微信会议管理技能, 支持取消会议和更新会议受邀成员. 当用户需要"取消会议", "删除会议", "修改会议成员", "添加会议参与人", "移除会议成员"时触发.
+---
+# 企业微信会议管理技能
+
+> `wecom_mcp` 是一个 MCP tool，所有操作通过调用该 tool 完成。
+
+> ⚠️ **前置条件**：首次调用 `wecom_mcp` 前，必须按 `wecom-preflight` 技能执行前置条件检查，确保工具已加入白名单。
+
+## 概述
+
+wecom-meeting-manage 提供企业微信会议管理能力, 包含以下功能:
+
+1. **取消会议** - 取消指定的预约会议
+2. **更新会议受邀成员** - 修改会议的参与人列表
+
+## 命令调用方式
+
+查看可用命令列表：使用 `wecom_mcp` tool 调用 `wecom_mcp list meeting`
+
+调用指定命令：使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting <tool_name> '<json_params>'`
+
+---
+
+## 命令详细说明
+
+### 1. 取消会议 (cancel_meeting)
+
+取消指定的预约会议.
+
+#### 调用命令
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting cancel_meeting '{"meetingid": "<会议id>"}'`
+
+#### 入参说明
+
+| 参数              | 类型   | 必填 | 说明                               |
+| ----------------- | ------ | ---- | ---------------------------------- |
+| `meetingid`     | string | 是   | 会议 ID, 通过 `wecom-meeting-query` 技能获取 |
+
+#### 返回参数
+
+```json
+{
+  "errcode": 0,
+  "errmsg": "ok"
+}
+```
+
+---
+
+### 2. 更新会议受邀成员 (set_invite_meeting_members)
+
+更新会议的受邀成员列表 (全量覆盖).
+
+#### 调用命令
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting set_invite_meeting_members '{"meetingid": "<会议id>", "invitees": [{"userid": "lisi"}, {"userid": "wangwu"}]}'`
+
+#### 入参说明
+
+| 参数          | 类型   | 必填 | 说明                                   |
+| ------------- | ------ | ---- | -------------------------------------- |
+| `meetingid` | string | 是   | 会议 ID, 通过 `wecom-meeting-query` 技能获取                          |
+| `invitees`  | array  | 否   | 受邀成员列表, 每项包含 `userid` 字段 |
+
+> **注意**: invitees 为全量覆盖, 传入的列表将替换现有成员列表.
+> invitees 的 userid 通过 `wecom-contact-lookup` 技能获取
+
+#### 返回参数
+
+```json
+{
+  "errcode": 0,
+  "errmsg": "ok"
+}
+```
+
+---
+
+## 典型工作流
+
+### 工作流 1: 取消会议
+
+**示例**: 用户说 "帮我取消明天的技术方案评审会议"
+
+**步骤:**
+
+1. **定位会议**: 通过 `wecom-meeting-query` 技能查询会议列表 + 关键词匹配找到目标会议.
+2. **直接执行取消**:
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting cancel_meeting '{"meetingid": "<target_meetingid>"}'`
+
+4. **展示结果**:
+
+```
+✅ 会议已取消: 技术方案评审
+```
+
+---
+
+### 工作流 2: 更新会议成员
+
+**示例**: 用户说 "把王五加到技术方案评审会议里"
+
+**步骤:**
+
+1. **定位会议**: 通过 `wecom-meeting-query` 技能查询会议列表 + 匹配找到目标会议.
+2. **获取当前受邀成员**: `set_invite_members` 为全量覆盖, 必须先通过 `wecom-meeting-query` 技能的 `get_meeting_info` 获取会议详情, 获取现有成员后再合并.
+3. **通讯录查询**: 调用 `wecom-contact-lookup` 技能获取通讯录成员, 按姓名筛选出王五的 userid.
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call contact get_userlist '{}'`
+
+在返回的 `userlist` 中筛选 `name` 包含 "王五" 的成员, 获取其 `userid`.
+
+4. **合并成员列表**: 将现有成员 + 新增成员合并 (全量覆盖).
+5. **执行更新**:
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call meeting set_invite_meeting_members '{"meetingid": "<target_meetingid>", "invitees": [{"userid": "zhangsan"}, {"userid": "lisi"}, {"userid": "wangwu"}]}'`
+
+7. **展示结果**:
+
+```
+✅ 会议成员已更新: 技术方案评审
+👥 当前成员: 张三, 李四, 王五
+```
+
+---
+
+## 注意事项
+
+- **参与人仅支持企业内成员**, 不支持外部人员
+- **通讯录查询**: 涉及参与人时, 需先通过 `wecom-contact-lookup` 技能的 `get_userlist` 接口获取全量通讯录成员, 再按姓名/别名本地筛选匹配出对应的 `userid`. 该接口无入参, 返回当前用户可见范围内的成员列表 (含 `userid`, `name`, `alias`)
+- **定位会议**: 管理操作需先通过 `wecom-meeting-query` 技能查询到目标会议的 meetingid
+- **成员更新为全量覆盖**: `set_invite_members` 传入的列表将替换现有成员列表, 需先获取当前成员再合并