Wechat Publisher Skill for Claude
微信公众号文章的发布管道——封面生成、本地图片上传素材库、创建草稿、发布草稿、以及从 mp.weixin URL 提取原文。**触发场景**:用户说 "发到公众号草稿箱" / "推送到公众号" / "做张公众号封面" / "上传图片到微信" / "把这篇文章提取成 markdown" / "改写这篇 mp.weixin 链接(的提取部分)" / 任何提到「发布 / 草稿 / 封面 / 推送 / 提取微信文章」的请求。本 skill **不写文章**(交给 wechat-writer),**不做 markdown → html 排版**(交给 wechat-formatter)——它只处理图片生成、文件上传、微信 API 调用。
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/YiShu5/claude-skills --skill wechat-publisherWhat comes with it
84 739 bytes besides the instructionThe instruction itself
6 sections, as written by the authorwechat-publisher · 微信公众号发布管道
只负责跟微信 API 打交道的部分:封面生成 / 图片上传 / 草稿创建 / 草稿发布 / 文章提取。
常用工作流
工作流 1:发已写好排版好的稿子(最常见)
前提:你已经用 wechat-writer 写好 markdown,用 wechat-formatter 转成了 html。
# 0. 加载凭证
source <(grep -E '^WECHAT_' .env | sed 's/^/export /')
# 1. 生成封面图(五要素 prompt 见 references/image-prompts.md)
python3 scripts/generate_cover.py \
--prompt "<五要素 prompt>" \
--output cover.jpg
# 2. 上传封面到微信永久素材
python3 scripts/upload_material.py \
--app_id "$WECHAT_APP_ID" --app_secret "$WECHAT_APP_SECRET" \
--image_path cover.jpg
# 输出: thumb_media_id=THUMB_XXX
# 3. 创建草稿
python3 scripts/create_draft.py \
--title "文章标题" \
--content "$(cat drafts/article.html)" \
--thumb_media_id "THUMB_XXX" \
--author "意疏"
# 4. (可选)直接发布
python3 scripts/publish_draft.py \
--app_id "$WECHAT_APP_ID" --app_secret "$WECHAT_APP_SECRET" \
--media_id "MEDIA_XXX"
默认到 step 3 就停——保留为草稿,让用户登录公众号后台预览再决定是否发布。只有用户明确说"直接发"才执行 step 4。
工作流 2:从 mp.weixin URL 提取原文
python3 scripts/extract_to_markdown.py \
"https://mp.weixin.qq.com/s/xxx" \
-o drafts/extracted.md
输出为 Markdown,交给 wechat-writer 改写——本 skill 不负责改写,只负责提取。
工作流 3:一键 orchestrator(已有 markdown,跑完整管道)
python3 scripts/publish_article.py \
--input article.md \
--title "文章标题" \
--author "意疏"
这个脚本会内部调用排版 + 封面 + 上传 + 草稿。适合用户明确说"一条命令直接给我发草稿箱"时用。
如果用户对中间产物(封面 / 配图 / 排版)有要求,不要走 orchestrator,改用工作流 1 分步执行。
封面图 prompt 必须用五要素结构
禁止写「科技风格插画」「为文章 XX 生成封面」这种空泛 prompt。详见 references/image-prompts.md。
五要素(中文逗号分隔,顺序固定):
- 核心意象:文章前 200 字提取 2-4 个具象名词(不要"效率""创新"这种抽象概念)
- 情绪基调:从 7 选 1——温暖治愈 / 专业冷静 / 紧张焦虑 / 轻松愉悦 / 怀旧沉思 / 励志昂扬 / 神秘高级
- 画面风格:按文章主题查
references/image-prompts.md的 9 种风格映射表 - 构图与镜头(固定文本):
2.35:1 横向构图,主体居中偏左,右上角嵌入小字「意疏的AI口袋」,中部区域小字「<标题关键词 3-5 字>」(避开底部 15% 遮挡区) - 负面提示(固定文本):
画面主体不要出现任何文字、字母、汉字,水印、logo、签名
文中配图(发布模式才出,预览模式跳过)
如果用户明确要"发布模式 + 配图",生成 3 张配图,按故事弧线:
| 序号 | 定位 | 元素 |
| --- | --- | --- |
| 1 | 痛点 | 文章开头的困境/焦虑具象化 |
| 2 | 转折 | 解决方案出现的关键时刻/工具 |
| 3 | 升华 | 文章结尾的理想状态/成果 |
3 张 prompt 必须互不相同,禁止复用模板。
凭证管理
凭证只写进 .env(已 gitignore)。
| 变量 | 必填 | 来源 |
| --- | --- | --- |
| WECHAT_APP_ID | ✅ | mp.weixin.qq.com → 开发 → 基本配置 |
| WECHAT_APP_SECRET | ✅ | 同上 |
| DASHSCOPE_API_KEY | 二选一 | 千问(推荐),dashscope.console.aliyun.com |
| DOUBAO_API_KEY | 二选一 | 豆包,console.volc.com/iam/keylist |
| IMAGE_PROVIDER | 可选 | qwen(默认) / doubao |
脚本对 .env 的支持
| 脚本 | 支持 .env | 不支持 → CLI 必传 |
| --- | --- | --- |
| generate_cover.py | ✅ 完全免参 | — |
| create_draft.py | ✅ 回退 | — |
| publish_article.py | ✅ 全部 | — |
| extract_to_markdown.py | ✅ 不需要凭证 | — |
| upload_material.py | ❌ | --app_id --app_secret |
| publish_draft.py | ❌ | --app_id --app_secret |
Agent 实践:调 upload_material.py / publish_draft.py 前,先 source <(grep -E '^WECHAT_' .env | sed 's/^/export /') 把凭证拼成环境变量,不要让用户重复输。
配图本地路径处理(常见坑)
如果 Markdown 里有 ! 这种本地图片路径:
- 微信 HTML 不能直接引用本地路径——需要先
upload_material.py把图片上传到微信永久素材 - 拿到返回的
url,替换 Markdown 里的本地路径 - 再送给 wechat-formatter 转 HTML
否则 HTML 粘到微信编辑器图片会裂。
不做的事
- 不写文章 → wechat-writer
- 不做 Markdown → HTML 排版 → wechat-formatter
- 不改稿 / 不审校 → wechat-writer
子文档导航
| 文档 | 何时读 |
| --- | --- |
| references/image-prompts.md | 写封面 / 配图 prompt 时 |
| references/wechat-api.md | 微信 API 返回错误码,看不懂时 |
| references/examples.md | 想看完整 bash 例子时 |
Other skills for the same job
different authors, same section of the catalogue
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
Improves the quality of images, especially screenshots, by enhancing resolution, sharpness, and clarity. Perfect for preparing images for presentations, documentation, or social media posts.
Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.
Lightweight WSI tile extraction and preprocessing. Use for basic slide processing tissue detection, tile extraction, stain normalization for H&E images. Best for simple pipelines, dataset preparation, quick tile-based analysis. For advanced spatial proteomics, multiplexed imaging, or deep learning pipelines use pathml.
Microscopy data management platform. Access images via Python, retrieve datasets, analyze pixels, manage ROIs/annotations, batch processing, for high-content screening and microscopy workflows.
Python library for working with DICOM (Digital Imaging and Communications in Medicine) files. Use this skill when reading, writing, or modifying medical imaging data in DICOM format, extracting pixel data from medical images (CT, MRI, X-ray, ultrasound), anonymizing DICOM files, working with DICOM metadata and tags, converting DICOM images to other formats, handling compressed DICOM data, or processing medical imaging datasets. Applies to tasks involving medical image analysis, PACS systems, radiology workflows, and healthcare imaging applications.
This skill should be used when working with pre-trained transformer models for natural language processing, computer vision, audio, or multimodal tasks. Use for text generation, classification, question answering, translation, summarization, image classification, object detection, speech recognition, and fine-tuning models on custom datasets.
How to use it
Take yishu5/wechat-publisher from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.