@wecom/wecom-openclaw-plugin 2026.7.2 → 2026.8.17-beta.1

package/skills/wecom-preflight/SKILL.md

@@ -1,141 +0,0 @@
----
-name: wecom-preflight
-description: 企业微信插件前置条件检查。在执行任何 wecom_mcp 操作前，通过 shell 命令检查工具权限配置（profile 和白名单），若缺失则自动修复并提示用户重启 Gateway。所有使用 wecom_mcp 的技能都应在首次调用前执行此检查。
----
-
-# 企业微信前置条件检查
-
-> 本技能确保 `wecom_mcp` 工具已正确获得执行权限。**所有使用 wecom_mcp 的技能在首次调用前，必须先执行本检查流程。**
-
-## 触发条件
-
-当满足以下**任一条件**时，执行前置检查：
-
-1. 当前会话中**首次**需要调用 `wecom_mcp` 工具
-2. 调用 `wecom_mcp` 时收到 `tool not allowed`、`not permitted`、`permission denied` 或类似权限错误
-
-> 如果当前会话中已成功调用过 `wecom_mcp`（任何操作），则无需重复检查。
-
----
-
-## 检查流程
-
-> **重要**：以下所有步骤均为 **shell 命令**（在终端中执行），**不是** MCP tool 调用。
-> `wecom_mcp` 在未加入白名单前对 AI Agent 不可见，因此不能用 tool 调用来探测。
-
-### 步骤 1：检查 tools.profile
-
-在终端执行以下命令，读取当前 `tools.profile` 配置：
-
-```bash
-openclaw config get tools.profile
-```
-
-根据返回结果分流：
-
-- **返回 `full`** → ✅ **检查通过**。`full` 模式无任何工具限制，所有工具（包括 `wecom_mcp`）直接可用，无需检查 `alsoAllow`，继续执行用户原始请求
-- **返回其他值**（如 `coding`、`messaging`、`minimal`、`undefined` 或空）→ 进入步骤 1b（检查 alsoAllow）
-- **命令执行失败**（如 `command not found: openclaw`、权限错误等）→ 进入步骤 3（环境异常）
-
-### 步骤 1b：检查 tools.alsoAllow
-
-在终端执行以下命令，读取当前 `tools.alsoAllow` 配置：
-
-```bash
-openclaw config get tools.alsoAllow
-```
-
-根据返回结果分流：
-
-- **返回内容包含 `wecom_mcp`**（如 `["wecom_mcp"]` 或 `["wecom_mcp", "other_tool"]`）→ ✅ 白名单已配置，检查通过，继续执行用户原始请求
-- **返回内容不包含 `wecom_mcp`**（如空数组 `[]`、`undefined`、或列表中没有 `wecom_mcp`）→ 进入步骤 2（自动修复）
-- **命令执行失败** → 进入步骤 3（环境异常）
-
----
-
-### 步骤 2：自动修复 tools.alsoAllow
-
-在终端执行以下命令，将 `wecom_mcp` 加入工具白名单：
-
-```bash
-openclaw config set tools.alsoAllow '["wecom_mcp"]'
-```
-
-> **注意**：如果步骤 1b 返回的列表中已有其他工具（如 `["other_tool"]`），需要合并后再写入，例如：
-> ```bash
-> openclaw config set tools.alsoAllow '["other_tool", "wecom_mcp"]'
-> ```
-
-根据执行结果分流：
-
-#### 2a. 命令执行成功
-
-向用户回复（**不要自动执行重启**）：
-
-```
-✅ 已自动将 wecom_mcp 加入工具执行权限白名单（tools.alsoAllow）。
-⚠️ 配置变更需要重启 Gateway 后才能生效，请在终端执行以下命令：
-
-openclaw gateway restart
-
-重启完成后请重新发送您的请求。
-```
-
-> **为什么不自动重启**：`openclaw gateway restart` 会中断当前所有活跃连接（包括本会话），
-> 如果由 AI 自动执行，用户可能无法看到完整的提示信息。交由用户手动重启更可控。
-
-#### 2b. 命令执行失败
-
-向用户回复以下手动修复指引：
-
-```
-❌ 自动配置失败，请在终端手动执行以下命令：
-
-openclaw config set tools.alsoAllow '["wecom_mcp"]'
-openclaw gateway restart
-
-完成后请重新发送您的请求。
-```
-
----
-
-### 步骤 3：环境异常处理
-
-如果步骤 1 或 1b 的 `openclaw` 命令本身执行失败（如 `command not found`、权限不足等），说明 OpenClaw CLI 未正确安装或不在 PATH 中，直接告知用户：
-
-```
-⚠️ OpenClaw CLI 不可用：<错误信息>
-
-可能原因：
-- OpenClaw 未安装或未加入系统 PATH
-- OpenClaw 版本过低，不支持 config 子命令
-- 当前 shell 环境缺少必要配置
-
-请检查 OpenClaw 安装状态后重试。
-参考：https://docs.openclaw.dev/installation
-```
-
----
-
-## 注意事项
-
-1. **全程使用 shell 命令**：本技能的所有探测和修复操作均通过 `openclaw` CLI 在终端中执行，**不涉及任何 MCP tool 调用**。这样可以避免"tool 未白名单 → tool 不可见 → 无法探测"的死锁问题
-2. **profile 优先判断**：`tools.profile` 为 `full` 时所有工具无限制，无需检查 `alsoAllow`，可快速跳过
-3. **幂等性**：如果 `tools.alsoAllow` 中已包含 `wecom_mcp`，`openclaw config set` 命令不会产生副作用
-4. **保留已有配置**：修改 `tools.alsoAllow` 时，需保留列表中已有的其他工具名，仅追加 `wecom_mcp`
-5. **不自动重启**：自动配置成功后仅提示用户重启并附上命令，由用户手动执行，避免会话中断导致信息丢失
-6. **会话缓存**：在同一个会话中，一旦检查通过（profile 为 full 或 alsoAllow 包含 wecom_mcp），后续调用无需重复检查
-
----
-
-## 快速参考
-
-| 场景 | 处理方式 |
-|------|---------|
-| 首次调用 wecom_mcp 前 | 执行 `openclaw config get tools.profile` 检查 |
-| `tools.profile` 为 `full` | ✅ 跳过，直接执行原始请求 |
-| profile 非 full + alsoAllow 已包含 wecom_mcp | ✅ 跳过，继续执行 |
-| profile 非 full + alsoAllow 不包含 → 自动写入成功 | 提示已配置 + 附 `openclaw gateway restart` 命令让用户重启 |
-| profile 非 full + alsoAllow 不包含 → 自动写入失败 | 给出手动修复指引 |
-| openclaw CLI 不可用 | 告知用户检查 OpenClaw 安装 |
-| 会话中已成功调用过 wecom_mcp | 跳过检查 |

