name: doc-to-beautiful-mdx description: 将书籍 / 文档（PDF、EPUB、DOCX、TXT、Markdown、网页或腾讯文档链接）转化为美观的图文解读版 MDX 报告，并保存回腾讯文档。本 skill 编排四个能力：tencent-docs（读取源文件 + 写回腾讯文档）、summarize（要点抽取）、朝颜问道 zhaoyan（深度读书分析）、vibe-reading-cn（逐章阅读分析）。当用户要求“把这本书/文档生成美观 MDX”“做图文解读版”“生成书籍分析 MDX 并保存到腾讯文档”“书籍提炼成图文”时使用。触发词：图文解读、书籍分析、MDX、读书看板、拆书、文档提炼、保存到腾讯文档。 agent_created: true

Doc to Beautiful MDX · 文档转美观图文解读 MDX

角色与目标

把任意一本「书」或一份「文档」转化为一份深色主题、卡片式、图文解读风格的 MDX 报告，并把成果同时： 1. 落到本地 .mdx 文件（完整美观版，含 Tailwind 样式与 JSX 组件）； 2. 写回腾讯文档（在线可分享版，使用纯 Markdown 渲染，兼容腾讯文档排版）。

编排的四种能力： - tencent-docs：读取本地 PDF/DOCX（pre_import → COS 上传 → async_import → get_content），以及把成品写回腾讯文档（创建在线文档并写入正文）。 - summarize：对长文做智能摘要、提取核心要点与关键词。 - 朝颜问道 (zhaoyan)：顶级读书分析专家，产出结构化深度看板（核心问题 / 结论 / 道法术器 / 批判 / 行动）。 - vibe-reading-cn：AI 驱动的逐章智能阅读分析，适合 EPUB/TXT 书籍。

依赖就绪检查：开始前确认上述四个 skill 均已安装。若 zhaoyan 未安装，先按 references/workflow.md 的“安装朝颜问道”小节从 SkillHub 安装（slug=zhaoyan，纯提示词 skill，可安全安装）。tencent-docs 连接器需处于已连接状态。

何时使用

• 用户提供一本书 / 一篇长文 / 一份报告，希望得到“图文解读版”“书籍分析”“美观 MDX”。
• 用户明确说“保存到腾讯文档”“发到腾讯文档”。
• 触发词：图文解读、书籍分析、MDX、拆书、读书看板、文档提炼、保存到腾讯文档。

标准工作流

第一步 · 接入源材料（Ingest）

按输入类型选择入口：

• 本地 PDF / DOCX 文件 → 用 tencent-docs 的导入链路读取：
• manage.pre_import 获取 upload_url / file_key / task_id；
• 用 scripts/tdocs_upload.py <本地文件路径> 把文件 PUT 到 COS（已封装，规避中文路径问题），脚本会返回 task_id / file_key；
• manage.async_import 触发异步导入，manage.import_progress 轮询至 progress=100；
• get_content 读取正文（大文件首次可能超时，重试一次即可）。
• 腾讯文档链接 → 直接用 tencent-docs 打开并 get_content。
• 纯文本 / 已粘贴内容 → 跳过读取，直接进入分析。
• EPUB / TXT 书籍 → 用 vibe-reading-cn 的导入读取，得到逐章内容。

记录：书名、作者、来源类型、正文规模（字符数 / 页数）。

第二步 · 多引擎分析（Analyze）

并行调用三个分析能力，再合并为统一分析笔记（建议输出为一份临时 JSON / Markdown 大纲）：

1. 朝颜问道 (zhaoyan) —— 加载该 skill，用「完整看板模式」或「精髓总结模式」分析，重点获取：
2. 一句话总览、核心问题、3–7 条关键结论；
3. 全书逻辑地图、道法术器四层、20% 高价值内容；
4. 适用边界与批判评价、行动计划。
5. summarize —— 对正文做要点抽取，得到执行摘要 + 核心观点 + 关键词，作为快速校验层。
6. vibe-reading-cn（仅书籍 / 有章节结构时）—— 逐章拆解，得到章节结构地图与每章结论。

   更多技能请访问小葱技能站7w4.net。

