wecomcli-get-meeting

企业微信会议查询技能, 支持查询会议列表, 获取会议详情, 按关键词查找会议. 当用户需要"查看会议", "查询会议列表", "会议详情", "什么时候开会", "有哪些会议", "查找会议"时触发.

1,354 stars

Best use case

wecomcli-get-meeting is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

企业微信会议查询技能, 支持查询会议列表, 获取会议详情, 按关键词查找会议. 当用户需要"查看会议", "查询会议列表", "会议详情", "什么时候开会", "有哪些会议", "查找会议"时触发.

Teams using wecomcli-get-meeting should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/wecomcli-get-meeting/SKILL.md --create-dirs "https://raw.githubusercontent.com/WecomTeam/wecom-cli/main/skills/wecomcli-get-meeting/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/wecomcli-get-meeting/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How wecomcli-get-meeting Compares

Feature / Agentwecomcli-get-meetingStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

企业微信会议查询技能, 支持查询会议列表, 获取会议详情, 按关键词查找会议. 当用户需要"查看会议", "查询会议列表", "会议详情", "什么时候开会", "有哪些会议", "查找会议"时触发.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 企业微信会议查询技能

> `wecom-cli` 是企业微信提供的命令行程序,所有操作通过执行 `wecom-cli` 命令完成。


## 概述

wecomcli-get-meeting 提供企业微信会议查询能力, 包含以下功能:

1. **查询会议列表** - 按用户和时间范围查询会议 ID 列表 (限制: 当日及前后 30 天, 上限 100 个)
2. **获取会议详情** - 通过会议 ID 查询完整会议信息

## 命令调用方式

执行指定命令:
```bash
wecom-cli meeting <tool_name> '<json_params>'
```
---

## 命令详细说明

### 1. 查询会议列表 (list_user_meetings)

查询指定用户在时间范围内的会议 ID 列表.

#### 执行命令

```bash
wecom-cli meeting list_user_meetings '{"begin_datetime": "2026-03-01 00:00", "end_datetime": "2026-03-31 23:59", "limit": 100}'
```

#### 入参说明

| 参数               | 类型    | 必填 | 说明                                    |
| ------------------ | ------- | ---- | --------------------------------------- |
| `begin_datetime` | string  | 否   | 查询起始时间, 格式:`YYYY-MM-DD HH:mm` |
| `end_datetime`   | string  | 否   | 查询结束时间, 格式:`YYYY-MM-DD HH:mm` |
| `cursor`         | string  | 否   | 分页游标, 用于获取下一页数据            |
| `limit`          | integer | 否   | 每页返回条数, 最大 100                  |

> **限制**: 时间范围仅支持当日及前后 30 天.

#### 返回参数

```json
{
  "errcode": 0,
  "errmsg": "ok",
  "next_cursor": "分页游标字符串, 为空表示无更多",
  "meetingid_list": ["会议ID_1", "会议ID_2"]
}
```

| 字段               | 类型   | 说明                           |
| ------------------ | ------ | ------------------------------ |
| `meetingid_list` | array  | 会议 ID 列表                   |
| `next_cursor`    | string | 下一页游标, 为空表示无更多数据 |

---

### 2. 获取会议详情 (get_meeting_info)

通过会议 ID 查询会议的完整详情.

#### 执行命令

```bash
wecom-cli meeting get_meeting_info '{"meetingid": "<会议id>"}'
```

#### 入参说明

| 参数              | 类型   | 必填 | 说明            |
| ----------------- | ------ | ---- | --------------- |
| `meetingid`     | string | 是   | 会议 ID, 通过 `list_user_meetings` 获取 |
| `meeting_code`  | string | 否   | 会议号码        |
| `sub_meetingid` | string | 否   | 子会议 ID       |

#### 返回参数

