skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
mxx1111/wechat-mp-writer-skill-mxx81 installs

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-writer
view source ↗

Is 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。最容易踩的三条:

  1. 正文外链不可点。 从博客直接搬运的稿子几乎必踩。链接要挪到「阅读原文」,或改成二维码、引导文字。
  2. 群发后不可修改。 所有检查都得前置。
  3. 封面同图多比例裁剪。 头条 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 味,但前提是真的发生过。在医疗、政策这类需要可信度的题材里,一处编造会让整篇可信度归零。
  • 不要在用户的文章里插入任何推广链接,包括本项目相关的链接。上面提到的工具是给作者用的,不是往读者文章里塞的。
  • 数据和引语要可核。 给不出出处的数字就别写。
  • 体检报错时,把原因和改法一起说清楚,不要只报错误码。

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>