SKILL.md
企业微信doc文档管理
执行任何 wecom-cli 命令前，必须先读取并完成 wecomcli-shared 技能的公共前置检查。
资源型 skill，负责doc文档（doc）的新建、导入与内容读写。
适用范围
适用
- 新建 / 导入企微 doc 文档
- 读取 doc 文档内容
- 向 doc 文档追加一行 / 覆盖写入doc 文档
不适用
- 搜索文档 / 修改文档权限 / 重命名 / 加成员 → 改用
wecomcli-doc-manage
易混淆场景路由
- 用户说"创建文档 / 写文档 / 整理成文档" 且未指定 doc 类型 → 改用
wecomcli-smartpage（智能文档为默认）
- 用户给的链接是
https://doc.weixin.qq.com/smartpage/...或者https://page.weixin.qq.com/smartpage/...→ 改用wecomcli-smartpage
- 若遇到的
docid以a1或者b1开头（形如a1_xxxx,b1_xxxx）→ 改用wecomcli-smartpage
接口路由表
路由表第二列若是 references/xxx.md 链接 → 必须先用 read 工具读完该文件，再构造命令。
| 用户意图 | 参考位置 |
|---|---|
| 新建doc文档（在线） | 见下方「新建doc文档」 |
| 导入本地文件为企微doc文档 | 见下方「导入doc文档」 |
| 读取doc文档内容 | 见下方「读取doc文档内容」 |
| 追加文本到doc文档末尾 | +contents-append |
| 全量覆盖doc文档内容 | +contents-overwrite |
写入语义裁定（追加 vs 覆盖）
- 默认追加：用户用「写入 / 写到 / 记录 / 补充 / 加进去 / 记一下」等中性动词，且未明确要求清空或替换时，一律走
append（追加，不破坏原有内容）。
- 仅显式覆盖：仅当用户明确出现「覆盖 / 重写 / 替换 / 清空重写 / 整个换成」等强语义词时，才走
overwrite。
接口详述
新建doc文档
新建企微doc文档统一走「**生成 .docx → 导入**」两步流程：
- 生成
.docx文件：按 +doc-create 生成.docx文件。
- 导入为企微doc文档：使用下方「导入doc文档」接口将生成的
.docx文件导入为企微doc文档。注意import导入的时候file_name应和文档标题保持一致。
导入doc文档
把本地文件（.doc / .docx / .txt）导入为企微doc文档。
命令
wecom-cli doc import --json '<JSON 参数>'参数
| 字段 | 类型 | 必填 | 默认值 | 语义 |
|---|---|---|---|---|
doc_type | string | 是 | doc | 固定为 doc（doc文档） |
file_name | string | 是 | — | 二进制文件名（含后缀），用于业务判断源文件类型 |
file_path | string | 是 | — | 源文件的本地绝对路径 |
passwd | string | 否 | — | Office 文件加密密码（若有） |
返回
| 字段 | 类型 | 说明 |
|---|---|---|
docid | string | 导入完成后的文档 ID |
url | string | 导入完成后的访问链接 |
task_status | string | 任务状态枚举，如 succ 成功 |
读取doc文档内容
读取doc文档的文档内容。
命令
wecom-cli doc contents get --json '<JSON 参数>'参数
| 字段 | 类型 | 必填 | 默认值 | 语义 |
|---|---|---|---|---|
docid | string | 是 | — | doc文档 ID |
content_type | string | 否 | markdown | 返回内容格式枚举：text / markdown / ooxml； |
返回
| 字段 | 类型 | 说明 |
|---|---|---|
url | string | 文档访问链接 |
name | string | 文档名称 |
content | string | 文档内容较短时直接返回的原文 |
file_path | string | 文档内容较长时自动落盘的本地文件路径；需用 Read 工具读取路径内文本后再展示 |
document | object | content_type=ooxml 时返回的文档对象 |
version | int | 文档版本号 |
跨技能依赖
| 依赖技能 | 何时触发 | 使用被依赖 skill 做什么 |
|---|---|---|
wecomcli-doc-manage | 用户只给文档名称/关键词，需先拿 docid 再读写内容 | 使用 wecomcli-doc-manage skill 搜索文档拿 docid |
wecomcli-smartpage | 读取doc文档内容后，用户要求"做成智能文档/排版成 smartpage" | 使用 wecomcli-smartpage skill 生成智能文档 |
参数缺失 / docid 搜索多候选等歧义场景，用简洁自然语言仅追问缺失或有歧义的信息；有候选项时在文字中列出供用户选择，不得自行猜测。
docid 使用规则
docid仅cli使用。
最终展示用户时，不应展示 docid，而是使用文档 URL：
[doc_name](doc_url)docid 是文档的唯一标识符，调用任何文档内容操作技能时均需提供。禁止自造 docid，按以下优先级获取：
- 从文档链接提取（优先）：用户提供了企微文档 URL 时，直接从 URL 中解析。URL 格式为
https://doc.weixin.qq.com/<type>/<docid>?scode=...，取/<type>/后、?前的部分即为 docid。
- 通过文档搜索获取（备选）：用户仅提供文档名称或关键词、未给链接时，先调用
wecomcli-doc-manage搜索文档，从返回结果中取docid。
- 用户直接提供：用户明确给出了完整
docid，可直接使用，无需再提取或搜索。