package/skills/wecom-schedule/SKILL.md

@@ -1,161 +0,0 @@
----
-name: wecom-schedule
-description: 企业微信日程管理技能。适用于用户对企业微信日程的各类管理需求。当用户需要：(1) 查询指定时间范围内的日程列表或获取日程详细信息（标题、时间、地点、参与者等），(2) 创建新日程并设置提醒、参与人等，(3) 修改已有日程的标题、时间、地点等信息或取消日程，(4) 添加或移除日程参与人，(5) 查询多个成员的闲忙状态并分析共同空闲时段以安排会议时使用此技能。
-metadata:
-  {
-    "openclaw": { "emoji": "📅" },
-  }
----
-
-# 企业微信日程管理技能
-
-> `wecom_mcp` 是一个 MCP tool，所有操作通过调用该 tool 完成。
-
-> ⚠️ **前置条件**：首次调用 `wecom_mcp` 前，必须按 `wecom-preflight` 技能执行前置条件检查，确保工具已加入白名单。
-
-通过 `wecom_mcp call schedule <接口名> '<json入参>'` 与企业微信日程系统交互。
-
-## 注意事项
-
-- 日程列表查询仅支持**当日前后 30 天**，时间格式 `YYYY-MM-DD` 或 `YYYY-MM-DD HH:MM:SS`
-- 涉及参与者 userid 时，需先使用 **wecom-contact** 技能获取；存在同名时展示候选让用户选择（禁止暴露 userid）
-- 创建/修改/取消前，先确认目标日程和参与者信息
-- `errcode != 0` 时展示错误信息；返回的 `start_time`/`end_time` 为 Unix 时间戳（秒），需转为可读格式
-- **注意时间格式转换**：接口入参使用字符串格式（如 `YYYY-MM-DD HH:MM:SS`），但返回值多为 Unix 时间戳，使用时需进行格式转换
-
----
-
-## 接口列表
-
-### get_schedule_list_by_range — 查询日程 ID 列表
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule get_schedule_list_by_range '{"start_time": "YYYY-MM-DD HH:MM:SS", "end_time": "YYYY-MM-DD HH:MM:SS"}'`
-
-返回 `schedule_id_list` 数组。仅支持当日前后 30 天。
-
-### get_schedule_detail — 获取日程详情
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule get_schedule_detail '{"schedule_id_list": ["SCHEDULE_ID_1", "SCHEDULE_ID_2"]}'`
-
-支持 1~50 个 ID，返回日程标题、时间、地点、参与者等。参见 [API 详情](references/api-get-schedule-detail.md)。
-
-### create_schedule — 创建日程
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule create_schedule '{"schedule": {"start_time": "YYYY-MM-DD HH:MM:SS", "end_time": "YYYY-MM-DD HH:MM:SS", "summary": "日程标题", "attendees": [{"userid": "USER_ID"}], "reminders": {"is_remind": 1, "remind_before_event_secs": 3600, "timezone": 8}}}'`
-
-参见 [API 详情](references/api-create-schedule.md) | [reminders 字段](references/ref-reminders.md)。
-
-### update_schedule — 修改日程
-
-只需传入需修改的字段，未传字段保持不变。
-
-> ⚠️ **重要**：如果要把全天日程变成普通日程并修改时间，则一定要把 `is_whole_day` 设置为 `0`，否则日程仍会保持全天状态。
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule update_schedule '{"schedule": {"schedule_id": "SCHEDULE_ID", "summary": "更新后的标题"}}'`
-
-参见 [API 详情](references/api-update-schedule.md)。
-
-### cancel_schedule — 取消日程
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule cancel_schedule '{"schedule_id": "SCHEDULE_ID"}'`
-
-### add_schedule_attendees / del_schedule_attendees — 管理参与人
-
-- 添加参与人：使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule add_schedule_attendees '{"schedule_id": "SCHEDULE_ID", "attendees": [{"userid": "USER_ID"}]}'`
-- 移除参与人：使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule del_schedule_attendees '{"schedule_id": "SCHEDULE_ID", "attendees": [{"userid": "USER_ID"}]}'`
-
-### check_availability — 查询闲忙
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule check_availability '{"check_user_list": ["USER_ID_1", "USER_ID_2"], "start_time": "YYYY-MM-DD HH:MM:SS", "end_time": "YYYY-MM-DD HH:MM:SS"}'`
-
-支持 1~10 个用户，返回各用户的忙碌时段列表。参见 [API 详情](references/api-check-availability.md)。
-
----
-
-## 典型工作流
-
-### 查询日程
-
-**经典 query 示例：**
-- "我今天有哪些日程？"
-- "帮我看看这周三下午有没有会议"
-- "明天的日程安排是什么？"
-- "查一下最近有没有关于项目评审的日程"
-- "我下周一到周五的日程都有哪些？"
-
-**流程：**
-1. 根据用户意图计算时间范围（如"今天"→当日 00:00:00 至 23:59:59，"这周"→本周一至周日）
-2. 调用 `get_schedule_list_by_range` 获取日程 ID 列表
-3. 调用 `get_schedule_detail` 批量获取详情，将 Unix 时间戳转为可读时间
-4. 若用户提到关键词（如"项目评审"），在 `summary` 中匹配筛选；未找到则逐步扩大范围至前后 30 天上限
-5. 展示日程列表时包含标题、时间、地点、参与者等关键信息，方便用户快速了解
-
-### 创建日程
-
-**经典 query 示例：**
-- "帮我创建一个明天下午 2 点到 3 点的会议，标题叫需求评审"
-- "安排一个周五全天的团建活动"
-- "创建日程：后天上午 10 点和张三、李四开产品方案讨论会，地点在 3 楼会议室"
-- "帮我建个日程，下周一 14:00-15:00，提前 15 分钟提醒"
-- "约一个明天上午的日程，邀请王伟参加"
-
-**流程：**
-1. 解析用户意图，提取时间、标题、地点、参与人、提醒设置等信息
-2. 若涉及参与人，先通过 **wecom-contact** 查询 userid；存在同名时展示候选让用户选择
-3. 若用户未指定提醒，默认设置提前 15 分钟提醒（`remind_before_event_secs: 900`）
-4. 若用户说"全天"，设置 `is_whole_day: 1`，时间设为当天 00:00:00 至 23:59:59
-5. 向用户确认日程信息（标题、时间、地点、参与人等）后调用 `create_schedule`
-
-### 修改日程
-
-**经典 query 示例：**
-- "把明天的需求评审改到后天下午 3 点"
-- "帮我修改下今天下午的会议标题，改成技术方案评审"
-- "我今天 14 点的日程地点改成线上腾讯会议"
-- "把周五的团建活动推迟一个小时"
-- "帮我给明天的周会加个描述：讨论 Q2 规划"
-
-**流程：**
-1. 先通过查询工作流定位目标日程（根据用户提到的时间、标题等关键词匹配）
-2. 若匹配到多个日程，展示候选列表让用户确认
-3. 向用户确认要修改的字段和目标值
-4. 调用 `update_schedule`，只传入需修改的字段
-
-### 取消日程
-
-**经典 query 示例：**
-- "取消明天下午的需求评审"
-- "帮我把周五的团建日程删掉"
-- "我不想开今天 15 点的会了，帮我取消"
-
-**流程：**
-1. 先通过查询工作流定位目标日程
-2. 向用户确认取消的日程信息（标题、时间等），避免误操作
-3. 确认后调用 `cancel_schedule`
-
-### 管理参与人
-
-**经典 query 示例：**
-- "把张三加到明天的需求评审会议里"
-- "帮我把李四从周五的日程里移除"
-- "明天下午的会议再邀请一下王伟和赵敏"
-- "把我后天那个技术分享的参与人里去掉刘强"
-
-**流程：**
-1. 通过 **wecom-contact** 获取目标人员 userid；存在同名时展示候选让用户选择
-2. 通过查询工作流定位目标日程
-3. 调用 `add_schedule_attendees` 或 `del_schedule_attendees` 完成添加/移除
-
-### 查询闲忙并安排会议
-
-**经典 query 示例：**
-- "帮我看看张三和李四明天下午有没有空"
-- "查一下我和王伟这周的空闲时间，想约个会"
-- "我想跟产品组的小明、小红开个会，看看大家什么时候有空"
-- "找一个明天下午大家都有空的时段，安排一个 1 小时的会议"
-
-**流程：**
-1. 通过 **wecom-contact** 获取相关人员 userid
-2. 调用 `check_availability` 查询指定时间范围内各用户的忙碌时段
-3. 分析所有用户的忙碌时段，计算出共同空闲时段并推荐给用户
-4. 用户确认时段后，调用 `create_schedule` 创建会议并自动添加参与人

