gzh-design-skill · 公众号排版技能
把 Markdown 一键排成可直接粘贴进微信公众号编辑器的精致 HTML，内置 6 套精选主题与主题生成器，双关卡校验保证样式不丢失。
证据显示：技能仅处理本地Markdown文件，输出HTML，无网络请求或外部数据访问，权限需求低。工作流要求用户确认主题选择，输出前运行验证脚本，提供预览页面供用户检查。数据流透明：输入输出均为本地文件，无隐藏数据处理。未涉及敏感数据，但未明确说明。依赖仅Python标准库，但未提供依赖清单或安全审计。外部影响限于生成HTML文件，无系统级更改。回滚机制未明确，但可通过版本控制实现。来源归属明确：README和LICENSE中标注了作者和共同作者。扣分原因：依赖安全未提供具体依赖列表或安全审计；回滚机制未明确文档化。
证据显示：README描述的工作流与SKILL.md等文件一致，脚本和文档相互印证。依赖为Python标准库，可用性高。验证脚本提供明确的错误信息，指导用户修复。扣分原因：未提供实际运行测试，但静态审查未发现不一致。
证据显示：README详细列出了适用场景和不适用场景，明确能力边界。触发方式明确：用户提供Markdown文件并指定主题。环境适配：支持Claude Code、Codex、Cursor等，但未提供具体环境配置要求。扣分原因：触发精度未提供具体命令示例，环境适配未详细说明。
证据显示：README结构清晰，包含安装说明、使用示例、FAQ、已知限制（平台限制）、许可证（AGPL-3.0）、维护责任（作者和共同作者）。但未提供版本历史或变更日志。扣分原因：版本控制信息缺失。
证据显示：输出为可直接粘贴的HTML，提供预览和复制按钮，实用性高。边际价值：提供6套主题和生成器，节省排版时间。成本效益：安装简单，使用免费，但需要用户具备一定技术能力。扣分原因：成本效益未量化，但整体良好。
证据显示：README中的功能描述与脚本和文档一致，但未提供独立验证。事实与推断分离：README明确区分了功能描述和设计理念。扣分原因：跨来源验证不足，仅依赖单一来源。
- 依赖安全未提供具体依赖清单或安全审计，建议用户自行检查。
- 回滚机制未明确文档化，建议用户使用版本控制管理。
- 版本历史或变更日志缺失，建议用户关注更新。
这个 Agent 能做什么，适合哪些场景？
gzh-design-skill 是一个面向 AI Agent（如 Claude Code、Codex、Cursor）的排版技能，它读取 Markdown 文件，根据用户选择或自动推荐的主题，生成样式全内联、可直接粘贴到微信公众号编辑器的 HTML。项目包含 6 套精选主题（摸鱼绿、红白色系、石墨极简、留白禅意、摸鱼票据、橄榄手记），每套主题都是完整的组件库，还提供主题生成器，可通过一句话描述或参考图生成全新主题。核心工作流定义在 SKILL.md 中，通过 references 目录下的组件库和 scripts 目录下的两个校验脚本（component_lint.py 和 validate_gzh_html.py）形成可验证的「改→验→修」闭环，确保生成的 HTML 符合公众号平台限制（如禁用 style/div/class 等）。输出为纯文本 HTML，并附带带「复制」按钮的预览页，用户浏览器打开后一键复制到公众号编辑器即可。
该技能的核心操作包括：读取用户提供的 Markdown 文件，根据文章题材自动推荐并确认主题（默认摸鱼绿）；读取所选主题的组件库（references/theme-*.md）和通用组件库（references/common-components.md）；解析 Markdown 的标题、章节、加粗、高亮、引用、图片、代码块、列表等元素；使用组件库中的真实组件装配 HTML，并落实章节自动编号、关键词下划线、全角标点规范、作者签名去重合并等细节；运行 scripts/validate_gzh_html.py 校验最终 HTML，要求 ERROR 清零；最后输出干净正文和带「复制」按钮的预览页，用户浏览器打开预览页点击「复制到公众号」即可粘贴。此外还支持主题生成器工作流（见 references/theme-generator.md），按用户描述或参考图生成 45-75 个区块的 HTML 组件库，转换后登记进 theme-index。
- 自媒体作者写完观点长文（Markdown），想快速排好发公众号，用「红白」主题一键生成带关键词下划线和金句引用的 HTML。
- 技术博主输出教程或工具清单，推荐用默认「摸鱼绿」主题，自动编号章节、代码块和卡片布局。
- 产品经理拿到 Word/PDF 稿，先用 format-normalize 归一化成 Markdown，再按题材选主题排版发公众号。
- 设计类公众号想要极简风格，选用「石墨极简」或「留白禅意」，生成大留白、衬线引用的排版。
- 用户不满足现成主题，用一句话描述（如「黑白杂志、克莱因蓝点睛、衬线字体」）让 AI 生成一套全新主题并复用。
- 内刊或深度评测团队，用「橄榄手记」主题排出编辑部质感的编者按和暗色摘要框。
这个 Agent 有哪些优点和局限？
- 双关卡校验脚本（component_lint.py + validate_gzh_html.py）确定性检查平台限制，不依赖模型自觉，保证输出质量。
- 所有样式内联并用 <span leaf> 包裹，专门规避公众号过滤规则，粘贴后样式不丢失。
- 6 套精选主题 + 主题生成器，覆盖绝大多数题材，且可自定义生成新主题。
- 模型无关，不挑模型，国内外模型都能跑出一致效果，排版逻辑全部沉淀在组件库和脚本中。
- 仅针对微信公众号平台，不适用于其他内容平台或网页排版。
- 需要一定的命令行操作（Python 脚本校验），对非技术用户有门槛。
- 主题生成器生成的组件库需要经过 component_lint.py 校验到 0 ERROR 才能使用，否则可能不符合平台规范。
- 项目许可证为 AGPL-3.0，衍生品必须开源，商用或闭源使用受限。
如何安装或部署这个 Agent？
安装方式有三种：
- 一行命令（推荐）：
npx skills add https://github.com/isjiamu/gzh-design-skill - 让 AI 自己装：对任意 Agent 说「请帮我查找并自动安装 https://github.com/isjiamu/gzh-design-skill 这个 skill」，它会自动 clone 到 skills 目录。
- 手动 clone：
git clone https://github.com/isjiamu/gzh-design-skill.git ~/.claude/skills/gzh-design
如何使用这个 Agent？
安装后，对 Agent 说：「用摸鱼绿把这篇文章排成公众号 HTML：article.md」。Agent 会先按题材推荐主题并请你确认，然后读取组件库、解析 Markdown、装配 HTML，运行校验脚本输出预览页。用浏览器打开生成的预览页，点击右上角「复制到公众号」，再粘贴到公众号编辑器即可。若需校验合规性，可单独运行 python3 scripts/validate_gzh_html.py out.html 查看 ERROR 数。