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（僅書籍 / 有章節結構時）—— 逐章拆解，得到章節結構地圖與每章結論。

合併原則：以 朝顏問道 的結構化看板為骨架，用 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 圖示。

    7w4.net提供免費和付費技能下載。

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，首次使用時配置過程可能比較折騰；另外如果中途出錯，排查和恢復的指引還不夠充分，非技術使用者可能會遇到困難。總體來說，適合有耐心配置、技術能力較強的使用者使用。