```json
{
  "errcode": 0,
  "errmsg": "ok",
  "creator_userid": "创建者userid",
  "admin_userid": "会议管理userid (与 creator_userid 有且仅返回一个)",
  "title": "会议标题",
  "meeting_start_datetime": "YYYY-MM-DD HH:mm",
  "meeting_duration": 会议时长秒数,
  "description": "会议描述文本",
  "location": "会议地点文本",
  "main_department": 创建者主部门ID,
  "status": 会议状态枚举值,
  "meeting_type": 会议类型枚举值,
  "attendees": {
    "member": [
      {
        "userid": "内部成员userid",
        "status": 与会状态枚举值,
        "first_join_datetime": "YYYY-MM-DD HH:mm",
        "last_quit_datetime": "YYYY-MM-DD HH:mm",
        "total_join_count": 加入次数,
        "cumulative_time": 累计在会时长秒数
      }
    ],
    "tmp_external_user": [
      {
        "tmp_external_userid": "外部临时用户ID",
        "status": 与会状态枚举值,
        "first_join_datetime": "YYYY-MM-DD HH:mm",
        "last_quit_datetime": "YYYY-MM-DD HH:mm",
        "total_join_count": 加入次数,
        "cumulative_time": 累计在会时长秒数
      }
    ]
  },
  "settings": {
    "remind_scope": 提醒范围枚举值,
    "need_password": 是否需要密码布尔值,
    "password": "会议密码",
    "enable_waiting_room": 是否启用等候室布尔值,
    "allow_enter_before_host": 是否允许提前入会布尔值,
    "enable_enter_mute": 入会静音枚举值,
    "allow_unmute_self": 是否允许自我解除静音布尔值,
    "allow_external_user": 是否允许外部用户布尔值,
    "enable_screen_watermark": 是否开启水印布尔值,
    "watermark_type": 水印类型枚举值,
    "auto_record_type": "录制类型枚举字符串",
    "attendee_join_auto_record": 参会者加入自动录制布尔值,
    "enable_host_pause_auto_record": 主持人可暂停录制布尔值,
    "enable_doc_upload_permission": 允许上传文档布尔值,
    "enable_enroll": 是否开启报名布尔值,
    "enable_host_key": 是否启用主持人密钥布尔值,
    "host_key": "主持人密钥字符串",
    "hosts": {"userid": ["主持人userid列表"]},
    "current_hosts": {"userid": ["当前主持人userid列表"]},
    "co_hosts": {"userid": ["联席主持人userid列表"]},
    "ring_users": {"userid": ["响铃用户userid列表"]}
  },
  "meeting_code": "会议号码字符串",
  "meeting_link": "会议链接URL",
  "has_vote": 是否有投票布尔值,
  "has_more_sub_meeting": 是否有更多子会议枚举值,
  "remain_sub_meetings": 剩余子会议场数,
  "current_sub_meetingid": "当前子会议ID",
  "guests": [
    {
      "area": "国际区号",
      "phone_number": "手机号字符串",
      "guest_name": "嘉宾姓名"
    }
  ],
  "reminders": {
    "is_repeat": 是否周期性枚举值,
    "repeat_type": 重复类型枚举值,
    "repeat_until_type": 结束类型枚举值,
    "repeat_until_count": 限定次数,
    "repeat_until_datetime": "YYYY-MM-DD HH:mm",
    "repeat_interval": 重复间隔数值,
    "is_custom_repeat": 是否自定义重复枚举值,
    "repeat_day_of_week": [星期几数组],
    "repeat_day_of_month": [日期数组],
    "remind_before": [提醒秒数数组]
  },
  "sub_meetings": [
    {
      "sub_meetingid": "子会议ID",
      "status": 子会议状态枚举值,
      "start_datetime": "YYYY-MM-DD HH:mm",
      "end_datetime": "YYYY-MM-DD HH:mm",
      "title": "子会议标题",
      "repeat_id": "周期性会议分段ID"
    }
  ],
  "sub_repeat_list": [
    {
      "repeat_id": "周期性会议分段ID",
      "repeat_type": 重复类型枚举值,
      "repeat_until_type": 结束类型枚举值,
      "repeat_until_count": 限定次数,
      "repeat_until_datetime": "YYYY-MM-DD HH:mm",
      "repeat_interval": 重复间隔数值,
      "is_custom_repeat": 是否自定义重复枚举值,
      "repeat_day_of_week": [星期几数组],
      "repeat_day_of_month": [日期数组]
    }
  ]
}
```