package/skills/wecom-schedule/references/api-check-availability.md

@@ -1,56 +0,0 @@
-# check_availability API
-
-查询指定用户在某时间范围内的忙碌时段。
-
-## 参数说明
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `check_user_list` | array | ✅ | 用户 ID 列表，1~10 个 |
-| `start_time` | string | ✅ | 查询开始时间 |
-| `end_time` | string | ✅ | 查询结束时间 |
-
-## 请求示例
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule check_availability '{"check_user_list": ["USER_ID_1", "USER_ID_2"], "start_time": "YYYY-MM-DD HH:MM:SS", "end_time": "YYYY-MM-DD HH:MM:SS"}'`
-
-## 返回字段
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `errcode` | integer | 返回码，`0` 表示成功 |
-| `errmsg` | string | 错误信息 |
-| `user_busy_list` | array | 用户忙碌时段列表 |
-
-### user_busy_list[] 数组中每项字段
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `userid` | string | 用户 ID |
-| `busy_slots` | array | 忙碌时段列表 |
-| `busy_slots[].start_time` | string | 忙碌时段开始时间 |
-| `busy_slots[].end_time` | string | 忙碌时段结束时间 |
-| `busy_slots[].schedule_id` | string | 关联的日程 ID |
-| `busy_slots[].subject` | string | 日程标题 |
-
-## 响应示例
-
-```json
-{
-    "errcode": 0,
-    "errmsg": "ok",
-    "user_busy_list": [
-        {
-            "userid": "USER_ID",
-            "busy_slots": [
-                {
-                    "start_time": "YYYY-MM-DD HH:MM:SS",
-                    "end_time": "YYYY-MM-DD HH:MM:SS",
-                    "schedule_id": "SCHEDULE_ID",
-                    "subject": "日程标题"
-                }
-            ]
-        }
-    ]
-}
-```

package/skills/wecom-schedule/references/api-create-schedule.md

@@ -1,38 +0,0 @@
-# create_schedule API
-
-创建新日程，支持设置标题、时间、地点、参与者、提醒和重复规则。
-
-## 参数说明（`schedule` 对象内）
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `start_time` | string | ✅ | 开始时间 |
-| `end_time` | string | ✅ | 结束时间 |
-| `summary` | string | ❌ | 日程标题，最长 128 字 |
-| `description` | string | ❌ | 日程描述，最长 1000 字 |
-| `location` | string | ❌ | 地点，最长 128 字 |
-| `is_whole_day` | integer | ❌ | 是否全天：`0`-否（默认），`1`-是 |
-| `attendees` | array | ❌ | 参与者列表，每项含 `userid` |
-| `reminders` | object | ❌ | 提醒与重复设置（见 [reminders 字段参考](ref-reminders.md)） |
-
-## 请求示例
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule create_schedule '{"schedule": {"start_time": "YYYY-MM-DD HH:MM:SS", "end_time": "YYYY-MM-DD HH:MM:SS", "summary": "日程标题", "attendees": [{"userid": "USER_ID"}], "reminders": {"is_remind": 1, "remind_before_event_secs": 3600, "timezone": 8}, "location": "会议地点"}}'`
-
-## 返回字段
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `errcode` | integer | 返回码，`0` 表示成功 |
-| `errmsg` | string | 错误信息 |
-| `schedule_id` | string | 创建成功的日程 ID |
-
-## 响应示例
-
-```json
-{
-    "errcode": 0,
-    "errmsg": "ok",
-    "schedule_id": "SCHEDULE_ID"
-}
-```

