腾讯文档口述生成流程图和思维导图

概述

企业文档智能制作思维导图和流程图（WeCom MindFlow）v1.0.0

把"嘴上说的话"变成"团队能看的图"。用户口述 → AI 整理 → 企业微信智能文档承载 + 腾讯文档中文思维导图/流程图。

一、能力分层速览（先看清你能跑什么）

⚠️ 本 Skill 必须同时连接 wecom（企业微信）与 tencent-docs（腾讯文档）两个连接器才能跑通完整闭环。只连其一会卡在对应步骤，AI 会给出友好提示而非报错。

二、前置条件

执行前确认连接器已连接（左侧边栏「连接器管理」→ 连接并点「信任」）：

• wecom（企业微信）：用于创建智能文档、承载内容。机器人需具备「获取/创建成员文档内容」权限；若返回 851008，按提示在企业微信后台授权。
• tencent-docs（腾讯文档）：用于生成思维导图与流程图画板。

若任一未连接，先提示用户完成连接，不要硬跑。

三、工作流（口述 → 企微文档 + 双画板）

步骤 1：理解口述，澄清并结构化

• 用户可能给一段口语化描述（如"把咱前台接待的流程画一下，从客人进门到入住"）。
• 若信息不足（缺环节、缺角色、边界不清），主动反问 1–3 个关键问题再动手，不要臆造业务流程。
• 内部把内容拆成两类结构：
  • 层级/知识类（适合思维导图）：概念、分类、职责、知识点。
  • 步骤/流转类（适合流程图）：先后次序、判断分支、角色交接。
• 一份口述往往两者都有：思维导图给"全貌"，流程图给"走法"。

步骤 2：生成中文思维导图（腾讯文档）

DeferExecuteTool: mcp__tencent-docs__create_mind_by_markdown
参数:
  title: "<中文标题，如：前台接待知识地图>"
  markdown: "<Markdown 层级内容，支持中文>"

规则：

• 一级标题 # 为根节点；## 为一级分支；### 为二级分支；同级子项用 - 列表。
• 直接写中文，无需翻译。

# 前台接待知识地图
## 客人进门
- 问候与识别会员
- 行李协助
## 办理入住
- 证件核验
- 押金/支付
- 房卡发放
## 特殊情况
### 无房
- 升级或转介
### 投诉
- 现场安抚 + 主管介入

步骤 3：生成中文流程图（腾讯文档）

DeferExecuteTool: mcp__tencent-docs__create_flowchart_by_mermaid
参数:
  title: "<中文标题，如：前台接待流程>"
  mermaid: "<Mermaid 内容，支持中文>"

关键约束（纠正旧误区）：create_flowchart_by_mermaid 实测支持中文，无需翻译成英文/拼音。节点含中文或特殊字符时用引号包裹：A["客人进门"]、B["证件核验"]；subgraph 也用引号：subgraph OP["前台"]。换行用 <br/>。

flowchart TD
    A["客人进门"] --> B["识别会员"]
    B --> C{"有预定?"}
    C -->|有| D["核验证件"]
    C -->|无| E["查询空房"]
    D --> F["押金/支付"]
    F --> G["发放房卡"]
    G --> H["引导入房"]

步骤 4：企业微信智能文档承载 + 链接嵌回

把口述整理稿（结构化大纲/要点）写入企业微信智能文档，并把两个画板链接附在文末：

wecom-cli doc smartpage_create '{
  "title": "<中文标题>",
  "pages": [
    {
      "page_title": "口述整理",
      "content_type": 1,
      "page_filepath": "<本地Markdown文件路径>"
    }
  ]
}'

• content_type: 1 = Markdown；子页面内容来自本地 .md 文件（先落盘再传路径）。
• 返回 docid 与 url（企业微信文档访问链接）。
• 在文档正文末尾追加：
  • 思维导图：https://docs.qq.com/mind/<id>?_fid=<file_id>
  • 流程图：https://docs.qq.com/flowchart/<id>?_fid=<file_id>

（腾讯文档返回的 URL 必须追加 ?_fid=<file_id>，客户端才能正确打开）

步骤 5：返回结果

向用户返回：

1. 企业微信智能文档链接（主交付，团队在企业微信内可看）
2. 思维导图链接、流程图链接（可编辑、可协作）
3. 一句话说明"已把口述沉淀为企业微信文档 + 两张图"

四、URL 品类识别

若用户丢来一个已有企业微信文档想"加图"，走「读取 → 生成画板 → 把链接写回原文档」分支（读用 smartpage_export_task + smartpage_get_export_result，写回用 smartpage_create 新版本或提示用户手动贴链接）。

五、错误处理（友好提示，不抛代码）

六、常见问题（用户版）

• "一定要连两个连接器吗？" 是的。企业微信承载内容、腾讯文档出图，缺一不可；只连一个时 AI 会提示你先补齐。
• "流程图里的中文会乱码吗？" 不会。create_flowchart_by_mermaid 实测支持中文，节点用引号包裹即可（如 A["客人进门"]）。
• "生成的图能改吗？" 能。腾讯文档的思维导图/流程图都是可编辑画板，链接发出去团队可直接协作改。
• "我只有口头描述、没有文档，能用吗？" 正好适合。本 Skill 就是从口述出发的，无需任何现成文档。
• "图放在哪、同事怎么看？" 图在腾讯文档，链接嵌在你企业微信的智能文档里；同事在企业微信打开文档、点链接即可看/协作。

七、实测示例（真实生成，可点击验证）

口述内容：「把咱前台接待的流程画一下，从客人进门到入住。」→ AI 拆出知识地图 + 流程，跑通方案 A 闭环：

• 企业微信智能文档（主交付，团队在企微内可看）

https://doc.weixin.qq.com/smartpage/a1_AaIAGgapAPICNJB4Nm7FvQD6vuRYg?scode=AHkAQQcpACcDjwuZB4AaIAGgapAPI

• 腾讯中文思维导图（可编辑）

https://docs.qq.com/mind/DVlBweklwcUdMbkRm?_fid=VPpzIpqGLnDf

• 腾讯中文流程图（可编辑，mermaid 含中文节点）

https://docs.qq.com/flowchart/DVkFLRWVMQWdiZ3pH?_fid=VAKEeLAgbgzG

以上链接由本 Skill 的实际工作流生成，证明"口述 → 企微文档 + 双画板"可端到端跑通，且中文流程图无需翻译。

八、参考资源

• references/wecom-smartpage-api.md — 企业微信智能文档 API（承载/导出，含中文约束纠正）
• references/tencent-docs-canvas.md — 腾讯文档思维导图/流程图工具实战（中文 mermaid 详解）

九、安全与合规

1. 写操作（创建企微文档、生成腾讯画板）执行前向用户展示标题与内容摘要并获确认。
2. 文档仅写入用户指定/口述内容，不擅自拉取无关文档。
3. 返回给用户的链接统一追加 ?_fid=<file_id>。