**关键返回字段:**

| 字段                                      | 类型    | 说明                                                                                                          |
| ----------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------- |
| `creator_userid`                        | string  | 创建者 userid, 与 `admin_userid` 有且仅返回一个                                                             |
| `admin_userid`                          | string  | 会议管理 userid, 与 `creator_userid` 有且仅返回一个                                                         |
| `title`                                 | string  | 会议标题                                                                                                      |
| `meeting_start_datetime`                | string  | 会议开始时间                                                                                                  |
| `meeting_duration`                      | integer | 会议时长 (秒)                                                                                                 |
| `main_department`                       | integer | 创建者所属主部门                                                                                              |
| `status`                                | integer | 会议状态 (1: 待开始, 2: 会议中, 3: 已结束, 4: 已取消, 5: 已过期)                                              |
| `meeting_type`                          | integer | 会议类型 (0: 一次性会议, 1: 周期性会议, 2: 微信专属会议, 3: Rooms 投屏会议, 5: 个人会议号会议, 6: 网络研讨会) |
| `meeting_code`                          | string  | 会议号码                                                                                                      |
| `meeting_link`                          | string  | 会议链接                                                                                                      |
| `attendees.member`                      | array   | 内部参与者列表                                                                                                |
| `attendees.member[].status`             | integer | 与会状态 (1: 已参与, 2: 未参与)                                                                               |
| `attendees.tmp_external_user`           | array   | 外部参与者 (临时 ID)                                                                                          |
| `attendees.tmp_external_user[].status`  | integer | 与会状态 (1: 已参与, 2: 未参与)                                                                               |
| `guests`                                | array   | 外部嘉宾列表, 每项含 `area`, `phone_number`, `guest_name`                                               |
| `current_sub_meetingid`                 | string  | 当前子会议 ID                                                                                                 |
| `settings.ring_users`                   | object  | 响铃用户列表                                                                                                  |
| `settings.need_password`                | boolean | 是否需要密码 (只读字段)                                                                                       |
| `settings.enable_doc_upload_permission` | boolean | 是否允许成员上传文档                                                                                          |
| `settings.hosts`                        | object  | 主持人列表                                                                                                    |
| `settings.current_hosts`                | object  | 当前主持人列表                                                                                                |
| `settings.co_hosts`                     | object  | 联席主持人列表                                                                                                |
| `reminders`                             | object  | 周期性配置                                                                                                    |
| `has_vote`                              | boolean | 是否有投票 (仅会议创建人和主持人有权限查询)                                                                   |
| `has_more_sub_meeting`                  | integer | 是否还有更多子会议特例 (0: 无更多, 1: 有更多)                                                                 |
| `remain_sub_meetings`                   | integer | 剩余子会议场数                                                                                                |
| `sub_meetings`                          | array   | 子会议列表                                                                                                    |
| `sub_meetings[].status`                 | integer | 子会议状态 (0: 默认/存在, 1: 已删除)                                                                          |
| `sub_meetings[].repeat_id`              | string  | 周期性会议分段 ID, 用于关联子会议所属分段                                                                     |
| `sub_repeat_list`                       | array   | 周期性会议分段信息, 修改周期性会议某一场后可能产生不同分段, 各分段有不同重复规则                              |

---

## 典型工作流

### 工作流 1: 查询会议列表

**示例**: 用户说 "帮我查一下本周有哪些会议"

**步骤:**

1. **确定时间范围**: 根据当前日期计算本周的起止时间.
2. **查询会议 ID 列表**:

```bash
wecom-cli meeting list_user_meetings '{"begin_datetime": "2026-03-16 00:00", "end_datetime": "2026-03-22 23:59", "limit": 100}'
```