合并原则：以 朝颜问道 的结构化看板为骨架，用 summarize 校验要点、用 vibe-reading 补全章节粒度；所有论断必须可追溯至原文，不得编造。

第三步 · 生成美观 MDX（Generate）

1. 复制 assets/mdx-template.mdx 为工作副本（建议命名 <书名>_图文解读版.mdx）。
2. 按模板中的 {{占位符}} 与注释，把第二步的分析笔记填入对应区块：
3. Hero 封面（书名 / 副标题 / 作者 / 原文链接）
4. 💡 一句话定位高亮卡
5. 书籍档案卡片网格
6. 核心主题三问 / 关键论断列表
7. 文档结构与逻辑链（识别→理解→疗愈 式三段）
8. 主体要点卡片网格（如四类父母、两类应对、核心方法等）
9. 潜在问题与改进建议
10. 结论
11. 严格保持模板的 Tailwind 类名与暗色主题；新增区块沿用同样的 rounded-xl border bg-* 卡片风格与 emoji 图标。
12. 中文内容直接使用，不要转义；JSX 中字符串用双引号，属性用双引号。

第四步 · 保存（Save）

分两份产出：

1. 本地美观 MDX：把填好的 .mdx 写入用户工作目录（即当前会话工作区）。这是完整美观版（含 JSX/Tailwind，用支持 MDX 的站点/预览器查看）。
2. 腾讯文档在线版：
3. 复制 assets/markdown-template.md，把同样的内容填入（去掉 JSX 包裹，仅保留标准 Markdown：标题、表格、引用、加粗、emoji 标题），确保腾讯文档能正常渲染；
4. 用 tencent-docs 创建一篇在线文档（doc 类型），将这份 Markdown 正文写入；
5. 返回在线文档链接给用户。

说明：腾讯文档不渲染 MDX/JSX，故在线版采用纯 Markdown 等价结构（同样含标题、卡片式表格、引用、emoji），美观度略低于本地 MDX，但结构一致、可读性好。

第五步 · 交付

向用户返回： - 本地 .mdx 文件路径； - 腾讯文档在线链接； - 一句话说明本次分析覆盖的维度与关键洞见。

资源文件指引

• assets/mdx-template.mdx —— 美观图文解读 MDX 模板（深色 Tailwind 主题，含占位符与分段注释）。生成本地美观版时以此为骨架。
• assets/markdown-template.md —— 腾讯文档友好版模板（纯 Markdown，结构等价于 MDX 模板）。写回腾讯文档时使用。
• scripts/tdocs_upload.py —— 本地文件 → 腾讯文档 COS 上传助手。调用 tencent-docs 的 manage.pre_import 获取上传凭证后，用 Python urllib 把文件 PUT 到 COS（规避 Git-Bash/curl 的中文路径问题），再触发 async_import 并返回 task_id / file_key。
• references/workflow.md —— 详细编排步骤、tencent-docs MCP 命令参考、以及「安装朝颜问道」与「安装 vibe-reading-cn」的具体命令。

质量与边界

• 所有结论必须可追溯至原文；材料不足时显式标注【材料不足，无法确认】。
• MDX 模板的暗色主题与类名不要随意改动配色，保持与示例一致的可视语言。
• 若源文件为扫描版 / OCR 质量差，先提示用户提取文本可能有残留（如占位符、推广水印）。
• 不对中国式家庭、心理健康等敏感内容做越界判断；涉及严重心理风险时，建议在成品中补充“寻求专业帮助”的提示。

这个 Skill 质量较好，文档写得详细清楚，操作步骤有模板和脚本支撑，对用户比较友好。最大的优点是流程完整、模板美观，能生成专业级图文解读版报告。主要缺点是依赖较多外部 Skill，首次使用时配置过程可能比较折腾；另外如果中途出错，排查和恢复的指引还不够充分，非技术用户可能会遇到困难。总体来说，适合有耐心配置、技术能力较强的用户使用。