gzh-design-skill 是一个面向 AI Agent 的微信公众号排版 Skill，可将 Markdown 一键转换为可直接粘贴到微信公众号编辑器的内联样式 HTML。项目内置 6 套公众号主题、主题生成器、Markdown 解析与排版工作流，并提供组件库校验与最终 HTML 合规校验脚本，重点解决公众号编辑器粘贴后样式丢失、排版不稳定、人工排版耗时等问题。
适用领域
微信公众号排版 / Markdown 转 HTML / AI Agent Skill / 内容创作工具 / 新媒体运营 / 富文本编辑 / 中文长文排版 / 主题组件库生成
配置难度
中等。对于熟悉 Git、Node.js、Python 和 Claude Code/Cursor 等 Agent 的开发者，上手较快；对于纯公众号运营人员，安装 Skill、运行脚本和处理文件路径有一定门槛。自定义主题和二次集成需要理解组件库规范、公众号 HTML 限制和 AGPL 协议。
商业价值
商业价值较高，尤其适合公众号作者、内容团队、AI 写作工具、知识管理工具和 Agent 平台集成。它解决了 Markdown 到微信公众号排版的高频痛点，可降低人工排版成本、提升内容交付效率和品牌视觉一致性。但由于 AGPL-3.0 限制，闭源商业化、SaaS 封装或私有化分发需要额外关注授权问题，建议商业团队在集成前联系作者确认合作协议。
01
技术亮点
- 专门针对微信公众号编辑器设计，强调粘贴后不掉格式。
- 所有样式内联，并要求文字使用 span leaf 包裹，适配公众号富文本过滤机制。
- 内置 6 套完成度较高的主题：摸鱼绿、红白、石墨极简、留白禅意、摸鱼票据、橄榄手记。
- 支持主题生成器，可根据一句话描述或参考图生成新的公众号主题组件库。
- 对中文内容友好，支持中文全角标点规范化，代码块内保持原样。
- 支持代码块、图片、GIF、引用、列表、产品徽章、目录、章节编号等常见长文元素。
- 提供双关卡质量校验：组件库源头校验和最终 HTML 产物校验。
- 适配多种 AI Agent，不强依赖某个模型或厂商。
- 排版逻辑沉淀在组件库和脚本中，输出稳定性比纯提示词方案更好。
- 对公众号作者和内容团队有直接生产力价值，可显著减少人工排版时间。
02
目标用户
- 微信公众号作者
- 新媒体运营人员
- 内容团队编辑
- 技术博主
- 知识付费作者
- 产品测评/工具盘点类创作者
- 使用 Claude Code、Cursor、Codex 等 AI Agent 的开发者
- 需要批量将 Markdown、Word、PDF 稿件转成公众号格式的团队
03
配置要求
- 需要 Node.js/npm 环境以使用 npx skills add 安装。
- 需要 Git 环境用于 clone 或更新仓库。
- 需要 Python 3 运行校验脚本 component_lint.py 和 validate_gzh_html.py。
- 需要一个能读取 Skill 目录的 AI Agent，例如 Claude Code、Codex、Cursor 或其他兼容 Agent。
- 输入内容最好为 Markdown；Word、PDF、纯文本需先按项目提供的格式归一化流程转换。
- 生成的 HTML 必须遵守微信公众号限制：不使用 style/script/div、class/id、CSS 变量、position、float、grid、外部字体等。
- 如果自定义主题，需要把主题登记到 theme-index，并通过 component_lint.py 校验。
04
适用场景
- 将 Markdown 长文排版成可直接粘贴到微信公众号后台的 HTML
- 为教程、测评、清单、深度文章、访谈、报告等内容自动套用合适主题
- 生成带代码块、图片、GIF、引用、目录、章节编号的公众号文章
- 根据品牌风格或参考图生成新的公众号排版主题
- 批量生成多套主题效果，供编辑选择最终样式
- 将 Word、PDF、纯文本内容先归一化为 Markdown，再生成公众号排版
- 通过校验脚本检查公众号平台禁用标签、样式和中文标点问题
- 为 AI Agent 产品增加公众号排版能力
05
部署与配置
- 推荐方式：运行 npx skills add https://github.com/isjiamu/gzh-design-skill 安装 Skill。
- 也可以让 Claude Code、Codex、Cursor 等 Agent 自动查找并安装该仓库。
- 手动方式：git clone https://github.com/isjiamu/gzh-design-skill.git ~/.claude/skills/gzh-design。
- 安装后，在 Agent 中输入类似“用摸鱼绿把 article.md 排成公众号 HTML”的指令。
- 生成后打开预览页，点击“复制到公众号”，再粘贴到微信公众号编辑器。
- 如需验证产物，运行 python3 scripts/validate_gzh_html.py out.html。
- 如需检查组件库，运行 python3 scripts/component_lint.py .。
06
风险与注意事项
- README 中仓库元数据显示 license 为 NOASSERTION，但文档声明为 AGPL-3.0，使用前应核实 LICENSE 文件，避免商业合规风险。
- AGPL-3.0 对闭源商业集成、SaaS 部署和二次分发限制较强，企业使用需谨慎评估。
- 项目主要服务微信公众号场景，不适合普通网页、落地页、PPT、海报或其他内容平台。
- 依赖 AI Agent 执行排版流程，实际效果会受到 Agent 文件读写能力、模型遵循规则能力和上下文长度影响。
- 微信公众号编辑器规则可能变化，未来可能出现新过滤策略，需要持续维护校验脚本。
- 复杂 Markdown、嵌套表格、特殊 HTML、非标准图片资源可能需要人工调整。
- 主题生成器产出的新主题仍需人工审美确认和脚本校验，不应完全无审核上线。
- 项目偏内容工具，不是完整 SaaS 产品，非技术用户可能需要开发者协助安装和使用。
2026-07-08
第6名
新收录 · github_search