3. **逐个查询会议详情** (对返回的每个 meetingid):

```bash
wecom-cli meeting get_meeting_info '{"meetingid": "<会议id1>"}'
```
```bash
wecom-cli meeting get_meeting_info '{"meetingid": "<会议id2>"}'
```

4. **汇总展示**:

```
📋 本周会议列表 (共 3 场):

1. 📅 技术方案评审
   🕐 2026-03-17 10:00 - 11:00
   👥 张三, 李四, 王五

2. 📅 产品需求沟通
   🕐 2026-03-18 14:00 - 15:00
   👥 赵六, 钱七

3. 📅 周五周会
   🕐 2026-03-21 09:00 - 10:00
   👥 全组成员
```

> **分页处理**: 如果 `next_cursor` 不为空, 使用 `cursor` 参数继续拉取下一页.

---

### 工作流 2: 获取会议详情

**示例**: 用户说 "帮我看下技术方案评审会议的详情"

**步骤:**

1. **定位会议**: 先通过会议列表查询找到目标会议的 meetingid (按关键词匹配).
2. **查询详情**:

```bash
wecom-cli meeting get_meeting_info '{"meetingid": "<target_meetingid>"}'
```

3. **展示结果**:

#会议号: <会议号>

```
📅 <会议标题>

🕐 时间: <开始时间>, 时长 <时长>
📍 地点: <会议地点>
📝 描述: <会议描述>
👤 创建者: <创建者姓名>
👥 参与者: <参与者姓名列表>
🔗 会议链接: <会议链接>
```

---

### 工作流 3: 根据关键词查找会议

**示例**: 用户说 "技术评审会议是什么时候?"

**查询策略:**

1. **确定查询范围**: 默认查当日前后 30 天 (接口限制范围).
2. **拉取会议列表**:

```bash
wecom-cli meeting list_user_meetings '{"begin_datetime": "2026-02-15 00:00", "end_datetime": "2026-04-16 23:59", "limit": 100}'
```

3. **逐个查询详情并匹配标题关键词**.
4. **找到匹配后停止查询, 展示结果**:

#会议号: <会议号>

```
✅ 找到会议: "<会议标题>"

📅 时间: <开始时间>, 时长 <时长>
📍 地点: <会议地点>
👥 参与者: <参与者姓名列表>
🔗 会议链接: <会议链接>
```

5. **未找到处理**: 告知用户在前后 30 天范围内未找到匹配会议, 请确认会议名称.

---

## 注意事项

- **时间格式**: 统一使用 `YYYY-MM-DD HH:mm` 格式
- **会议列表时间范围限制**: 仅支持查询当日及前后 30 天内的会议
- **查询详情需两步**: 先通过 `list_user_meetings` 获取会议 ID 列表, 再通过 `get_meeting_info` 逐个获取详情

Related Skills

wecomcli-todo

1387
from WecomTeam/wecom-cli

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

wecomcli-schedule

1387
from WecomTeam/wecom-cli

企业微信日程管理技能。适用于用户对企业微信日程的各类管理需求。当用户需要:(1) 查询指定时间范围内的日程列表或获取日程详细信息(标题、时间、地点、参与者等),(2) 创建新日程并设置提醒、参与人等,(3) 修改已有日程的标题、时间、地点等信息或取消日程,(4) 添加或移除日程参与人,(5) 查询多个成员的闲忙状态并分析共同空闲时段以安排会议时使用此技能。

wecomcli-msg

1387
from WecomTeam/wecom-cli

企业微信消息技能。提供会话列表查询、消息记录拉取(支持文本/图片/文件/语音/视频)、多媒体文件获取和文本消息发送能力。当用户需要"查看消息"、"看聊天记录"、"发消息给某人"、"最近有什么消息"、"给群里发消息"、"看看发了什么图片/文件"时触发。

wecomcli-meeting

1387
from WecomTeam/wecom-cli

