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

package/skills/wecomcli-preflight/SKILL.md

@@ -0,0 +1,147 @@
+---
+name: wecomcli-preflight
+description: 企业微信插件前置条件检查。在执行任何 wecom-cli 操作前，通过 shell 命令检查工具权限配置（profile 和白名单），若缺失则自动修复并提示用户重启 Gateway。所有使用 wecom-cli 的技能都应在首次调用前执行此检查。
+---
+
+# 企业微信前置条件检查
+
+> 本技能确保 `wecom-cli` 工具已正确获得执行权限。**所有使用 wecom-cli 的技能在首次调用前，必须先执行本检查流程。**
+
+## 触发条件
+
+当满足以下**任一条件**时，执行前置检查：
+
+1. 当前会话中**首次**需要调用 `wecom-cli` 工具
+2. 调用 `wecom-cli` 时收到 `tool not allowed`、`not permitted`、`permission denied` 或类似权限错误
+
+> 如果当前会话中已成功调用过 `wecom-cli`（任何操作），则无需重复检查。
+
+---
+
+## 检查流程
+
+> **重要**：以下所有步骤均为 **shell 命令**（在终端中执行），不是 `wecom-cli` 工具调用。
+> 这些 shell 命令仅用于检查和修改 OpenClaw 工具权限，严禁用它们直接运行全局 `wecom-cli`。
+> `wecom-cli` 在未加入白名单前对 AI Agent 不可见，因此不能用 tool 调用来探测；此时应完成权限修复或向用户报告问题，不得降级到 `exec` / `bash` / `shell` / `npx` 执行 CLI，也不得手动执行 `auth init`。
+
+### 步骤 1：检查 tools.profile
+
+在终端执行以下命令，读取当前 `tools.profile` 配置：
+
+```bash
+openclaw config get tools.profile
+```
+
+根据返回结果分流：
+
+- **返回 `full`** → ✅ **检查通过**。`full` 模式无任何工具限制，所有工具（包括 `wecom-cli`）直接可用，无需检查 `alsoAllow`，继续执行用户原始请求；通过仅表示专用 tool 可用，即使存在 `exec` 也必须调用专用 `wecom-cli` tool，不得直接运行全局 CLI
+- **返回其他值**（如 `coding`、`messaging`、`minimal`、`undefined` 或空）→ 进入步骤 1b（检查 alsoAllow）
+- **命令执行失败**（如 `command not found: openclaw`、权限错误等）→ 进入步骤 3（环境异常）
+
+### 步骤 1b：检查 tools.alsoAllow
+
+在终端执行以下命令，读取当前 `tools.alsoAllow` 配置：
+
+```bash
+openclaw config get tools.alsoAllow
+```
+
+根据返回结果分流：
+
+- **返回内容包含 `wecom-openclaw-plugin`**（如 `["wecom-openclaw-plugin"]` 或 `["wecom-openclaw-plugin", "other_tool"]`）→ ✅ 插件已放行，检查通过，继续执行用户原始请求
+- **返回内容不包含 `wecom-openclaw-plugin`**（如空数组 `[]`、`undefined`、或列表中只有旧条目 `wecom_mcp`）→ 进入步骤 2（自动修复）
+- **命令执行失败** → 进入步骤 3（环境异常）
+
+---
+
+### 步骤 2：自动修复 tools.alsoAllow
+
+在终端执行以下命令，将企业微信插件加入工具白名单：
+
+```bash
+openclaw config set tools.alsoAllow '["wecom-openclaw-plugin"]'
+```
+
+> **权限边界**：按插件 ID 放行会允许该插件当前及未来注册的全部工具；这是本插件约定的推荐配置。
+>
+> **注意**：如果步骤 1b 返回的列表中已有其他工具（如 `["other_tool"]`），需要合并后再写入，例如：
+> ```bash
+> openclaw config set tools.alsoAllow '["other_tool", "wecom-openclaw-plugin"]'
+> ```
+> 旧的 `wecom_mcp` 条目已无效，可以保留或自行删除；不要为清理旧条目覆盖其他配置。
+
+根据执行结果分流：
+
+#### 2a. 命令执行成功
+
+向用户回复（**不要自动执行重启**）：
+
+```
+✅ 已自动将企业微信插件（wecom-openclaw-plugin）加入工具执行权限白名单（tools.alsoAllow）。
+⚠️ 配置变更需要重启 Gateway 后才能生效，请在终端执行以下命令：
+
+openclaw gateway restart
+
+重启完成后请重新发送您的请求。
+```
+
+> **为什么不自动重启**：`openclaw gateway restart` 会中断当前所有活跃连接（包括本会话），
+> 如果由 AI 自动执行，用户可能无法看到完整的提示信息。交由用户手动重启更可控。
+
+#### 2b. 命令执行失败
+
+向用户回复以下手动修复指引：
+
+```
+❌ 自动配置失败，请在终端手动执行以下命令：
+
+openclaw config set tools.alsoAllow '["wecom-openclaw-plugin"]'
+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 在终端中执行，**不调用 `wecom-cli` 工具**。这样可以避免"tool 未白名单 → tool 不可见 → 无法探测"的死锁问题
+2. **profile 优先判断**：`tools.profile` 为 `full` 时所有工具无限制，无需检查 `alsoAllow`，可快速跳过
+3. **幂等性**：如果 `tools.alsoAllow` 中已包含 `wecom-openclaw-plugin`，无需重复写入
+4. **按插件 ID 放行**：`wecom-openclaw-plugin` 会展开为该插件当前及未来注册的全部工具
+5. **保留已有配置**：修改 `tools.alsoAllow` 时需保留已有条目，仅追加 `wecom-openclaw-plugin`；旧的 `wecom_mcp` 可以保留或自行删除
+6. **不自动重启**：自动配置成功后仅提示用户重启并附上命令，由用户手动执行，避免会话中断导致信息丢失
+7. **会话缓存**：同一会话中一旦检查通过（profile 为 full 或 alsoAllow 包含插件 ID），后续调用无需重复检查
+8. **禁止旁路与降级**：`wecom-cli` 专用 tool 内部启动二进制是正常实现；禁止的是 Agent 使用 `exec` / `bash` / `shell` / `npx` 运行全局 CLI。专用 tool 失败、不可见或提示授权时，必须报告权限或配置问题，不得手动执行 `auth init`
+
+---
+
+## 快速参考
+
+| 场景 | 处理方式 |
+|------|---------|
+| 首次调用 wecom-cli 前 | 执行 `openclaw config get tools.profile` 检查 |
+| `tools.profile` 为 `full` | ✅ 跳过，直接执行原始请求 |
+| profile 非 full + alsoAllow 已包含 `wecom-openclaw-plugin` | ✅ 跳过，继续执行 |
+| profile 非 full + alsoAllow 只有旧 `wecom_mcp` 或不含插件 ID → 自动写入成功 | 追加插件 ID，提示已配置 + 附 `openclaw gateway restart` 命令让用户重启 |
+| profile 非 full + alsoAllow 不含插件 ID → 自动写入失败 | 给出手动修复指引 |
+| openclaw CLI 不可用 | 告知用户检查 OpenClaw 安装 |
+| 会话中已成功调用过 wecom-cli | 跳过检查 |

package/skills/wecomcli-sheet/SKILL.md

@@ -0,0 +1,177 @@
+---
+name: wecomcli-sheet
+description: 企业微信在线表格文档管理：新建在线表格、导入 CSV/Excel 为在线表格、读取表格信息与数据、修改表格内容、追加行数据、子表管理。当用户提到'表格'、'在线表格'、'excel表格'这些关键词触发，或链接形如 https://doc.weixin.qq.com/sheet/xxx 时触发。文档公共操作请使用 wecomcli-doc-manage；doc文档操作请使用 wecomcli-doc；智能表格内容 CRUD 请使用 wecomcli-smartsheet。
+---
+
+`wecom-cli` 是插件提供的 tool，不是终端命令：所有操作都通过调用该 tool 完成，参数应使用 `args` 传入，禁止通过 exec / shell / 终端等命令行方式使用。
+
+⚠️ 前置条件：首次调用 wecom-cli 前，必须按 wecomcli-preflight 技能执行前置条件检查，确保工具已加入白名单。
+
+# 企业微信在线表格管理
+
+资源型 skill，负责在线表格（`sheet`）的新建、导入与内容读写及子表管理。
+
+## 适用范围
+
+### 适用
+
+- 新建 / 导入企微在线表格
+- 读取 / 修改 / 追加在线表格内容
+- 添加 / 删除在线表格子表
+
+### 不适用
+
+- 搜索文档 / 修改文档权限 / 重命名 / 加成员 → 改用 `wecomcli-doc-manage`
+- 用户给的链接是 `https://doc.weixin.qq.com/smartsheet/...` → 改用 `wecomcli-smartsheet`
+- 若遇到的 `docid` 以 `s3` 开头（形如 `s3_xxxx`）→ 改用 `wecomcli-smartsheet`
+
+
+## 接口路由表
+
+> **硬规则**：第二列是 `references/xxx.md` 链接的, 命中这一行后先 `read` 对应 references 文件，再构造命令。
+
+| 用户意图 | 参考位置 |
+|---|---|
+| 新建在线表格 | 见下方「新建在线表格」 |
+| 导入本地 CSV / Excel 文件为企微在线表格 | 见下方「导入在线表格」 |
+| 读取在线表格基础信息与子表列表 | 见下方「读取在线表格」 |
+| 读取在线表格子表数据 | [references/sheet-ranges-get.md](references/sheet-ranges-get.md) |
+| 修改在线表格指定区域内容 | [references/sheet-contents-update.md](references/sheet-contents-update.md) |
+| 在线表格末尾追加一行数据 | [references/sheet-rows-append.md](references/sheet-rows-append.md) |
+| 添加在线表格子工作表 | [references/sheet-subsheets-add.md](references/sheet-subsheets-add.md) |
+| 删除在线表格子工作表 | [references/sheet-subsheets-delete.md](references/sheet-subsheets-delete.md) |
+
+## 接口详述
+
+### 新建在线表格
+
+从零新建一篇企微在线表格：空白，或带初始数据（二维表格数据）。**本接口不接受任何文件路径参数**——"用本地文件建/导入"走「导入在线表格」。
+
+#### 调用方式
+
+使用 wecom-cli 工具按照下面格式调用
+
+```
+wecom-cli sheet create --json '<JSON 参数>'
+```
+
+#### 参数
+
+| 字段 | 类型 | 必填 | 默认值 | 语义 |
+|---|---|---|---|---|
+| `doc_name` | string | 是 | — | 表格标题 |
+| `grid_data` | object | 否 | — | 默认子表初始化数据；子结构见下方 |
+
+`grid_data` 对象结构：
+
+| 子字段 | 类型 | 必填 | 默认值 | 语义 |
+|---|---|---|---|---|
+| `start_row` / `start_column` | int | 否 | `0` | 起始行 / 列号，从 0 起 |
+| `rows` | array | 否 | — | 各行数据；每项 `values` 为单元格数组 |
+| `rows[].values[].cell_value` | object | 否 | — | 单元格值，见下方「cell_value 类型选择」 |
+| `rows[].values[].data_type` | string | 否 | — | 枚举：`TEXT` / `NUMBER` / `LINK` / `FORMULA` |
+
+##### cell_value 类型选择
+
+> 硬规则：选择 `cell_value` 形态后，必须同时把同级的 `data_type` 设置为下表对应值。
+
+| 形态 | 对应 `data_type` | 结构 | 适用场景 |
+|---|---|---|---|
+| `text` | `TEXT` | `{"text": "<纯文本>"}` | 纯文本内容（如姓名、说明、标签、编号字符串等） |
+| `number` | `NUMBER` | `{"number": 123.45}` | 数值，用于金额、数量、比率等需要参与公式计算或聚合的数据；值为 JSON 数字类型，不加引号 |
+| `formula` | `FORMULA` | `{"formula": "=SUM(A1,A2)"}` | 任何以 `=` 开头的公式，包括 `=SUM(...)`、`=A1+B1`、`=IF(...)`、`=VLOOKUP(...)` 等 |
+| `link` | `LINK` | `{"link": {"url": "<URL>", "text": "<显示文本>"}}` | 超链接 |
+
+#### 返回
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `docid` | string | 新建表格 ID |
+| `url` | string | 表格访问链接 |
+
+#### 使用规则
+
+- **何时走 import 而非本接口**：用户提到具体文件路径、或明确说"导入 / 用这个文件建"，一律走「导入在线表格」。
+
+### 导入在线表格
+
+把本地文件（`.csv` / `.xls` / `.xlsx`）导入为企微在线表格。
+
+#### 调用方式
+
+使用 wecom-cli 工具按照下面格式调用
+
+```
+wecom-cli sheet import --json '<JSON 参数>'
+```
+
+#### 参数
+
+| 字段          | 类型 | 必填 | 默认值 | 语义 |
+|-------------|---|---|---|---|
+| `file_name` | string | 是 | — | 二进制文件名（含后缀），用于业务判断源文件类型 |
+| `file_path` | string | 是 | — | 源文件的本地绝对路径 |
+| `passwd`    | string | 否 | — | Office 文件加密密码（若有） |
+
+#### 返回
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `docid` | string | 导入完成后的表格 ID |
+| `url` | string | 导入完成后的访问链接 |
+| `task_status` | string | 任务状态枚举，如 `succ` 成功 |
+
+### 读取在线表格
+
+根据 `docid` 读取**在线表格**的基础信息，包括工作表列表、文档名称与访问链接。所有后续 `sheet *` 接口的 `sheet_id` 都从本接口返回的 `sheets[]` 中取。
+
+#### 调用方式
+
+使用 wecom-cli 工具按照下面格式调用
+
+```
+wecom-cli sheet get --json '<JSON 参数>'
+```
+
+#### 参数
+
+| 字段 | 类型 | 必填 | 默认值 | 语义 |
+|---|---|---|---|---|
+| `docid` | string | 是 | — | 在线表格 ID |
+
+#### 返回
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `sheets` | array | 工作表列表；每项含 `sheet_id` / `title` / `row_count` / `column_count` / `data_range` 等基础信息 |
+| `url` | string | 文档访问链接 |
+| `name` | string | 文档名称 |
+
+#### 使用规则
+
+- 拿到 `sheet_id` 后**继续读取子表数据是另一个接口**，命令字符串、参数名、是否分页等都没有在本节出现，**必须**先用 `read` 工具读 `references/sheet-ranges-get.md`，再据此构造命令。
+
+## 跨技能依赖
+
+| 依赖技能 | 典型协作场景                                                | 数据流向 |
+|---|-------------------------------------------------------|---|
+| `wecomcli-doc-manage` | 用户只给表格名称/关键词，需搜索获取 `docid` 后再读写表格；或需要文件级操作（改名、权限等） | `wecomcli-doc-manage` 的「搜索文档」接口 → 返回 `docid` → 本 skill 的读取/修改/追加接口|
+
+> 必填参数缺失 / `docid` 多候选 / 新建 vs 导入等歧义场景，用简洁自然语言仅追问缺失或有歧义的信息；有候选项时在文字中列出供用户选择，不得自行猜测。
+
+#### `docid` 使用规则
+
+`docid`仅cli使用。
+最终展示用户时，不应展示 `docid`，而是使用文档 URL：
+
+
+```
+[doc_name](doc_url)
+```
+
+
+`docid` 是文档的唯一标识符，调用任何文档内容操作技能时均需提供。禁止自造 `docid`，按以下优先级获取：
+
+1. 从文档链接提取（优先）：用户提供了企微文档 URL 时，直接从 URL 中解析。URL 格式为 `https://doc.weixin.qq.com/<type>/<docid>?scode=...`，取 `/<type>/` 后、`?` 前的部分即为 docid。
+2. 通过文档搜索获取（备选）：用户仅提供文档名称或关键词、未给链接时，先调用 `wecomcli-doc-manage` 搜索文档，从返回结果中取 `docid`。
+3. 用户直接提供：用户明确给出了完整 `docid`，可直接使用，无需再提取或搜索。

