| name | publish-to-wechat |
| description | Use this skill when the user wants to publish Markdown content to WeChat Official Account (微信公众号). Automates the entire pipeline: content adaptation, AI image generation, format conversion, and browser-assisted publishing. |
微信公众号发布技能
Overview
本技能实现从 Markdown 源文件到微信公众号发布的端到端自动化流水线。AI 收到指令后，自动完成草稿改写、配图生成、格式转换等全部步骤。
触发方式
当用户发出以下任一指令时，自动触发完整发布流程：
"把 [文件路径] 发到公众号""发布 [文件路径] 到微信公众号"- 同时引用一个 Markdown 文件 + 本 SKILL.md
AI 收到触发后，按以下 Pipeline 自动执行所有步骤。
自动化 Pipeline
源文件 → Step 1: 草稿生成 → Step 2: 配图生成 → Step 3: 格式转换 → Step 4: 发布准备
Step 1: 草稿生成
输出规范
| 项目 | 规范 |
|---|
| 草稿路径 | docs/weichat/[slug]/Draft.md |
| 图片目录 | docs/weichat/[slug]/images/ |
| slug 命名 | 英文短横线格式，基于文章主题，如 ash-introduction、openclaw-memory |
内容改写指引
从源文档转换为公众号风格时，遵循以下规则：
必须处理：
- 移除不兼容元素：GitHub 徽章（badge）、相对路径图片、CI/CD 链接
- 调整标题层级：正文从
### 开始（h3），因为公众号的文章标题占用了 h1
- 替换外链图片：将外链图片替换为本地生成的配图，或使用已上传到图床的 URL
- 精简代码块：只保留最核心的 2-3 个代码示例，移动端长代码体验差
风格调整：
- 语气转换：从技术文档风 → 技术博客风（更口语化，可加入"我们"等第一人称）
- 篇幅控制：1500-3000 字（移动端最佳阅读长度，约 5-10 分钟）
- 结构优化：采用"痛点引入 → 方案解析 → 核心亮点 → 快速上手"的结构
- 添加 Emoji：章节标题适当添加 emoji 增加阅读趣味
- 强化金句：每个章节末尾用 加粗 总结一句核心观点
标题 & 摘要自动生成
在 Draft.md 顶部生成以下内容：
---
标题备选：
1. [直接型标题]
2. [痛点型标题]
3. [吸引型标题]
摘要: [120字以内的文章摘要，用于公众号分享时显示]
---
标题风格参考：
| 风格 | 示例 |
|---|
| 直接型 | ASH — AI IDE 界的"Homebrew" |
| 痛点型 | 还在为每个IDE重复配置AI技能？一键搞定！ |
| 吸引型 | 装一次技能，8个AI IDE同步，这个工具太香了 |
⚠️ 公众号标题限制 64 字符，务必精简。
Step 2: 配图生成
使用 generate_image 工具根据文章内容自动生成封面图和正文配图。
封面图
| 类型 | 尺寸 | 比例 | 说明 |
|---|
| 首图封面 | 900 × 383 | 2.35:1 | 必须，显示在消息列表和文章顶部 |
| 次图封面 | 200 × 200 | 1:1 | 可选，多图文时使用 |
Prompt 模板：
A modern tech blog cover image for a WeChat article about [文章主题].
Design: [根据内容选择视觉元素].
Color palette: [选择与主题匹配的配色].
Style: clean, minimalist, professional. No text.
Aspect ratio 2.35:1, wide format.
保存路径：[slug]/images/cover.png
配色风格参考：
| 文章类型 | 推荐配色 | 视觉元素 |
|---|
| AI / 深度学习 | 深蓝 + 青蓝渐变 | 神经网络、大脑、电路 |
| 架构设计 | 深灰 + 橙色点缀 | 模块、连接线、流程图 |
| 工具推荐 | 紫色渐变 + 白色 | 工具图标、齿轮、拼图 |
| 教程入门 | 浅蓝 + 绿色 | 书本、阶梯、灯泡 |
| 经验总结 | 暖橙 + 深色底 | 山峰、路径、里程碑 |
正文配图
插图策略：
- 每 800-1200 字插入一张，避免大段纯文字
- 优先在以下位置插入：
- 每个大章节（h2/h3）标题后
- 核心概念的解释段落旁
- 流程/架构描述处
- 文末总结前
- 一篇 2000 字文章建议 2-4 张配图
Prompt 模板：
A [风格] illustration for a tech article section about [本节主题].
Visual elements: [与内容相关的具象元素].
Color palette: consistent with [封面配色方案].
Style: flat design / isometric / minimalist. No text.
Square format.
⚠️ 正文配图的配色风格应与封面图保持一致，形成统一的视觉语言。
保存路径：[slug]/images/section-[序号]-[简述].png
图片插入
在 Draft.md 对应位置先用本地路径插入：
图片上传到 OSS 图床
生成配图后，自动上传到阿里云 OSS，并将 Draft.md 中的本地路径替换为图床 URL。
前置条件： 需要设置以下环境变量（参见附录「环境变量配置」）：
| 环境变量 | 说明 | 示例 |
|---|
OSS_BUCKET | OSS Bucket 名 | my-picture-bed |
OSS_ENDPOINT | OSS 节点地址 | oss-cn-shanghai.aliyuncs.com |
OSS_ACCESS_KEY_ID | 阿里云 AccessKey ID | - |
OSS_ACCESS_KEY_SECRET | 阿里云 AccessKey Secret | - |
上传命令：
ossutil cp docs/weichat/[slug]/images/[filename].png \
oss://$OSS_BUCKET/tech/wechat/[slug]/[filename].png \
-e $OSS_ENDPOINT \
-i $OSS_ACCESS_KEY_ID \
-k $OSS_ACCESS_KEY_SECRET
上传后替换 Draft.md 中的路径：
# 本地路径 → OSS URL
images/cover.png
→ https://$OSS_BUCKET.$OSS_ENDPOINT/tech/wechat/[slug]/cover.png
images/section-01-xxx.png
→ https://$OSS_BUCKET.$OSS_ENDPOINT/tech/wechat/[slug]/section-01-xxx.png
⚠️ 上传前确认 4 个环境变量均已设置，可通过 echo $OSS_BUCKET 验证。
Step 3: 格式转换与发布
AI 自动执行
-
复制草稿到剪贴板
cat docs/weichat/[slug]/Draft.md | pbcopy
-
打开 Doocs/md 编辑器
open https://md.doocs.org/
💡 AI 执行到这里即结束，后续由用户手动操作。
用户手动操作
- 在 Doocs/md 左侧编辑区 Cmd+A 全选 → 删除 → Cmd+V 粘贴草稿
- 右侧实时预览确认排版效果
- 点击右上角 「复制」 按钮（复制为富文本）
- 打开 公众号后台 → 内容与互动 → 图文消息 → 写新图文
- 在正文区域 Cmd+V 粘贴
- 从 Draft.md 顶部的 3 个备选标题中选一个填入标题栏
- 上传封面图（
images/cover.png）
- 上传正文配图到素材库（如未使用图床）
- 预览移动端效果 → 发布
其他编辑器（备选）
图片上传策略
公众号不支持外链图片，需选择以下任一方案：
| 方案 | 操作 | 适用场景 |
|---|
| 公众号素材库 | 在后台手动上传 images/ 内的图片 | 默认推荐 |
| 图床 | 使用阿里云 OSS 等图床，在 Draft 中直接使用图床 URL | 有图床账号时 |
发布 Checklist
AI 自动完成 ✅：
用户手动完成 📋：
附录
CLI 工具方案（备选）
npm install -g md2wechat
npx md2wechat convert your-article.md > output.html
⚠️ md2wechat 输出可能包含调试信息，需要手动清理。
API 自动发布方案（高级）
适用于已认证的公众号（可获取 AppID 和 AppSecret）：
ash install jimliu/baoyu-skills
在 ~/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md 中配置：
wechat_app_id: your_app_id
wechat_app_secret: your_app_secret
⚠️ 未认证的订阅号无法使用 API 接口，只能使用浏览器方式或手动粘贴。
常见问题
Q: 粘贴后显示 HTML 代码？
A: 使用 Doocs/md 的「复制」功能复制富文本格式，不要复制 HTML 源码。
Q: 图片无法显示？
A: 公众号不支持外链图片，需上传到素材库或使用图床。
Q: 未认证订阅号能用 API 发布吗？
A: 不能，只能手动粘贴发布。
相关链接
