前言¶
公众号后台编辑器对版式支持有限，常见做法是手写 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