package/skills/wecomcli-sheet/references/sheet-contents-update.md

@@ -0,0 +1,49 @@
+# 修改表格内容 — `wecom-cli sheet contents update`
+
+修改**在线表格**指定区域的内容与格式，通过 `grid_data` 指定写入的起始位置与各单元格数据。
+
+## 调用方式
+
+使用 wecom-cli 工具按照下面格式调用
+
+```
+wecom-cli sheet contents update --json '<JSON 参数>'
+```
+
+## 参数
+
+| 字段 | 类型 | 必填 | 默认值 | 语义 |
+|---|---|---|---|---|
+| `docid` | string | 是 | — | 在线表格 ID |
+| `sheet_id` | string | 是 | — | 工作表 ID；通过 `sheet get` 获取 |
+| `grid_data` | object | 是 | — | 写入区域的数据 |
+| `grid_data.start_row` | int | 是 | — | 起始行号，从 0 起 |
+| `grid_data.start_column` | int | 是 | — | 起始列号，从 0 起 |
+| `grid_data.rows` | array | 是 | — | 各行数据 |
+
+`grid_data.rows[].values[]` 对象结构：
+
+| 子字段 | 类型 | 说明 |
+|---|---|---|
+| `cell_value` | object | 单元格值，见下方「cell_value 类型选择」 |
+| `data_type` | string | 与 `cell_value` 对应的数据类型 |
+| `cell_format` | object | 单元格样式；传空对象 `{}` 表示默认样式 |
+
+### cell_value 类型选择
+
+| 形态 | 结构 | 适用场景 |
+|---|---|---|
+| `text` | `{"text": "<纯文本>"}` | 纯文本内容（如姓名、说明、标签、编号字符串等） |
+| `number` | `{"number": 123.45}` | 数值，用于金额、数量、比率等需要参与公式计算或聚合的数据；值为 JSON 数字类型，不加引号 |
+| `formula` | `{"formula": "=SUM(A1,A2)"}` | 任何以 `=` 开头的公式，包括 `=SUM(...)`、`=A1+B1`、`=IF(...)`、`=VLOOKUP(...)` 等 |
+| `link` | `{"link": {"url": "<URL>", "text": "<显示文本>"}}` | 超链接 |
+
+## 返回
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `grid_data` | object | 写入的数据，结构与入参 `grid_data` 一致 |
+
+## 使用规则
+
+- **格式与已有内容对齐**：向已有内容的表格追加数据时，新行的样式应尽量与现有表格保持一致，避免出现字体、字号、对齐、边框、底色等风格突兀的行。

