isjiamu/gzh-design-skill

解决的问题

它解决了使用 Markdown 制作微信公众号文章时，难以达到美观且专业排版的问题。它特别针对“样式丢失”问题，确保所有样式皆严格内联并符合平台严格的过滤规则，避免将 HTML 贴入微信编辑器时格式崩溃。

运作原理

本项目作为 AI Agent（如 Claude Code、Cursor 或 Codex）的“技能”运作。Agent 接收 Markdown 文件与选定的主题，解析内容后使用预定义的组件库组装成 HTML 文档。为确保质量，它采用双重验证系统：component_lint.py 检查原始组件库中的反模式，而 validate_gzh_html.py 则在交付前验证最终 HTML 输出是否包含违禁标签或格式错误。

适用对象

习惯使用 Markdown 写作，并希望将长篇文章、教程或报告转换为精美微信公众号贴文，且不想手动排版的创作者、博主与分析师。

特色亮点

• 6 种预建主题：包含适合教程的“摸鱼绿”与适合科技评论的“石墨极简”等多种风格。
• 主题生成器：允许用户通过简单的文字描述或参考图片，建立全新的自定义主题。
• 平台合规性：自动处理微信的特定限制，例如将文字包裹在 <span leaf=""> 中，并禁止使用 <style> 或 <div> 标签。
• 智能排版：自动加入章节编号、关键词下划线，并生成导读卡片与目录。
• 不限 Agent：适用于各种 LLM（Claude、GPT、Gemini、DeepSeek 等），因为排版逻辑嵌入在组件库与脚本中，而非依赖模型的直觉。