gzh-design-skill

环境要求

• 已安装 Node.js，可在终端使用 npx 命令
• 支持 Skill 的 AI 编程助手（Claude Code / Codex / Cursor 等）
• 一份写好的 Markdown 原文
• 可运行 Python 脚本的环境（用于组件库与产物校验）

安装与启动步骤

1. 1安装技能包

   在终端执行一行命令，把 gzh-design-skill 安装到你的 AI 助手中，装好后即可在助手内调用该技能。

   npx skills add https://github.com/isjiamu/gzh-design-skill

   复制

2. 2选择主题

   技能会按题材自动推荐最契合的主题并请你确认，默认是「摸鱼绿」；也可直接指定，或让 AI 现生成新主题。

3. 3提供 Markdown 原文

   把要排版的 Markdown 交给助手，它会识别标题、章节、加粗、高亮、引用、图片、代码块与列表。

4. 4装配并校验 HTML

   助手用组件库拼装 HTML，落实章节编号、关键词下划线、全角标点与签名合并，再跑校验脚本，ERROR 清零才交付。

5. 5复制到公众号

   打开生成的预览页，点右上角「复制到公众号」按钮把富文本复制到剪贴板，再粘进公众号编辑器，免手动全选。

关键配置

如何确认成功

校验脚本 validate_gzh_html.py 输出 ERROR 清零，且预览页能正常打开、点「复制到公众号」后粘贴进编辑器样式不掉。

常见问题

注意事项

• 生成的 HTML 样式全部内联、文字用 span leaf 包裹，规避 style/div/class/grid/position 等公众号会过滤的写法。
• 正文标点会自动规范为中文全角，代码块内的标点原样保留。
• 校验为双关卡：component_lint.py 管组件库源头，validate_gzh_html.py 管最终产物。