公众号排版最让人头疼的往往不是写内容，而是反复调样式——而 gzh-design-skill 正是把「样式调整」这件事，交给了一套成熟的组件库和校验脚本来完成。
01
PART
它是什么：一套可复用的公众号排版引擎
WHAT · 定义
每次在公众号后台做图文排版，常常都像在和编辑器较劲：从 Word 粘贴过来的格式全部错乱、换一台电脑样式就丢失、想加一条下划线还得翻好几层菜单。
gzh-design-skill 的思路很明确：你只需要写 Markdown（也可以直接交给它 Word / PDF / 纯文本），它会自动生成一段「样式全部内联、粘贴进微信公众号编辑器也不掉格式」的 HTML。
需要特别说明的是：它只负责公众号文章排版，不负责代写内容。先有文章，再用它生成排版结果。
gzh-design-skill 是一个面向 AI Agent（Claude Code / Codex / Cursor 等）的公众号排版 Skill，本质上是一套「主题组件库 + 排版工作流 + 校验脚本」的完整方案。
核心资产是 references/ 目录下的 6 套主题组件库，每一套都包含设计变量、完整组件 HTML、文章骨架以及配方表。
开源协议
项目采用 AGPL-3.0 开源协议，任何人都可以安装、修改，也可以继续贡献新的排版主题。
02
PART
三种安装方式，选你最顺手的
INSTALL · 安装
装到哪里？只要是支持读取 skills 目录的 Agent（Claude Code / Codex / Cursor 等）都可以使用。下面提供三种安装方式，按自己的习惯选择即可。
01 一行命令（推荐）
使用 skills 安装器直接拉取，最快也最省心。
npx skills add https://github.com/isjiamu/gzh-design-skill
02 让 AI 自动安装
对于 Claude Code / Codex / Cursor 等任意 Agent，只需要直接说一句：「请帮我查找并自动安装 https://github.com/isjiamu/gzh-design-skill 这个 skill」，它通常就会自动完成查找，并自行 clone 到对应的 skills 目录中。
03 手动 clone
如果你熟悉命令行，也可以直接把仓库克隆到 skills 目录。
git clone https://github.com/isjiamu/gzh-design-skill.git ~/.claude/skills/gzh-design
安装完成后，直接对 Agent 说：「用摸鱼绿把这篇文章排成公众号 HTML：article.md」。
03
PART
怎么用：一句话完成公众号排版
USAGE · 流程
典型流程一共只有六步：选主题 → 读组件库 → 解析 Markdown → 装配 HTML → 校验 → 输出。中间的大多数细节，你几乎都不用操心。
给它一篇稿件，再指定一个主题（或者直接说「自动排」），Agent 会帮你自动完成这些事：
1
按照 ## 自动为章节添加编号（最后一章使用 ∞ 变体）。
2
为每一段主动标出 1–3 个关键词下划线，突出核心信息与重点观点。
3
提炼文章开头的引言卡片，并整理 3 个核心看点目录，让读者第一眼就能抓住重点。
4
处理代码块、图片、GIF，同时规范中文全角标点，提升整体阅读体验。
5
在文末统一合并作者签名区，避免重复落款，排版更整洁。
最后会生成两份产物：一份是纯
正文片段（用于手动粘贴兜底），另一份是带有「复制到公众号」按钮的预览页——浏览器打开后点一下，再去编辑器按 ⌘/Ctrl+V 即可。
04
PART
6 套内置主题，挑一套适合你的气质
THEMES · 主题
内置 6 套精选公众号排版主题，基本覆盖绝大多数内容题材；每一套都是独立成体系的厚组件库（设计变量 + 数十个精细组件 + 视觉层级表 + 配方表）。
01 摸鱼绿（默认）
适合教程、测评、清单、工具盘点等内容（卡片丰富、信息密度高）。
02 红白色系
适合深度分析、观点表达、力量感话题（经典编辑风格）。
03 石墨极简风
适合设计、科技评论、专业观点、高端品牌内容。
04 留白禅意风
适合禅意主题、极简生活、深度随笔类文章（呼吸感最强）。
05 摸鱼票据风
适合工具对比、创意评测等内容（票据式视觉隐喻更鲜明）。
06 橄榄手记
适合内刊手记、深度评测、案例复盘等内容（带有编辑部内刊质感）。
如果这些主题还不够用？你只需要用一句话描述，或提供一张参考图，就能让 AI 现场生成一套新的公众号排版主题，并登记下来供后续复用。