package/skills/wecomcli-sheet/references/sheet-ranges-get.md

@@ -0,0 +1,47 @@
+# 读取子表数据 — `wecom-cli sheet ranges get`
+
+根据 `docid`、`sheet_id` 读取**在线表格**指定子表的全部数据。可通过 `mode` 参数选择返回结构化的表格数据（含格式信息），或返回 CSV（内容或文件路径）。
+
+## 调用方式
+
+使用 wecom-cli 工具按照下面格式调用
+
+```
+wecom-cli sheet ranges get --json '<JSON 参数>'
+```
+
+## 参数
+
+| 字段 | 类型 | 必填 | 默认值 | 语义 |
+|---|---|---|---|---|
+| `docid` | string | 是 | — | 在线表格 ID |
+| `sheet_id` | string | 是 | — | 工作表 ID；通过 `sheet get` 获取 |
+| `mode` | string | 否 | `"default"` | 返回格式选择：`"default"` 返回结构化 `grid_data`（含单元格格式）；填 `"csv"` 返回 CSV（内容或文件路径） |
+| `range` | string | 条件必填 | — | 当 `mode="default"` 时**必填**，表示要读取的区域，形如 `"A1:A100"`；取值可从 `sheet get` 返回的 `sheets[].data_range` 拿到。`mode="csv"` 时忽略此字段 |
+
+### `mode` 如何选择
+
+默认一律使用 `"default"`，包括普通的读取、查看、展示数据等场景。此时必须同时传 `range`，返回 `grid_data`（含单元格值、格式、数据类型等完整信息）。
+仅当用户明确表达需要对数据做统计、计算、聚合分析（例如"求和/平均/分组统计/透视/跑数据分析"等）时，才填 `"csv"`，便于直接把数据交给计算流程。
+
+## 返回
+
+### `mode` 为 `"default"`（默认）
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `grid_data` | object | 结构化表格数据，包含每个单元格的值（`cell_value`）、格式（`cell_format`，如字体、字号、颜色、对齐方式）和数据类型（`data_type`） |
+
+### `mode` 为 `"csv"`
+
+回包可能是以下两种形式之一（取决于数据大小）：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `content` | string | CSV 内容（直接返回） |
+| `file_path` | string | CSV 文件落盘后的绝对路径 |
+
+## 使用规则
+
+- `mode="csv"` 且返回 `file_path` 时：必须再用 `read` 工具读取该文件内容，才能展示给用户或继续做分析。
+- `mode="csv"` 且返回 `content` 时：可直接消费，无需再次读取文件。

