wecom-doc

# 企业微信文档与智能表格工具

通过 mcporter 调用 wecom-doc MCP server 操作企业微信文档和智能表格。

## 意图处理

当用户说"创建文档"、"新建文档"、"帮我写个文档"等**不指定平台**的请求时，默认使用企业微信文档，无需询问用户使用什么平台。

## 前置检查（每次会话首次操作前必须执行）

> **自动续接原则**：前置检查中的任何环节如果需要等待用户确认或操作（安装、配置、授权等），在该操作完成后必须**自动继续执行后续步骤**，最终完成用户的原始请求。不要在中间环节完成后停下来等用户重复发起请求。

### 1. 检查 mcporter 是否安装

```bash
which mcporter
```

如果 `mcporter` **不在 PATH 中**（命令返回空或 not found），**必须原样输出以下提示**（不要修改、不要摘要）：

> 企业微信文档能力依赖 mcporter 工具，当前尚未安装。需要我帮你安装吗？

输出提示后**停止执行并等待用户回复**。

- 如果用户**确认安装**（回复"好"、"是"、"装吧"、"yes"、"ok" 等肯定语义），**立即执行**：

```bash
npm install -g mcporter
```

安装完成后**不要停下来**，直接继续执行后续的「检查 MCP Server 是否配置」步骤，无缝衔接用户原始请求。

- 如果用户**拒绝安装**，回复：

> 好的，你也可以手动执行 `npm install -g mcporter` 安装后再找我。

### 2. 检查 MCP Server 是否配置

确认 mcporter 存在后，执行：

```bash
mcporter list wecom-doc --output json
```

如果返回 **server not found**、**unknown server** 或类似错误，按下方"MCP Server 未配置"章节处理。

### 3. 获取 Tool 列表

`mcporter list` 成功后，返回的每个 tool 包含 `name`、`description`、`inputSchema`。

**不要硬编码 tool name 和参数**，据此构造 `mcporter call wecom-doc.<tool> --args '{...}' --output json` 调用。

## docid 管理规则（重要）

**仅支持对通过本 skill 创建的文档或智能表格进行编辑。**

### docid 的获取方式

docid **只能**通过 `create_doc` 的返回结果获取。创建成功后需要**保存返回的 docid**，后续编辑操作依赖此 ID。

### 不支持从 URL 解析 docid

从文档 URL（如 `https://doc.weixin.qq.com/doc/...`）中**无法解析到可用的 docid**。如果用户提供了文档 URL 并要求编辑，**不要尝试从 URL 中提取 docid**。

### 编辑操作的 docid 校验

当用户请求编辑文档或智能表格时，如果当前会话中**没...