公众号排版技能 gzh-design
把 Markdown（或 Word/PDF/纯文本）一键排成可直接粘贴进微信公众号编辑器、样式不丢失的 HTML，内置 6 套主题与主题生成器。
SKILL.md 仅在本地读写文件并调用两个本地 Python 脚本，无网络请求、无凭据访问、无删除性操作；签名区用 {{作者名}} 占位而非写死作者，数据流清晰。扣分点：脚本源码未在提供的文件中出现，无法静态核实其行为；用户确认环节（选主题）虽有，但对文件写入/覆盖无显式回滚说明。
工作流自洽、分层清晰（theme-index 单一来源、组件库不混用、强制校验脚本兜底），异常路径有处理（theme-index 为空即停止并告知）。扣分点：两个校验脚本本身未提供，静态无法核实可运行性与报错质量；无 CI 或已提交测试的直接证据（仅在 README/CONTRIBUTING 中描述）。
触发场景在 frontmatter 中枚举明确（'公众号排版'、'一键排版'、'生成新主题'等），不适合范围明确排除（不做网页/PPT/代写文章），中文场景原生支持，核心功能完全本地化、无海外服务依赖。扣分点：触发与 eval-cases.md 引用的回归用例未在提供文件中，边界条件（如超长文章、特殊 Markdown）覆盖证据有限。
文档分层好（SKILL.md 流程 + references 组件库 + scripts 校验 + CONTRIBUTING 贡献规范 + eval-cases），许可证 AGPL-3.0 且 LICENSE 全文存在，作者署名明确。扣分点：license 元数据为 NOASSERTION，无版本号/CHANGELOG，维护更新路径依赖口头说明，部分外部图片链接（picgo.net）可达性存疑。
产出（纯 section 片段 + 预览复制页）设计针对公众号粘贴痛点，价值主张明确，相比手动排版有明显边际价值。扣分点：静态审查无法核实生成结果可直接粘贴且样式不丢，展示截图为作者自供证据，代表性产出未经独立复现。
存在可审计的一手材料（组件库规范、双关卡脚本约定、eval-cases、样例文章），结构支持复现。扣分点：脚本与 eval-cases 文件本体未在提供材料中出现，第三方执行证据（CI + 测试）缺失，多数效果声明依赖作者描述。
- 静态审查未执行任何脚本：validate_gzh_html.py 与 component_lint.py 的实际行为和报错质量未经核实，使用前建议自行运行确认。
- 许可证元数据为 NOASSERTION，虽然 LICENSE 文件声明 AGPL-3.0，集成方应自行确认合规义务（含网络服务开源条款）。
- 项目无版本号与 CHANGELOG，更新追踪依赖 git 历史；仓库部分外部图片依赖第三方图床（picgo.net），长期可用性存疑。
- 发布者未经 FollowSkills 企业注册库验证，身份视为未知，但这本身不构成扣分或安全嫌疑。
这个 Skill 能做什么，适合哪些场景？
gzh-design-skill 是一个面向 AI Agent 的公众号文章排版 Skill，核心入口是 SKILL.md 定义的工作流。它读取主题组件库（references/theme-index.md 为单一来源），把 Markdown 解析成章节、引言、代码块、图片等元素，再用所选主题的真实 HTML 组件装配成正文片段。生成的 HTML 全部内联样式、文字用 <span leaf> 包裹，规避公众号编辑器会过滤的写法，并通过 validate_gzh_html.py 等脚本确定性校验平台红线与全角标点。除 6 套内置主题外，还支持按一句话描述或参考图生成全新主题组件库并保存复用。
接受 Markdown、.docx、.pdf 或纯文本输入（非 Markdown 先按 format-normalize.md 归一化，docx 用 extract_docx.py 提取）；读取所选主题的组件库文件和通用增量库（代码块/图片·GIF/小标签）；解析文章结构并判定文章类型，按该主题的'配方表'选定组件组合；自动完成章节编号（末章可用 ∞ 变体）、每段 1–3 个关键词下划线、引言卡、目录（精选 3 条）、英文标签、作者签名去重与全角标点；产出纯 <section> 正文片段 HTML 文件，再用 wrap_preview.py 生成带'复制到公众号'按钮的预览页；交付前必须跑 validate_gzh_html.py，ERROR 清零、半角标点 WARNING 清零才算完成。
- 公众号作者写完 Markdown 教程或工具盘点，希望按'摸鱼绿'等主题一键排成可粘贴的公众号 HTML
- 写深度观点长文的编辑，想用红白色系或石墨极简风排版，并自动获得关键词下划线与金句引用卡
- 手头是 Word 或 PDF 稿件，需要先归一化成 Markdown 再排进公众号
- 对内置 6 套主题都不满意的内容创作者，想按一句风格描述或一张参考图现造一套专属组件库
- 禅意/极简类随笔作者，希望用留白禅意风做呼吸感强的大留白排版
- 维护多篇同类型文章的团队，希望同类文章排版气质稳定（靠配方表而非模型自由发挥）
这个 Skill 有哪些优点和局限？
- 样式全内联 + <span leaf> 包裹 + 脚本确定性校验，粘贴到公众号编辑器不掉格式，有明确的质量兜底机制
- 6 套打磨完整的主题组件库，覆盖教程、观点、评测、随笔等常见题材，且每套附文章类型配方表保证风格稳定
- 支持 Word/PDF/纯文本输入归一化，以及'一键自动排版'全自动模式
- 主题生成器可按描述或参考图现造新主题，生成后与内置主题同权使用
- 排版逻辑沉淀在组件库和脚本里，README 称对模型不挑（Claude/GPT/Gemini 及国产模型均可），换模型不走样
- 只排版不写作——必须先有自己的 Markdown 稿，也不能用于普通网页、落地页、PPT 或非公众号平台
- 生成的 HTML 受公众号平台限制约束（禁 style/script/div/class/grid 等），产物不适用于其他渠道
- GitHub 仓库 License 字段为 NOASSERTION，实际协议需以仓库 LICENSE 文件（README 标注 AGPL-3.0）为准
- 半角标点是文档自述的最高频返工点，需要按流程修复到 0 才交付；未提供独立的自动化测试套件证据（有 eval-cases.md 回归用例文档）
- 实际效果依赖所用 Agent 能正确执行多步工作流；除 README 内置效果图外，没有第三方评测数据
如何安装这个 Skill？
方式一（推荐）：npx skills add https://github.com/isjiamu/gzh-design-skill。方式二：对任意 Agent（Claude Code / Codex / Cursor 等）说'请帮我查找并自动安装 https://github.com/isjiamu/gzh-design-skill 这个 skill'。方式三：git clone https://github.com/isjiamu/gzh-design-skill.git ~/.claude/skills/gzh-design。校验脚本需要本机装有 Python 3。
如何使用这个 Skill？
装好后直接对 Agent 提需求即可，例如：'用摸鱼绿把这篇文章排成公众号 HTML：article.md'。触发词包括'公众号排版''微信排版''gzh'等；说'直接排 / 一键排版'可跳过提问走全自动模式；说'按这张图生成一套公众号主题'可触发主题生成器。产物是干净正文 HTML 和带复制按钮的预览页——浏览器打开预览页、点右上角'复制到公众号'、再到编辑器粘贴。