一個寫書，一個出書
花叔橙皮書逆向skill成個流程教學

如果你想整一本技術電子書，唔好一開波就揾「萬能寫書Prompt」。更加穩陣嘅流程係兩段：創作歸創作，排版歸排版。

呢兩個項目都係出自ZeroxZhang。huashu-bookwriter 係「花叔橙皮書創作Skill（逆向工程版）」，README入面講明佢係根據花叔已出版嘅技術書籍同開源倉庫整理出嚟。md2book 而呢個就係Markdown到PDF電子書嘅排版工具。

先睇下花叔原版嘅效果：

項目地址：

下載項目文件到本地，如果喺WorkBuddy入面用，安裝目錄通常係：

注意：呢個係逆向工程版，唔係花叔官方公開嘅原始Skill。花叔嘅橙皮書製作skill冇開源，不過根據實際評測，喺橙皮書類書籍嘅生成上還原度可以達到95%以上。

huashu-bookwriter 本身重點係寫作框架，但倉庫README都包括PDF導出同結構驗證腳本。公開嘅README提到嘅依賴包括：

檢查命令：

如果你只係將佢當做「書籍創作Skill」嚟用，核心係要Skill生成Markdown書稿。PDF導出可以交畀後面嗰個 md2book。呢個都係我更推薦嘅方式：創作歸創作，排版歸排版。

啟動Skill之後，唔好直接話「幫我寫一本書」。最好先講清楚本書嘅類型。佢支援3種書籍藍圖：

都支援3種章節模板：

可以咁樣提需求：

生成之後，先檢查4樣嘢：

huashu-bookwriter 嘅價值唔係「寫多啲字」，而係將書籍藍圖、章節模板、寫作風格同QC規則打包埋一齊。佢適合技術手冊、快速指南、橙皮書，唔適合小說、純理論書或者需要複雜插圖嘅設計書。

交給 md2book 之前，建議幫Markdown加frontmatter。示例：

md2book 支援GFM、表格、代碼塊、引用塊、圖片、callout同自動目錄。callout可以寫成：

唔建議直接塞Mermaid、LaTeX、數學公式。當前本機 md2book 說明寫得好清楚：呢啲需要額外渲染管道。

項目地址：

下載md2book項目文件到本地，如果你喺WorkBuddy已安裝環境入面用，本機路徑通常係：

按當前 md2book README同本機Skill文件，主要依賴係：Node.js、npm、Playwright、Chromium。

進入腳本目錄：

喺WorkBuddy本機安裝路徑下，可以咁樣行：

如果 --check 輸出環境檢查通過，即係話依賴準備好曬。

呢度要留意一個信息差：開發者喺huashu-bookwriter提過用pandoc + XeLaTeX做排版同PDF輸出，但係當前 md2book README更明確指向Node.js + Playwright + Chromium。實際使用上，建議按當前 md2book 嘅要求準備環境（即係後者），前者可能係舊版方案或者用於其他導出場景。

最基本命令：指定主題 + 指定輸出路徑。三套主題點樣揀：

技術電子書優先揀 minimal。先跑通，再調主題。

呢個係我測試導出嘅效果：

本機 md2book Skill入面補咗一個實用機制：PDF導出失敗時，會保存HTML降級產物，並用 --verbose 或 --check 幫你定位問題。

常見問題：

唔好見到生成PDF就當完成。至少檢查呢8項：

我嘅建議都好簡單：

先由huashu-bookwriter生成書稿。

如果已經有Markdown，直接用md2book處理排版導出。

一個寫書，一個出書
花叔橙皮書逆向skill全流程教程

如果你想做一本技術電子書，不要一上來就找"萬能寫書 Prompt"。更穩的流程是兩段：創作歸創作，排版歸排版。

這兩個項目都來自 ZeroxZhang。huashu-bookwriter 是"花叔橙皮書創作 Skill（逆向工程版）"，README 裏明確說它基於花叔已出版技術書籍和開源倉庫整理而來。md2book 則是 Markdown 到 PDF 電子書的排版工具。

先看看花叔原版的效果：

項目地址：

下載項目文件到本地，如果是在 WorkBuddy 裏用，安裝目錄一般是：

注意：這是逆向工程版，不是花叔官方公開的原始 Skill。花叔的橙皮書製作 skill 並沒有開源，但根據實際測評，在橙皮書類書籍的生成上還原度可達 95% 以上。

huashu-bookwriter 本身重點是寫作框架，但倉庫 README 也包含 PDF 導出和結構驗證腳本。公開 README 提到的依賴包括：

檢查命令：

如果你只把它當"書籍創作 Skill"使用，核心是讓 Skill 生成 Markdown 書稿。PDF 導出可以交給後面的 md2book。這也是我更推薦的方式：創作歸創作，排版歸排版。

啓動 Skill 後，不要直接說"幫我寫一本書"。最好先把書的類型說清楚。它支持 3 種書籍藍圖：

也支持 3 種章節模板：

可以這樣提需求：

生成後，先檢查 4 件事：

huashu-bookwriter 的價值不是"多寫字"，而是把書籍藍圖、章節模板、寫作風格和 QC 規則打包。它適合技術手冊、快速指南、橙皮書，不適合小說、純理論書或需要複雜插圖的設計書。

交給 md2book 前，建議給 Markdown 加 frontmatter。示例：

md2book 支持 GFM、表格、代碼塊、引用塊、圖片、callout 和自動目錄。callout 可以寫成：

不建議直接塞 Mermaid、LaTeX、數學公式。當前本機 md2book 說明裏寫得很清楚：這些需要額外渲染管道。

項目地址：

下載 md2book 項目文件到本地，如果你是在 WorkBuddy 已安裝環境裏用，本機路徑通常是：

按當前 md2book README 和本機 Skill 文件，主要依賴是：Node.js、npm、Playwright、Chromium。

進入腳本目錄：

在 WorkBuddy 本機安裝路徑下，可以這樣跑：

如果 --check 輸出環境檢查通過，說明依賴就緒。

這裏要注意一個信息差：開發者在 huashu-bookwriter 提到過使用 pandoc + XeLaTeX 進行排版和 PDF 輸出，但當前 md2book README 更明確指向 Node.js + Playwright + Chromium。實際使用中，建議按當前 md2book 的要求準備環境（即後者），前者可能是舊版方案或用於其他導出場景。

最基本命令：指定主題 + 指定輸出路徑。三套主題怎麼選：

技術電子書優先用 minimal。先跑通，再調主題。

這是我測試導出的效果：

本機 md2book Skill 裏補了一個實用機制：PDF 導出失敗時，會保存 HTML 降級產物，並用 --verbose 或 --check 幫你定位問題。

常見問題：

別看到生成 PDF 就結束。至少檢查這 8 項：

我的建議也很簡單：

先從 huashu-bookwriter 生成書稿。

如果已有 Markdown，直接用 md2book 處理排版導出。