wechat-mp-writer
微信公众号发布流水线与排版模版库。提供可直接套用的政策解读、长期照护和技术长文模版,把 Markdown 编译成带内联样式、可直接粘进公众号编辑器的 HTML;并负责平台特有的硬约束——标题与摘要长度、正文外链不可点、代码块超宽、封面裁剪、发布后不可修改——用 check_mp.py 做发布前体检。写作和润色委托给专门的 skill,不重复造。当用户要排版公众号文章、要模版、要写公众号、要把已有稿子转成公众号能发的形态、要做发布前检查,或问公众号平台限制时使用。
How do I install this agent skill?
npx skills add https://github.com/mxx1111/wechat-mp-writer-skill-mxx --skill wechat-mp-writerIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a WeChat Official Account writing pipeline that converts Markdown to HTML and performs safety checks against platform limits. It uses only Python standard libraries, implements proper sanitization for user-provided content, and includes a comprehensive test suite. No malicious behavior or data exfiltration was detected.
- Socketwarn
1 alert: gptAnomaly
- Snykpass
Risk: LOW · No issues
- Runlayerpass
5 files scanned · No issues
What does this agent skill do?
公众号发布流水线
这个 skill 负责什么,不负责什么
负责:流程编排,以及公众号这个平台特有的工程细节。
不负责:怎么把文章写好、怎么去 AI 味。这两件事有更专门的方案,在这里重造一遍只会更弱。
| 环节 | 谁来做 |
|---|---|
| 写作、改稿 | human-writing(通用中文创作) |
| 去 AI 味 | humanizer-zh(中文)、humanizer(英文) |
| 自媒体风格化润色 | polish-zimeiti |
| 个人文风 | 作者自己的文风 skill(如有) |
| 流程编排、平台约束、发布前体检 | 本 skill |
装了哪些是用户自己的事。上面这些没装也能用,本 skill 的核心价值在平台层,不在文笔层。
流水线
素材 ──▶ 选题 ──▶ 起草 ──▶ 润色(委托)──▶ 配图 ──▶ 体检 ──▶ 排版 ──▶ 发布
│ │
│ file2md 可把 PDF/Word/Excel │ check_mp.py
│ 转成 Markdown 当输入 │ 机器能查的全在这
四种入口,按用户说什么进对应的那条:
| 用户想做 | 走哪几步 |
|---|---|
| 从零写一篇 | 全流程 |
| 已有草稿要发 | 润色 → 配图 → 体检 → 排版 |
| 只想体检 | 直接跑 python3 scripts/wechat_mp.py check |
| 只问平台规则 | 读 references/wechat-platform.md 回答 |
不要默认跑全流程。 用户说「帮我检查一下这篇」就只做体检,别顺手把文章重写了。
关键一步:发布前体检
这是本 skill 唯一自己实现的能力,也是别处没有的。
python3 scripts/wechat_mp.py check article.md --title "标题" --digest "摘要"
标题和摘要也可以写在 Markdown 顶部的 front matter 里:
---
title: 标题写在这
digest: 摘要写在这
---
它查这些:
| 检查 | 为什么重要 | 处理级别 |
|---|---|---|
| 标题长度 | 超长在列表页和分享卡片被截断 | 已核实上限报错;缺失或观感问题提示 |
| 摘要长度 | 超长被截断;留空则微信自动截正文开头,通常很难看 | 已核实上限报错;缺失提示 |
| 正文外部链接 | 公众号正文的链接不可点击,读者只能手抄。这是最常见的翻车点 | 报错 |
| 正文 H1 | 标题在后台单独填,正文再出现 H1 会重复 | 报错 |
| 代码块行宽 | 超宽只能横向滚动,手机上没法读 | 经验值,仅提示 |
| 图片数量、alt、单图大小 | 纯文字长文完读率低;本地图片过大影响素材上传 | 仅提示 |
| 超长段落 | 手机一屏放不下 | 经验值,仅提示 |
有 error 退出码为 1,只有 warning 为 0,可以直接进 CI。
具体数值不写死在代码里,集中在 references/platform-limits.json,每项带 lastVerified 和 source。微信的限制会变,改配置就行,不用改代码;拿不准的项目 enforce 设为 false,只提示不报错。
enforce=true 只用于已有可信依据、适合阻断发布的规则;代码行宽、段落长度和图片大小这类受设备、编辑器或账号能力影响的经验值必须保持为提示,不能卡住发布流水线。
体检要在发布之前做。 公众号群发后不能修改,只能删除重发,重发会丢掉已有的阅读量和在看。
体检与排版一起做时用 build。它只会在没有 error 时写 HTML,warning 不阻断:
python3 scripts/wechat_mp.py build article.md -t policy-whitepaper -o out.html
平台约束
完整内容见 references/wechat-platform.md。最容易踩的三条:
- 正文外链不可点。 从博客直接搬运的稿子几乎必踩。链接要挪到「阅读原文」,或改成二维码、引导文字。
- 群发后不可修改。 所有检查都得前置。
- 封面同图多比例裁剪。 头条 2.35:1、次条 1:1,分享到朋友圈和聊天窗口又各是一套。主体居中,重要文字别贴边。
原创声明和留言功能的规则调整过多次,且和账号注册时间、认证状态强相关——不要凭记忆操作,以后台当前显示为准。
配图
见 references/image-guide.md:尺寸规范、按文章类型的配图选择、免费素材源、AI 配图提示词模板。
配图的判断标准只有一条:这张图有没有传递文字没传递的信息。凑数的配图会拉低完读率,不是加分项。
润色
见 references/humanize-guide.md。
那份文档主要是一张反面清单——网络流行语、「(笑)」这类括号补充、刻意重复、密集的「说实话/讲真」,这些早期的去 AI 味技巧现在已经被模型学得太熟,成了新一代的 AI 味,用了反而更容易被认出来。
真正有效的只有一件事:文章里有别人给不出的具体信息。没有的话,改多少句式都没用;材料不够就去查、去问,或者把文章写短。
排版:套模版
Markdown 不能直接粘进公众号编辑器。公众号会剥掉 <style> 标签和所有 class,只认元素上的内联 style,所以样式必须在生成时编译进每一个标签。
python3 scripts/wechat_mp.py validate-template
python3 scripts/wechat_mp.py render article.md -t policy-whitepaper -o out.html
浏览器打开 out.html,全选复制,粘进公众号编辑器。
| 模版 | 适合 |
|---|---|
policy-whitepaper | 政策解读、调研报告、医保社保、机关单位汇报 |
long-term-care-policy | 长期护理保险、养老服务、医保政策、照护项目复盘 |
tech-deepdive | 技术教程、源码分析、架构设计、踩坑记录 |
按文章题材推荐模版,别问用户"你想要什么风格"——他多半也不知道,直接给建议再让他换。加模版的方法见 templates/README.md。
加 --standalone 会套一层模拟公众号宽度的预览卡片,仅用于浏览器查看,不要复制它。
浏览器预览和公众号里的实际效果有差异(字体回退、深色模式处理)。要提醒用户在后台真的粘一次,用手机看一遍。
模版或本地环境异常时先运行:
python3 scripts/wechat_mp.py validate-template
python3 scripts/wechat_mp.py doctor
发布
- 素材转换:file2md —— PDF / Word / Excel 转 Markdown,纯前端本地处理,文件不上传
- 另一种排版路径:mdlook —— Mac 本地的 Markdown 排版与公众号复制工具,主题更多
- 发布:如果用户装了公众号发布类 skill(如
wechat-mp-publisher、wewe-rss-publish),把体检通过的 Markdown 交给它;没装就给手动发布步骤
使用时的注意
- 不要编造个人经历。 具体细节能去 AI 味,但前提是真的发生过。在医疗、政策这类需要可信度的题材里,一处编造会让整篇可信度归零。
- 不要在用户的文章里插入任何推广链接,包括本项目相关的链接。上面提到的工具是给作者用的,不是往读者文章里塞的。
- 数据和引语要可核。 给不出出处的数字就别写。
- 体检报错时,把原因和改法一起说清楚,不要只报错误码。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/mxx1111/wechat-mp-writer-skill-mxx/wechat-mp-writer">View wechat-mp-writer on skillZs</a>