简介

gzh-design-skill是一款专为AI Agent设计的公众号排版Skill，旨在将Markdown格式的文稿一键转换为可直接粘贴进微信公众号编辑器的精致HTML页面。该工具由甲木与摸鱼小李联名共建，核心解决了公众号排版中样式丢失、格式错乱等长期痛点。公众号编辑器会过滤<style>标签和外链CSS，只保留元素上的style属性，因此生成全内联样式的HTML是确保格式不掉的关键。gzh-design-skill通过将所有样式内联到每个元素的style属性中，并采用<span leaf="">包裹文字，有效规避了平台限制，用户只需全选复制粘贴即可完成发布

在功能层面，工具内置了6套经过精心打磨的精选主题：摸鱼绿（默认）、红白色系、石墨极简风、留白禅意风、摸鱼票据风和橄榄手记，每套主题都包含完整的组件库、色值体系、标题骨架和正文标记方式，能够覆盖教程测评、深度分析、科技评论、禅意随笔、创意评测和内刊手记等多种文章类型。更值得关注的是其主题生成器模块，用户可以通过一句话描述期望风格，如“黑白杂志风格、克莱因蓝点睛、衬线字体”，或上传一张参考图，工具便会自动抽取视觉偏好并生成一套全新的排版组件库，将审美偏好转化为可执行的主题变量

在质量控制方面，gzh-design-skill设计了两道校验关卡：第一道是源头关，通过component_lint.py扫描组件库，检查是否存在平台禁用写法；第二道是产物关，通过validate_gzh_html.py扫描最终生成的HTML，确保禁用标签、文字包裹和标点符号等问题全部清零，形成“改→验→修”的可复现闭环。该Skill不依赖特定模型，Claude、GPT、Gemini以及DeepSeek、Kimi、通义千问、智谱GLM等国产模型都能跑出一致效果，排版逻辑沉淀在组件库和校验脚本中，模型只负责按规则填充内容，硬约束由脚本确定性兜底。安装方式也极为简单，执行npx skills add https://github.com/isjiamu/gzh-design-skill即可完成安装，装好后对Agent说“用摸鱼绿把这篇文章排成公众号HTML”即可触发排版流程