gzh-design-skill：把 Markdown 一键排成公众号 HTML 的 AI 排版 Skill

一句话

gzh-design-skill 是一个给 AI Agent（Claude Code / Codex / Cursor 等）用的公众号排版 Skill：你写完 Markdown，它按你选的主题，生成样式全内联、粘贴到公众号编辑器不掉格式的 HTML——自动编章节号、标关键词下划线、配引言卡与目录、处理代码块和图片、合并作者签名，并用脚本确定性地兜住公众号平台的各种限制。

原仓库由 甲木（isjiamu）× 摸鱼小李 联名共建（2715⭐），crossoverJie（Apache Pulsar/HertzBeat Committer）fork 了该项目。

核心特性

6 套精选主题：摸鱼绿（默认）· 红白 · 石墨极简 · 留白禅意 · 摸鱼票据 · 橄榄手记——每套都是自成体系的厚组件库（设计变量 + 数十个精细组件 + 视觉层级表 + 文章类型配方表）
主题生成器：不满足现成主题？用一句话描述或一张参考图，生成一套全新组件库并保存本地复用
内容全兼容：代码块（深/浅色，等宽不折行）、图片、GIF（带动图角标）、行内代码、引用、列表、产品徽章、Markdown 超链接（自动转上标脚注 + 文末「参考资料」列表）
智能排版：章节自动编号（末章 ∞ / ///）、每段主动标 1–3 个关键词下划线、从正文提炼引言卡与目录、作者签名去重合并
中文全角标点：正文自动规范全角，代码块内原样保留
不掉格式：所有样式内联、文字 <span leaf=""> 包裹，规避 <style>/<div>/class/grid/position 等公众号会过滤的写法
双关卡质量校验：component_lint.py（组件库源头）+ validate_gzh_html.py（最终产物），构成可复现的「改→验→修」闭环
一键复制：生成带「复制」按钮的预览页，点一下把富文本复制到剪贴板，直接粘进公众号，免手动全选

快速开始

# 方式一：一行安装（推荐）
npx skills add https://github.com/isjiamu/gzh-design-skill

# 方式二：让 AI 自己装
# 对任意 Agent 说：请帮我查找并自动安装 https://github.com/isjiamu/gzh-design-skill 这个 skill

# 方式三：手动 clone
git clone https://github.com/isjiamu/gzh-design-skill.git ~/.claude/skills/gzh-design

装好后，直接对 Agent 说：「用摸鱼绿把这篇文章排成公众号 HTML：article.md」

亮点分析

这个 Skill 最值钱的地方在于确定性兜底：公众号编辑器会过滤 <style>/<div>/class/grid/position 等写法，很多排版工具粘贴后掉格式。它把所有样式内联 + <span leaf=""> 包裹，再用双脚本做「改→验→修」闭环，把 AI 输出的不确定性收进可控流程——这正是「AI Skill 工程化」的范本：组件库源头校验 + 最终产物校验，两层防线。

原仓库：https://github.com/isjiamu/gzh-design-skill（2715⭐）
文中截图/预览为 crossoverJie fork：https://github.com/crossoverJie/gzh-design-skill