package/skills/wecomcli-sheet/references/sheet-rows-append.md

@@ -0,0 +1,47 @@
+# 追加一行数据 — `wecom-cli sheet rows append`
+
+向**在线表格**的指定子工作表末尾自动追加一行数据，无需指定行号——数据将写到最末一行之后。
+
+## 调用方式
+
+使用 wecom-cli 工具按照下面格式调用
+
+```
+wecom-cli sheet rows append --json '<JSON 参数>'
+```
+
+## 参数
+
+| 字段 | 类型 | 必填 | 默认值 | 语义 |
+|---|---|---|---|---|
+| `docid` | string | 是 | — | 在线表格 ID |
+| `sheet_id` | string | 是 | — | 工作表 ID；通过 `sheet get` 获取 |
+| `row` | object | 是 | — | 追加的一行数据 |
+| `row.values` | array | 是 | — | 单元格数组，按列顺序排列 |
+
+`row.values[]` 对象结构：
+
+| 子字段 | 类型 | 说明 |
+|---|---|---|
+| `cell_value` | object | 单元格值，见下方「cell_value 类型选择」|
+| `cell_format` | object | 单元格样式；传空对象 `{}` 表示默认样式 |
+
+### cell_value 类型选择
+
+| 形态 | 结构 | 适用场景 |
+|---|---|---|
+| `text` | `{"text": "<纯文本>"}` | 纯文本内容（如姓名、说明、标签、编号字符串等） |
+| `number` | `{"number": 123.45}` | 数值，用于金额、数量、比率等需要参与公式计算或聚合的数据；值为 JSON 数字类型，不加引号 |
+| `formula` | `{"formula": "=SUM(A1,A2)"}` | 任何以 `=` 开头的公式，包括 `=SUM(...)`、`=A1+B1`、`=IF(...)`、`=VLOOKUP(...)` 等 |
+| `link` | `{"link": {"url": "<URL>", "text": "<显示文本>"}}` | 超链接 |
+
+## 返回
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `row` | object | 写入的行数据，结构与入参 `row` 一致 |
+
+## 使用规则
+
+- **逐行写入场景**：本接口会自动定位到子表最末一行之后追加；批量写不同区域请用 `sheet contents update`。
+- **格式与已有内容对齐**：向已有内容的表格追加数据时，新行的样式应尽量与现有表格保持一致，避免出现字体、字号、对齐、边框、底色等风格突兀的行。

