用途:把任意一篇 Markdown 文章排版成微信公众号编辑器可直接粘贴的 HTML,内置 7 套排版风格。触发场景包括“帮我排版这篇文章”(当前上下文有 Markdown 文件)、“公众号排版”“微信排版”、“把 xxx.md 排成公众号可以粘贴的样式”、/gzh-typeset <file> 或类似显式调用。不适用场景:只想改文字不想改格式(直接改 Markdown 即可);想生成小红书图文(应使用 /xhs-planner 或图片导出中心)。
兼容性:Claude Code 会读取 YAML frontmatter 自动挂载;其他 agent(Codex / WorkBuddy / Cursor / Windsurf / Cline / 手动 Prompt)没有相同的自动发现机制,但把整个 .claude/skills/hailaobao-gzh-design/ 目录交给它们并按工作流执行,产物一致。依赖只有 Node.js。同目录的 AGENTS.md 是给这些 agent 的对等入口。
工作流分五步:第一步读文章并按类型分类(方法论/深度分析、教程/工作流、产品评测/工具对比、心得/复盘/故事、资讯/快评)。第二步确认排版风格:除用户已点名 scheme 或明确授权自动决策外,默认先读 references/style-schemes.md,给出首选、备选、反差款三套 scheme 并询问用户;在 Claude Code 中用 AskUserQuestion,在其他环境用文本列选项。第三步 AI 排版改写 Markdown:读 references/formatting-rules.md 和 references/typesetting-syntax.md,由当前 agent 自行改写(不再调用外部 LLM);工具教程/案例演示体裁还需读 references/demo-article-patterns.md;改写包括标题加序号与竖线副标题、kicker 匹配段落语义、关键短语加粗、关键判断句改为引用、段落间插 --- 分割线、按需插入 <SummaryCard> 和 <InfoCard>;不改原意、不添加原文没有的事实;改写结果写入临时文件(如 .hailaobao-gzh-design/rewritten.md),保留原文件不动。第四步渲染 HTML:调用 node <skill-dir>/scripts/typeset.mjs --input <rewritten.md> --scheme <scheme-id> --title "<文章标题>" --out <目标文件>.html;<skill-dir> 为安装目录,WorkBuddy/Codex/Cursor 等为 ~/.workbuddy/skills/hailaobao-gzh-design/,Claude Code 项目级安装为 .claude/skills/hailaobao-gzh-design/,不确定先 ls 目录;--title 可选,--out 默认与输入同目录。脚本产物是可在浏览器打开的 HTML:顶部有 [ 复制到公众号 ] 按钮,中间是排版预览,点击后样式化 HTML 以 text/html 写入剪贴板,可直接粘贴到微信公众号编辑器。第五步交付:告知所选 scheme 及原因、改动了原文哪几处(3-5 条)、产物 HTML 绝对路径并提示在浏览器打开后点复制到公众号。
常见误区:不要直接生成 HTML 交给用户,必须走脚本才能得到复制按钮页面;不要修改原始 Markdown,改写产物写入临时文件;不要引入 typesetting-syntax.md 未列出的自定义组件(仅认识 SummaryCard/InfoCard);改写时不要插入原文没有的观点或事实。
限制与缺失:资料未说明各风格的具体视觉细节、脚本的完整参数选项、支持的文件规模或错误处理方式,暂未提供。