前言¶
在公众号后台写长文时,常见做法是先在 Markdown 或富文本工具里排版,再复制进编辑器。微信对 HTML 和 CSS 的限制较多:外链样式表、部分选择器、浮动与定位等往往被过滤或表现异常,复制进去后版式容易「塌掉」。自己对照试错成本高,也不利于在 Agent 里一次性产出可用结果。
下面介绍 SkillHub 上的 wechat-article-adapter(坐标 @user_d0123732/wechat-article-adapter)。它把微信公众号 HTML 排版约束写进 Skill,在用户提出公众号写作或排版需求时,引导模型按规范生成可直接粘贴到公众号编辑器的 HTML,而不是通用网页 markup。
这是什么¶
wechat-article-adapter 是社区来源(community)的内容创作类 Skill,当前版本 1.0.0,由 user_d0123732 发布,分类为 content-creation。SkillHub 标注 requires_api_key=false,安装与使用不依赖额外 API Key。
官方简介概括为两点:遵循微信公众号 HTML 排版规范;输出可粘贴进公众号编辑器的 HTML,并规避微信对 CSS/HTML 的常见限制。触发场景包括用户要求写公众号文章、生成公众号排版、做微信图文排版等。
- SkillHub 页面:https://www.skillhub.cn/skills/user_d0123732/wechat-article-adapter
- API 入口:https://api.skillhub.cn/user_d0123732/wechat-article-adapter
(页面统计以 SkillHub 展示为准:评分 100000,下载 1048,安装 0。)
核心功能¶
结合官方说明,可核实的能力边界如下。
- 排版规范内化:Skill 以
SKILL.md形式承载公众号 HTML 相关约束,供 Agent 在生成内容时参照,而不是输出任意 Web 页面代码。 - 可粘贴的 HTML 产出:目标产物是公众号编辑器可接受的 HTML 片段,减少粘贴后样式被剥离或错乱的情况。
- 意图触发:当对话中出现公众号文章、公众号排版、微信图文排版等需求时,应优先启用该 Skill 的工作流。
未在公开页面单独列出的具体 CSS 白名单、标签限制等细则,以安装后的 Skill 包内文档为准;本文不展开未核对到的条目。
安装与启用¶
SkillHub 提供两种常见方式:让 AI 按安装文档拉取 Skill,或使用 skillhub CLI 安装到当前 Agent 的 skills 目录。
方式一:提示词交给 AI¶
将下面提示发给支持 Skill 的客户端(Cursor、Claude Code、Codex CLI 等),由 Agent 按官方安装说明完成安装:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_d0123732/wechat-article-adapter`。
方式二:skillhub CLI¶
若本机尚未安装 CLI,可先检查版本:
command -v skillhub && skillhub --version
未安装时,可按 SkillHub 安装文档执行完整安装或仅安装 CLI(文档地址:https://skillhub.cn/install/skillhub.md)。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落到 ./skills/,可能不会被识别。
skillhub install @user_d0123732/wechat-article-adapter --dir <skills 目录>
常用路径示例(来自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
安装后按你所用客户端的要求刷新或重启 Agent,使 Skill 被加载。
典型用法¶
官方未提供独立 CLI 子命令;使用方式是在已启用 Skill 的对话中,用自然语言说明排版目标。下列表述与 Skill 简介中的触发场景一致,便于复现:
- 说明体裁与结构,例如:「写一篇公众号技术分享,含小标题、引用块和代码块,请按公众号排版输出 HTML。」
- 明确要求产物格式:「生成微信图文排版用的 HTML,我直接粘贴到公众号后台。」
- 若已有 Markdown 草稿:「把下面 Markdown 转成符合微信公众号限制的 HTML。」(将正文贴在对话中。)
经过上面的步骤,Agent 应在 Skill 约束下返回 HTML。你可在公众号编辑器「源代码」或对应入口中粘贴,并在手机预览中核对段落间距、标题层级与代码块显示是否符合预期。
适用场景与注意¶
适合谁
- 经常用 Cursor、Claude Code 等写公众号长文,希望少手工改 HTML 的创作者或技术作者。
- 需要在对话里一次性得到「接近成稿」的排版代码,而不是事后在编辑器里反复试 CSS 的团队。
限制与注意
- 产物仍受微信编辑器实时策略影响;重大后台规则变更时,可能需要更新 Skill 版本或人工微调。
- 该 Skill 解决的是 HTML 排版适配,不负责配图上传、封面、原创声明等运营侧流程。
- 社区 Skill,维护节奏以发布者 SkillHub 更新为准;升级可用
skillhub按同一坐标 reinstall 或按客户端文档更新。
结尾¶
wechat-article-adapter 把公众号 HTML 限制收敛进 Agent Skill,在「写公众号文章 / 公众号排版 / 微信图文排版」等场景下,生成更易粘贴、更少踩 CSS 坑的 HTML。若你正在 SkillHub 选型内容创作类能力,可从官方页查看版本与说明:
https://www.skillhub.cn/skills/user_d0123732/wechat-article-adapter