前言¶
公衆號後臺編輯器對版式支持有限，常見做法是手寫 HTML 或套用第三方排版工具，再整段粘貼。稿件來源往往是 Word、PDF 或純文本，先要整理成結構清晰的 Markdown，再單獨處理目錄、代碼塊、引言樣式和主題統一，步驟多且容易在粘貼後走樣。
下面介紹 GZH Design Skill：在 Agent 裏把文稿轉成面向公衆號編輯器的 HTML，並支持從主題庫選型或按需生成自定義組件庫。
這是什麼¶
GZH Design Skill 是 SkillHub 上的社區 Skill（座標 @user_c1ee5550/gzh-design-skill，版本 1.0.0，分類 content-creation）。發佈者爲 user_c1ee5550，標籤標明 requires_api_key=false，無需額外 API Key。
定位是微信公衆號文章排版引擎：將 Markdown 轉換爲可直接粘貼到公衆號編輯器的 HTML。它不面向普通網頁、落地頁或 PPT；這類需求應使用前端或 PPT 類 Skill。
SkillHub 頁面：https://www.skillhub.cn/skills/user_c1ee5550/gzh-design-skill
API 入口：https://api.skillhub.cn/user_c1ee5550/gzh-design-skill
核心功能¶
以下能力均來自官方簡介，安裝後可按 Skill 內 SKILL.md 與 references/theme-index.md 執行。
輸入與歸一化
- 支持 Markdown、Word（
.docx）、PDF、純文本。 - 非 Markdown 輸入會先自動歸一化，再進入排版流程。
排版與結構
- 自動章節編號。
- 關鍵詞下劃線標記。
- 引言卡片、目錄導航。
- 代碼塊、圖片/GIF、作者簽名等公衆號常見模塊。
主題
- 主題從
references/theme-index.md註冊的自定義主題庫中選取。 - 可根據文字描述或參考圖生成自定義主題組件庫，並保存到本地複用。
一鍵自動排版
- 自動推斷文章結構並選擇主題，適合尚未定稿式樣的長文。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式，通過 SkillHub CLI 安裝到當前 Agent 的 skills 目錄；裝錯目錄時 Agent 不會加載該 Skill。
1、安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝 GZH Design Skill¶
將 --dir 指向當前環境的 skills 目錄。常見路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
skillhub install @user_c1ee5550/gzh-design-skill --dir ~/.cursor/skills/
也可把下面提示交給 Agent，讓其按 SkillHub 安裝文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_c1ee5550/gzh-design-skill`。
安裝後按所用客戶端要求刷新或重啓會話，使 Skill 被識別。
典型用法¶
Skill 在對話中由意圖觸發，無需記憶固定 CLI 子命令。官方列出的典型場景如下。
把文稿轉成公衆號 HTML
- 提供 Markdown 文件，或上傳
.docx/ PDF / 純文本。 - 說明需要「公衆號排版」或「轉成可粘貼的公衆號 HTML」。
- Agent 按 Skill 規則選主題、生成 HTML；你將結果粘貼進公衆號後臺即可。
示例表述：
用 gzh-design 把這篇 Markdown 排成公衆號文章，主題從 theme-index 裏選偏技術博客的那套。
一鍵自動排版
適合結構未定、希望 Agent 推斷章節並匹配主題時：
一鍵排版：這份 Word 導出成公衆號 HTML，自動選主題。
自定義主題
按這張參考圖生成一套公衆號排版組件庫，登記到 theme-index，以後複用。
具體主題名、組件命名以 Skill 包內 references/theme-index.md 爲準。
適用場景與注意¶
適合
- 經常寫公衆號長文，希望 Markdown 與最終後臺版式一致。
- 稿件來源混雜（Word/PDF/筆記），希望先歸一化再統一排版。
- 需要固定品牌樣式，或偶爾按參考圖擴展主題庫。
不適合
- 生成獨立網站、營銷落地頁、幻燈片；應換用對應前端或演示類 Skill。
使用注意
- 輸出目標是公衆號編輯器可接受的 HTML，粘貼後仍建議在後臺預覽一遍（尤其圖片、外鏈與代碼塊）。
- 主題與組件以本地 Skill 包中的
references/theme-index.md爲索引；升級 Skill 版本（當前頁面標註 v1.0.0）後留意主題註冊項是否有變更。 - SkillHub 統計（以腳本抓取爲準）：評分 100000，下載 12373；頁面展示數據會隨時間變化，以 SkillHub 爲準。
結尾¶
GZH Design Skill 把「歸一化文稿 → 選主題 → 生成公衆號 HTML」收攏到 Agent 對話裏，並支持一鍵排版與本地主題擴展。若你已在用 Cursor、Claude Code 或 Codex 寫稿，可先安裝 @user_c1ee5550/gzh-design-skill，用自然語言描述排版需求即可。
官方地址：https://www.skillhub.cn/skills/user_c1ee5550/gzh-design-skill