package/skills/wecom-schedule/references/api-get-schedule-detail.md

@@ -1,81 +0,0 @@
-# get_schedule_detail API
-
-通过日程 ID 批量获取日程详细信息。
-
-## 参数说明
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `schedule_id_list` | array | ✅ | 日程 ID 列表，1~50 个 |
-
-## 请求示例
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule get_schedule_detail '{"schedule_id_list": ["SCHEDULE_ID_1", "SCHEDULE_ID_2"]}'`
-
-## 返回字段
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `errcode` | integer | 返回码，`0` 表示成功 |
-| `errmsg` | string | 错误信息 |
-| `schedule` | array | 日程详情列表 |
-
-### schedule[] 字段
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `schedule_id` | string | 日程唯一 ID |
-| `summary` | string | 日程标题 |
-| `description` | string | 日程描述 |
-| `start_time` | integer | 开始时间（Unix 时间戳，秒） |
-| `end_time` | integer | 结束时间（Unix 时间戳，秒） |
-| `location` | string | 地点 |
-| `status` | integer | `0`-正常，`1`-已取消 |
-| `is_whole_day` | integer | `0`-否，`1`-是 |
-| `admins` | array | 管理员 userid 列表 |
-| `attendees` | array | 参与者列表 |
-| `attendees[].userid` | string | 参与者 userid |
-| `attendees[].response_status` | integer | 响应状态（见下表） |
-| `reminders` | object | 提醒设置（见 [reminders 字段参考](ref-reminders.md)） |
-
-### response_status 枚举
-
-| 值 | 含义 |
-|----|------|
-| `1` | 待定 |
-| `2` | 接受 |
-| `3` | 接受单次 |
-| `4` | 拒绝 |
-| `5` | 接受本次及未来 |
-| `6` | 待定单次 |
-| `7` | 待定本次及未来 |
-| `8` | 拒绝单次 |
-| `9` | 拒绝本次及未来 |
-
-## 响应示例
-
-```json
-{
-    "errcode": 0,
-    "errmsg": "ok",
-    "schedule": [
-        {
-            "schedule_id": "SCHEDULE_ID",
-            "summary": "日程标题",
-            "start_time": 1700000000,
-            "end_time": 1700003600,
-            "location": "会议室",
-            "status": 0,
-            "is_whole_day": 0,
-            "attendees": [
-                {"userid": "USER_ID","tmp_external_userid": "tmp_external_userid_example","response_status": 2}
-            ],
-            "reminders": {
-                "is_remind": 1,
-                "remind_before_event_secs": 3600,
-                "timezone": 8
-            }
-        }
-    ]
-}
-```

package/skills/wecom-schedule/references/api-update-schedule.md

@@ -1,32 +0,0 @@
-# update_schedule API
-
-修改已有日程，只需传入需要修改的字段，未传字段保持不变。
-
-## 参数说明（`schedule` 对象内）
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `schedule_id` | string | ✅ | 目标日程 ID |
-| `start_time` | string | ❌ | 开始时间 |
-| `end_time` | string | ❌ | 结束时间 |
-| `summary` | string | ❌ | 日程标题，最长 128 字 |
-| `description` | string | ❌ | 日程描述，最长 1000 字 |
-| `location` | string | ❌ | 地点，最长 128 字 |
-| `is_whole_day` | integer | ❌ | 是否全天：`0`-否，`1`-是 |
-| `attendees` | array | ❌ | 参与者列表，每项含 `userid` |
-| `reminders` | object | ❌ | 提醒与重复设置（见 [reminders 字段参考](ref-reminders.md)） |
-
-> 仅传需修改的字段，其余保持不变。
->
-> ⚠️ **重要**：如果要把全天日程变成普通日程并修改时间，则一定要把 `is_whole_day` 设置为 `0`，否则日程仍会保持全天状态。
-
-## 请求示例
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule update_schedule '{"schedule": {"schedule_id": "SCHEDULE_ID", "summary": "更新后的标题", "start_time": "YYYY-MM-DD HH:MM:SS", "end_time": "YYYY-MM-DD HH:MM:SS"}}'`
-
-## 返回字段
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `errcode` | integer | 返回码，`0` 表示成功 |
-| `errmsg` | string | 错误信息 |

