公众号排版发布
安装方法
-
先问使用者用的是什么 AI 工具(如 Claude Code、Codex、Cursor),回答记作 X
-
只安装给 X,不安装或链接其他任何工具:
npx -y --registry=https://registry.npmmirror.com skills add https://modelscope.cn/skills/sunny31221/wechat-layout-publish -a X -y(
--registry为 npmmirror 镜像,保证国内不翻墙也能装;-a X表示只装给 X 这一个工具) X 不在上述命令支持范围时,按该工具自身的技能机制安装,装完确认 X 能识别本技能即可 -
装完后询问是否现在使用本技能
Overview
编排两个子技能完成「排版 → 发布」流水线:gzh-layout 负责把 Markdown 成稿套用排版模板转成微信兼容 HTML,wechat-publisher 负责把 HTML 发布到公众号草稿箱。
核心原则:排版自动、发布直接、绝不群发。排版产物自检通过后直接发布草稿箱,不停下等用户确认;用户想看排版产物时会明确要求,此时才停下等确认。
When to Use
- 用户提供成稿路径,要求「排版并发布」
- 用户说「排版发布」「排版+发布」「帮我发文章」「推送到草稿箱」
- 成稿已经过风格检查(article-style-checker)确认可发布
When NOT to Use
- 只排版不发布 → 直接用
gzh-layout - 只发布不排版(已有 HTML)→ 直接用
wechat-publisher - 文章未定稿 / 未过风格检查 → 先完成写作流程,不进入本技能
- 用户要求「直接群发」→ 拒绝:本技能只发草稿箱,群发永远是用户在公众号后台手动操作
子技能(均为已安装技能,按技能名调用)
| 组件 | 技能 |
|------|------|
| 排版技能 | gzh-layout(Markdown 成稿 → 微信兼容 HTML,自带通用商务风模板,可换成自己的模板) |
| 发布技能 | wechat-publisher(HTML → 公众号草稿箱,密钥配置见 .env.local) |
工作流(安全闸门,不可跳闸)
第 1 步:确认输入
- 确认成稿/定稿路径存在且为 Markdown(如
05_作品仓库/<NNN-选题名>/01_母稿/03_版本/定稿vN.md;无定稿时用成稿vN.md) - 确认该成稿已通过风格检查(无 P0-P2 残留);未检查的先停下提醒用户
- 模板默认用 gzh-layout 自带的通用商务风模板,用户指定其他模板则用指定路径
第 2 步:排版(调用 gzh-layout)
- 调用
gzh-layout技能(读其 SKILL.md 按流程执行:模板管视觉、文章管内容,脚本自动做 CSS 内联化等微信兼容处理) - 传入:成稿路径 + 模板路径
- 排版产物输出到与成稿同目录的工作文件夹
第 3 步:检查排版产物(闸 1——产物不合格不进发布)
逐项检查,任何一项不过即返回第 2 步修复:
- [ ] 排版 HTML 文件存在且非空
- [ ] 无「待替换」「TODO」「示例文字」等未替换占位符
- [ ] 模板品牌素材在位(顶部关注引导、底部品牌区文案来自模板的
待替换素材.md) - [ ] 无
<style>标签残留(微信兼容要求纯内联样式) - [ ] 图片引用完整(base64 已嵌入或路径有效)
- 检查不通过 → 修复后重新检查,不带着问题进发布
第 4 步:直接进入发布
- 闸 1 自检通过即进入第 5 步发布,不停下等用户
- 例外:用户明确要求「先预览 / 排版完给我看 / 先别发」时,展示排版产物路径并停下,用户确认后再发布;用户要求修改 → 返回第 2 步重排
第 5 步:发布到草稿箱(调用 wechat-publisher,闸 2——先验证再发布)
- 调用
wechat-publisher技能(读其 SKILL.md 按流程执行) - 先
--dry-run验证(不实际发送),确认无报错 - 再正式发布到草稿箱(草稿箱可删除、可撤回,非群发)
- 全程不触发「群发/发布到线上」类操作——本技能只到草稿箱为止
第 6 步:报告
- 发布结果:草稿箱标题、发布到的公众号、时间
- 提示用户:草稿箱里的文章需要用户到公众号后台手动群发
红线(硬性)
- 绝不自动群发:本技能的输出终点是草稿箱;群发是用户在公众号后台的人工动作
- 产物不合格不进发布:第 3 步检查不过,禁止进入发布环节
- 正式发布前先 dry-run:第 5 步先验证再正式发布,验证报错不得直接发布
- 用户要求先预览时必须等确认:用户明确说「先预览 / 先别发」时,未获用户确认不得发布(用户 2026-09-06 定:默认直接发布,不再强制人工确认)
- 不越级调用:不绕开子技能直接调 API;子技能路径以本文件「子技能与资源路径」为准
Common Mistakes
| 错误 | 修复 | |------|------| | 用户要求先预览时仍直接发布 | 用户明确说「先预览 / 先别发」时停下等确认(2026-09-06 起默认直接发布,无需确认) | | 排版产物有占位符就发布 | 第 3 步逐项检查,不过就重排 | | 把「发布到草稿箱」说成「已发布」 | 草稿箱 ≠ 群发,报告时必须区分 | | 子技能调用写死本机路径 | 子技能按技能名调用(gzh-layout、wechat-publisher),不写死路径 | | 群发指令直接照做 | 拒绝群发,说明本技能只发草稿箱 |
Resources
- 排版技能:
gzh-layout(自带模板与排版脚本) - 发布技能:
wechat-publisher(含接口参考与发布脚本)
微信扫一扫