package/skills/wecomcli-sheet/references/sheet-subsheets-add.md

@@ -0,0 +1,28 @@
+# 添加子工作表 — `wecom-cli sheet subsheets add`
+
+向**在线表格**添加一个新的子工作表。
+
+## 调用方式
+
+使用 wecom-cli 工具按照下面格式调用
+
+```
+wecom-cli sheet subsheets add --json '<JSON 参数>'
+```
+
+## 参数
+
+| 字段 | 类型 | 必填 | 默认值 | 语义 |
+|---|---|---|---|---|
+| `docid` | string | 是 | — | 在线表格 ID |
+| `sheet` | object | 是 | — | 子表信息 |
+| `sheet.title` | string | 是 | — | 工作表名称 |
+| `sheet.row_count` | int | 否 | — | 表格总行数 |
+| `sheet.column_count` | int | 否 | — | 表格总列数 |
+| `index` | int | 否 | — | 插入位置：`0` 表示插入到最后，`1` 表示插入到第一个位置 |
+
+## 返回
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `sheet` | object | 新增的子表信息；含 `sheet_id`（唯一标识）/ `title` / `row_count` / `column_count` / `data_range`（新建时为空） |

package/skills/wecomcli-sheet/references/sheet-subsheets-delete.md

@@ -0,0 +1,22 @@
+# 删除子工作表 — `wecom-cli sheet subsheets delete`
+
+根据 `docid` 与 `sheet_id` 删除**在线表格**的指定子工作表。
+
+## 调用方式
+
+使用 wecom-cli 工具按照下面格式调用
+
+```
+wecom-cli sheet subsheets delete --json '<JSON 参数>'
+```
+
+## 参数
+
+| 字段 | 类型 | 必填 | 默认值 | 语义 |
+|---|---|---|---|---|
+| `docid` | string | 是 | — | 在线表格 ID |
+| `sheet_id` | string | 是 | — | 要删除的工作表 ID；通过 `sheet get` 获取 |
+
+## 返回
+
+删除成功返回空对象。