package/skills/wecom-schedule/references/ref-reminders.md

@@ -1,24 +0,0 @@
-# reminders 字段参考
-
-提醒设置对象，用于 `create_schedule` 和 `update_schedule` 接口。
-
-## 字段说明
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `is_remind` | integer | 是否提醒：`0`-否，`1`-是 |
-| `remind_before_event_secs` | integer | 提前提醒秒数，可选值：`0`/`300`/`900`/`3600`/`86400` |
-| `remind_time_diffs` | array | 提醒时间差（秒），可选值：`-604800`/`-172800`/`-86400`/`-3600`/`-900`/`-300`/`0`/`32400` |
-| `timezone` | integer | 时区，`-12` ~ `12`，中国为 `8` |
-
-## 使用示例
-
-### 基本提醒（提前 1 小时）
-
-```json
-{
-    "is_remind": 1,
-    "remind_before_event_secs": 3600,
-    "timezone": 8
-}
-```

package/skills/wecom-sheet/SKILL.md

@@ -1,131 +0,0 @@
----
-name: wecom-sheet
-description: 企业微信在线表格（sheet）管理技能。提供在线表格的新建、内容读取、内容修改、追加行数据，以及子工作表的增删管理。适用场景：(1) 新建空白在线表格 (2) 读取表格完整内容（Markdown）(3) 读取基础信息与子表列表 (4) 读取子表数据 (5) 修改指定区域内容 (6) 末尾追加一行数据 (7) 添加/删除子工作表。当用户提到「企业微信表格」「企业微信在线表格」「企微 excel 表格」，或链接形如 `https://doc.weixin.qq.com/sheet/xxx` 时触发该技能。注意：智能表格（`/smartsheet/*`）请用 `wecom-smartsheet`；普通文档（`/doc/*`）请用 `wecom-doc`；智能文档/智能主页（`/smartpage/*`）请用 `wecom-smartpage`。
----
-
-# 企业微信在线表格管理
-
-> `wecom_mcp` 是一个 MCP tool，所有操作通过调用该 tool 完成。
-
-> ⚠️ **前置条件**：首次调用 `wecom_mcp` 前，必须按 `wecom-preflight` 技能执行前置条件检查，确保工具已加入白名单。
-
-资源型技能，负责**在线表格**（`/sheet/*`）的新建、内容读写以及子工作表管理。
-
-## 调用方式
-
-通过 `wecom_mcp` tool 调用，品类名为 `doc`：
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call doc <tool_name> '<json_params>'` 调用指定技能
-
-## 返回格式说明
-
-所有接口返回 JSON 对象，包含以下公共字段：
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `errcode` | integer | 返回码，`0` 表示成功，非 `0` 表示失败 |
-| `errmsg` | string | 错误信息，成功时为 `"ok"` |
-
-当 `errcode` 不为 `0` 时，说明接口调用失败，可重试 1 次；若仍失败，将 `errcode` 和 `errmsg` 展示给用户。
-
-### 特殊错误码
-
-| errcode | errmsg | 含义 | 处理方式 |
-|---------|--------|------|----------|
-| `851002` | `incompatible doc type` | 文档品类与所调用的接口不匹配 | 确认目标 URL 为 `/sheet/*`；若不是，请跳转到对应品类的 skill |
-
-## 接口路由表
-
-> **硬规则**：第二列是 `references/xxx.md` 链接的，命中这一行后**先 `read` 对应 references 文件，再构造命令**。写入/读取子表数据前，先用 `sheet_get_info` 拿到目标子表的 `sheet_id`。
-
-| 用户意图 | 参考位置 |
-|---|---|
-| 读取在线表格完整内容（Markdown 概览） | 见下方「读取完整内容」 |
-| 读取在线表格基础信息与子表列表 | 见下方「读取基础信息」 |
-| 从零新建在线表格（空白） | 见下方「新建在线表格」 |
-| 修改在线表格指定区域内容 | [references/sheet-update-range-data.md](references/sheet-update-range-data.md) |
-| 在线表格末尾追加一行数据 | [references/sheet-append-data.md](references/sheet-append-data.md) |
-| 添加在线表格子工作表 | [references/sheet-add-sub.md](references/sheet-add-sub.md) |
-| 删除在线表格子工作表 | [references/sheet-delete-sub.md](references/sheet-delete-sub.md) |
-
-## 接口详述
-
-### create_doc — 新建在线表格
-
-从零新建一篇企微**在线表格**：空白。创建成功后返回 `docid` 和 `url`。
-
-使用 `wecom_mcp` tool 调用 `wecom_mcp call doc create_doc '{"doc_type": 4, "doc_name": "项目数据表"}'`
-
-**参数**
-
-| 参数 | 类型 | 必填 | 默认值 | 说明 |
-|---|---|---|---|---|
-| `doc_type` | int | 是 | — | 固定传 `4`（在线表格） |
-| `doc_name` | string | 是 | — | 表格标题 |
-
-**注意事项**
-
-- 本接口仅创建**空白**在线表格，不支持携带初始内容；如需写入数据，请在创建后先用 `sheet_get_info` 拿到子表 `sheet_id`，再通过 `sheet_update_range_data` / `sheet_append_data` 写入。
-
-### get_doc_content — 读取完整内容
-
-获取**在线表格**的完整内容数据，统一以 Markdown 格式返回。采用**异步轮询机制**：首次调用无需传 `task_id`，接口返回 `task_id`；若 `task_done` 为 `false`，需携带该 `task_id` 再次调用，直到 `task_done` 为 `true` 时返回完整内容。适合快速概览或读取整篇表格内容。
-
-- 首次调用（不传 task_id）：使用 `wecom_mcp` tool 调用 `wecom_mcp call doc get_doc_content '{"docid": "DOCID", "type": 2}'`
-- 轮询（携带上次返回的 task_id）：使用 `wecom_mcp` tool 调用 `wecom_mcp call doc get_doc_content '{"docid": "DOCID", "type": 2, "task_id": "xxx"}'`
-- 通过 URL：使用 `wecom_mcp` tool 调用 `wecom_mcp call doc get_doc_content '{"url": "https://doc.weixin.qq.com/sheet/xxx", "type": 2}'`
-
-**参数**
-
-| 字段 | 类型 | 必填 | 默认值 | 语义 |
-|---|---|---|---|---|
-| `docid` | string | 与 `url` 二选一 | — | 在线表格的 docid |
-| `url` | string | 与 `docid` 二选一 | — | 在线表格的访问链接 |
-| `type` | int | 是 | — | 内容返回格式，固定传 `2`（Markdown） |
-| `task_id` | string | 否 | — | 任务 ID，首次不传，轮询时填上次返回的 `task_id` |
-
-**返回**
-
-| 字段 | 类型 | 说明 |
-|---|---|---|
-| `content` | string | `task_done` 为 `true` 时返回的完整 Markdown 内容 |
-| `task_id` | string | 任务 ID，未完成时用于下次轮询 |
-| `task_done` | bool | 任务是否完成，`false` 时需携带 `task_id` 继续轮询 |
-
-**使用规则**
-
-- 首次调用不传 `task_id`；若 `task_done` 为 `false`，记录 `task_id` 后携带其再次调用，直到 `task_done` 为 `true` 取 `content`。
-
-### sheet_get_info — 读取基础信息
-
-读取**在线表格**的基础信息，包括工作表列表、文档名称与访问链接。所有后续需要 `sheet_id` 的接口（`sheet_update_range_data` / `sheet_append_data` / `sheet_delete_sub` 等）的 `sheet_id` 都从本接口返回的 `sheets[]` 中取。
-
-- 通过 docid：使用 `wecom_mcp` tool 调用 `wecom_mcp call doc sheet_get_info '{"docid": "DOCID"}'`
-- 通过 URL：使用 `wecom_mcp` tool 调用 `wecom_mcp call doc sheet_get_info '{"url": "https://doc.weixin.qq.com/sheet/xxx"}'`
-
-**参数**
-
-| 字段 | 类型 | 必填 | 默认值 | 语义 |
-|---|---|---|---|---|
-| `docid` | string | 与 `url` 二选一 | — | 在线表格的 docid |
-| `url` | string | 与 `docid` 二选一 | — | 在线表格的访问链接 |
-
-**返回**
-
-| 字段 | 类型 | 说明 |
-|---|---|---|
-| `sheets` | array | 工作表列表；每项含 `sheet_id` / `title` / `row_count` / `column_count` / `data_range` 等基础信息 |
-| `url` | string | 文档访问链接 |
-| `name` | string | 文档名称 |
-
-**使用规则**
-
-- `docid` 与 `url` 二选一，至少传其一。
-- **读 → 写 链路**：当需要往具体子表写内容（`sheet_update_range_data` / `sheet_append_data`）时，应先用 `get_doc_content` 读取并识别出各子表的**标题**与**具体数据**，再调用本接口拿到 `sheets[]` 中每个子表的 `sheet_id` 与行列数（`row_count` / `column_count`）；通过**子表标题与 `title` 匹配**确定目标 `sheet_id`，并结合行列数核对写入区域范围，从而打通「读 → 写」的完整链路。
-
-## 跨技能依赖
-
-| 依赖技能 | 典型协作场景 | 数据流向 |
-|---|---|---|
-| `wecom-contact` | 表格里需要写入人员信息时按姓名查 userid | `get_userlist` 查到 userid → 本 skill 写入 |
-| `wecom-msg` | 用户要求把在线表格链接发给某人/某群 | 本 skill 新建后返回 `url` → `wecom-msg` 发送链接 |