企业微信会议技能,支持创建预约会议、查询会议列表、获取会议详情、取消会议、更新会议成员。当用户需要"创建会议"、"预约会议"、"约会议"、"安排会议"、"查看会议"、"查询会议列表"、"会议详情"、"什么时候开会"、"有哪些会议"、"查找会议"、"取消会议"、"删除会议"、"修改会议成员"、"添加会议参与人"、"移除会议成员"时触发。

wecomcli-doc

1387
from WecomTeam/wecom-cli

企业微信文档与智能表格管理技能。提供文档的创建、读取、编辑能力,以及智能表格的结构管理(子表、字段)和数据管理(记录增删改查)。适用场景:(1) 以 Markdown 格式获取文档完整内容 (2) 新建文档或智能表格 (3) 用 Markdown 格式覆写文档内容 (4) 管理智能表格子表和字段/列 (5) 查询、添加、更新、删除智能表格记录。支持通过 docid 或文档 URL 定位文档。

wecomcli-contact

1387
from WecomTeam/wecom-cli

通讯录成员查询技能,获取当前用户可见范围内的通讯录成员,支持按姓名/别名本地筛选匹配。返回 userid、姓名和别名。⚠️ 仅返回当前用户有权限查看的成员,非全量成员。

wecomcli-manage-smartsheet-schema

1354
from WecomTeam/wecom-cli

企业微信智能表格结构管理技能。提供子表(Sheet)和字段(Field/列)的增删改查能力。适用场景:(1) 查询智能表格的子表列表 (2) 添加、更新、删除子表 (3) 查询子表的字段/列信息 (4) 添加、更新、删除字段/列。当用户需要管理智能表格的表结构、列定义、子表配置时触发此 Skill。支持通过 docid 或文档 URL 定位文档。

wecomcli-manage-smartsheet-data

1354
from WecomTeam/wecom-cli

企业微信智能表格数据(记录)管理技能。提供智能表格记录的增删改查能力。适用场景:(1) 查询子表全部记录 (2) 添加一行或多行记录 (3) 更新已有记录 (4) 删除记录。当用户需要读取表格数据、写入新数据、修改或删除表格行时触发此 Skill。支持通过 docid 或文档 URL 定位文档。

wecomcli-manage-schedule

1354
from WecomTeam/wecom-cli

企业微信日程管理技能。适用于用户对企业微信日程的各类管理需求。当用户需要:(1) 查询指定时间范围内的日程列表或获取日程详细信息(标题、时间、地点、参与者等),(2) 创建新日程并设置提醒、参与人等,(3) 修改已有日程的标题、时间、地点等信息或取消日程,(4) 添加或移除日程参与人,(5) 查询多个成员的闲忙状态并分析共同空闲时段以安排会议时使用此技能。

wecomcli-manage-doc

1354
from WecomTeam/wecom-cli

企业微信文档管理技能。提供文档的创建、读取和编辑能力,支持通过 docid 或文档 URL 操作企业微信文档(doc_type=3)和智能表格(doc_type=10)。适用场景:(1) 以 Markdown 格式导出获取文档完整内容(异步轮询) (2) 新建文档或智能表格 (3) 用 Markdown 格式覆写文档内容。当用户需要查看文档内容、创建新文档、编辑文档正文时触发此 Skill。

wecomcli-lookup-contact

1354
from WecomTeam/wecom-cli

通讯录成员查询技能,获取当前用户可见范围内的通讯录成员,支持按姓名/别名本地筛选匹配。返回 userid、姓名和别名。⚠️ 仅返回当前用户有权限查看的成员,非全量成员。

wecomcli-get-todo-list

1354
from WecomTeam/wecom-cli

企业微信待办列表查询技能,支持按创建时间和提醒时间过滤,支持分页。在用户说"看看我的待办列表"、"我有哪些待办"、"这周的待办有哪些"、"最近有什么待办"、"查一下我的待办"、"列出所有待办"等需要浏览待办概览的场景时使用。注意:此技能仅返回待办概要信息(不含内容和分派人),如需完整详情请配合 wecomcli-get-todo-detail 使用。