一页结论

判断:这是一个值得关注、也值得试装的中文 Agent Skill。它的亮点在于把“公众号排版”这个高度经验化、容易粘贴掉样式的工作,拆成了主题组件库、装配规则、平台红线和脚本校验四层。它不是普通前端项目,也不是 npm/Python 包,更像一套给 Claude Code、Codex、Cursor、OpenClaw 这类 Agent 调用的可执行排版规范。

建议:如果你的目标是把长文、报告、教程快速变成微信公众号可粘贴 HTML,可以安装试用;如果要商用改造、二次分发或并入闭源产品,需要先注意 AGPL-3.0 的合规边界。

我给的评级

实用性:高。场景清晰,痛点真实,样例和校验脚本都能跑。

工程成熟度:中上。结构完整,但仍是 2026-07 初的新仓库,生态反馈刚开始。

可装价值:高。尤其适合你的“报告发布 + 微信公众号复用”工作流。

最核心的风险

许可证是 AGPL-3.0。自己本地使用问题不大;如果改造成联网服务、商业闭源排版引擎或内嵌到产品,需要认真处理开源义务。

安装体系仍偏 Agent 生态。不是传统包管理项目,没有 package.json、pyproject 或 requirements。

仓库快照

仓库isjiamu/gzh-design-skill
定位Markdown 到微信公众号可粘贴 HTML 的 Agent Skill
创建时间2026-07-01
最近 push2026-07-08
最新 releasev1.0.0 · 联名首发,2026-07-06 发布
GitHub 热度约 1,802 stars、204 forks、3 watchers(2026-07-10 快照)
许可证AGPL-3.0-or-later,GitHub API 显示为 Other,但 LICENSE 正文为 AGPL-3.0
打开事项1 个 open issue、2 个 open PR:快速试用入口、两阶段排版模式、背景检查

它解决了什么

公众号排版的麻烦不是“生成 HTML”本身,而是公众号编辑器会过滤样式:禁用 <style><div>class/id、部分 CSS 布局,还要求大量样式内联。这个仓库的价值是把这些规则写进 Skill 和校验脚本,让 Agent 不只是“凭感觉排版”,而是按固定主题组件装配,然后用脚本兜底。

仓库当前提供 6 套主题:摸鱼绿、红白、石墨极简、留白禅意、摸鱼票据、橄榄手记,并带主题生成器。每套主题不是单张 CSS,而是包含设计变量、组件、文章模板骨架、文章类型配方表和 Markdown 映射规则。

结构与资产

目录/文件作用评价
SKILL.mdAgent 工作流入口:格式归一化、选主题、读组件库、装配、校验、输出写得很像可执行 SOP,适合 Agent 读取
references/theme-*.md主题组件库内容厚,单主题数百到近千行,不是空模板
references/theme-generator.md按描述或参考图生成新主题对二次扩展很关键
scripts/validate_gzh_html.py最终 HTML 合规校验能检查禁用标签、属性、CSS、span leaf 包裹和半角标点
scripts/component_lint.py组件库源头检查把常见反模式前置到组件层
docs/gallery/主题预览 HTML便于肉眼看效果,也能用脚本回归

本地核验

我做了本地浅克隆,并运行了仓库自带的两个校验脚本。结果如下:

python3 scripts/component_lint.py .
结果:11 个组件库,ERROR x 0,WARN x 2

python3 scripts/validate_gzh_html.py docs/gallery/moyu-green.html
结果:完全合规

python3 scripts/validate_gzh_html.py docs/gallery/red-white.html
结果:完全合规

python3 scripts/validate_gzh_html.py docs/gallery/graphite-minimal.html
结果:完全合规

两个 WARN 来自 theme-moyu-greentheme-olive-journal 的四周虚线框提示,属于源头检查器的风格提醒,不是致命错误。最终 gallery 产物能通过校验,说明它的“组件源头检查 + 最终 HTML 检查”闭环是可用的。

和 OpenClaw/Codex 的适配

从仓库结构看,它天然适合 Agent Skill 体系:根目录有 SKILL.md,任务流程明确,引用资料都在 references/,脚本不依赖复杂包。对 OpenClaw/Codex 来说,最实际的接入方式有两种:

  1. 作为外部 skill 安装:按仓库 README 的 npx skills add https://github.com/isjiamu/gzh-design-skill 或手动 clone 到合适的 skills 目录。
  2. 作为报告发布链路的一环:先在本地生成 Markdown/HTML 报告,再用这个 skill 生成一份公众号可粘贴版。

我更推荐第二种:它和你现在的 GitHub Pages 报告流互补。Pages 负责公开长报告,gzh-design-skill 负责把同一份内容转换成微信公众号版本。

风险与不足

  • AGPL-3.0 风险:本地自用和开源共创没问题;如果改成私有 SaaS 或嵌入商业闭源产品,要先处理源码开放义务。
  • 新仓库风险:仓库创建于 2026-07-01,生态反馈还少,open issue/PR 数量不多,仍处于快速打磨期。
  • 非传统包:没有 package.json、pyproject、requirements.txt,不能按普通库的依赖治理方式评估。
  • 效果依赖 Agent 执行质量:组件和规则很完整,但最后仍需要 Agent 正确读取主题库、完整转换原文、跑脚本并修 warning。
  • 公众号平台可能变化:微信编辑器过滤规则若变化,校验脚本需要跟着维护。

最终建议

可以装,而且值得试跑。它和你的工作流很贴:你经常做报告、分析、文章沉淀,这个库能把“发布到网页”和“复制到公众号”之间的最后一段人工排版压缩掉。

下一步建议不是马上深度改造,而是先拿一篇现有报告做试验:把 Markdown 输入给 skill,生成公众号 HTML,复制到公众号编辑器,看样式保真度、图片处理、关键词下划线和签名区是否符合你的口味。试跑通过后,再考虑把它接入固定的报告发布流程。