gzh-design-skill (公众号排版)
把 Markdown（或 Word/PDF/纯文本）一键排成可直贴微信公众号编辑器的合规 HTML：内置 6 套主题组件库、自动章节编号与关键词下划线、双关卡校验脚本兜底、带一键复制预览页，还支持按描述/参考图生成自定义主题。
仓库：isjiamu/gzh-design-skill
热度证据：中文爆文报道 1.7k 星(现 GitHub 3k+),知乎『超赞 skill 推荐』问答高赞提名;公众号排版需求走红,6 套主题全内联 HTML
五维评分
热度4/5
质量5/5
创新4/5
易用5/5
文档5/5
优秀点拆解
- 双关卡确定性校验：validate_gzh_html.py 用 15+ 条正则把公众号会过滤的标签/属性/样式标成 ERROR，并用 HTMLParser 检查每个中文节点是否被 <span leaf> 包裹、是否混半角标点；component_lint.py 在组件库源头查反模式，构成可复现的改→验→修闭环
- 单一来源索引 + 组件库分层：theme-index.md 是主题唯一权威（主题/主色/适用场景/组件库文件/下划线CSS），通用增量库与主题专属库分离，SKILL.md 明确「HTML 一律从组件库取不凭记忆手写」，杜绝组件幻觉与跨主题混用
- 审美规则化：先判文章类型再按「类型→组件组合配方表」选组件保证气质稳定；三层视觉层级（锚点≤5处/每段1-3个关键词下划线/容器按需）把设计原则写成可执行计数规则
- 交互壳与产物隔离：wrap_preview.py 把合规 section 包进带「复制到公众号」按钮的预览页，JS/按钮只在壳里不进被复制的正文，用户一键复制且粘贴产物保持干净合规
- Gotchas 实战踩坑清单：漏 span leaf、图片 width:100% 拉伸、white-space:pre 大空白、占位图残留、虚线框抢戏等 14+ 条真实坑全部显式编码为规则
可复用的设计模式
- 平台约束→双关卡校验脚本：把外部平台隐性限制写成源头 lint + 产物 validate 两个确定性关卡，交付前强制跑 ERROR 清零
- 知识分层与资产解耦：SKILL.md 只留流程与决策，具体 HTML 下沉 references/ 组件库，索引表路由 + 通用库共享，主文件保持可读、资产可独立扩充
- 质量规则化 + 反例清单：可计数规则（锚点≤5、每段1-3标记）与「不许做」清单（不用虚线框、不硬造图片说明）双管齐下稳定模型输出
- 生成器自举扩展：生成→转换→登记→lint 流水线让主题资产随用户偏好自我生长，预览整页一次浏览降低确认成本
适用场景
公众号长文排版：观点/深度分析、教程、测评盘点、数据复盘、随笔，Markdown/Word/PDF/纯文本输入批量/快速排版：全自动模式（自动推断结构+按题材选主题+免确认）适合日常高频发稿自定义品牌风格：用一句话描述或一张参考图生成全新主题组件库并长期复用统一多篇稿件排版风格：6 套主题按题材推荐，保证同一账号风格一致
边界与注意：只排版不代写（先有 Markdown 再用）；不适用普通网页/落地页/PPT/纯图片海报和非公众号平台；规则针对微信编辑器白名单特化，校验脚本只能查已知反模式；主题生成器质量依赖底层模型遵循生成提示词
完整拆解分析文档
本页为摘要版，完整精读分析（核心机制、逐条优秀点拆解、写作过程）见本地 Markdown 文档：
analysis/gzh-design-skill.md