Skip to content

jianshuo/claude-skills / wjs-publishing-wechat

wjs-publishing-wechat

Unverified

当用户想写或发布微信公众号文章时使用——他们给出零散思路、草稿或笔记,请你润色、生成题图和解释图,或准备上传到 mp.weixin.qq.com。触发词:"写一篇微信文章"、"公众号"、"润色"、"题图"、"发公众号"、"/wjs-publishing-wechat"。

FileKindSize
.gitignoreother65 B
.publish-manifest.jsonconfig13.2 KB
LICENSEother1.0 KB
README.mdmarkdown4.7 KB
SKILL.mdskill md14.2 KB
STYLE.mdmarkdown10.8 KB
prompts/cover-prompt.mdmarkdown20.6 KB
prompts/illustration-prompt.mdmarkdown2.8 KB
scripts/backfill-permalinks.pyexecutablescript9.3 KB
scripts/build-recent-articles.pyexecutablescript5.5 KB
scripts/fetch-comments-by-cookie.shexecutablescript12.2 KB
scripts/fetch-comments-via-gstack.shexecutablescript10.8 KB
scripts/fetch-comments.shexecutablescript5.4 KB
scripts/gen-cover-ai.shexecutablescript3.8 KB
scripts/gen-illustration.shexecutablescript3.0 KB
scripts/mass-send.shexecutablescript7.2 KB
scripts/open-draft-edit.shexecutablescript5.3 KB
scripts/pangu.pyscript2.9 KB
scripts/update-draft-via-api.pyexecutablescript3.9 KB
scripts/upload-draft.shexecutablescript19.4 KB
# wjs-publishing-wechat

写并发布**微信公众号**文章的 Claude Code skill。AI 生成题图和解释图,一行命令把草稿推到公众号后台。

三条原则:

1. **轻润色,不重写。** 保留作者的语气,只修错字、切段,不"提升"文笔。
2. **每篇两张图。** 2.35:1 的题图(封面用)+ 比例自由的卡通解释图(正文用)。
3. **一行命令发草稿。** `upload-draft.sh` 走 [md2wechat](https://github.com/jianshuo/md2wechat) API:上传封面、生成正文 HTML、建/更新草稿,自动打开后台草稿箱。手机预览后点发布。

## 怎么用

直接跟 Claude Code 说「写一篇公众号文章,思路是…」或 `/wjs-publishing-wechat`,把草稿粘进来。skill 会问 1–2 个问题,然后产出文章目录:

```
articles/2026-05-09-my-slug/
├── original.md          # 你的原始输入(备份)
├── article.md           # 轻润色后的 markdown
├── cover.png            # 题图 900×383(严格 2.35:1)
├── illustration.png     # 解释图(比例由模型按内容定)
├── meta.json            # title / summary / author / slug
├── content.html         # 生成的正文 HTML
└── draft.json           # 提交给 md2wechat 的草稿体
```

三个脚本分别管配图和发布:

```bash
DIR=articles/YYYY-MM-DD-slug

# 题图(2.35:1,自动裁到 900×383)
~/.claude/skills/wjs-publishing-wechat/scripts/gen-cover-ai.sh "$DIR" "目标字词"

# 解释图(比例自由,不裁)
~/.claude/skills/wjs-publishing-wechat/scripts/gen-illustration.sh "$DIR"

# 发布:建/更新草稿到 mp.weixin.qq.com 后台
~/.claude/skills/wjs-publishing-wechat/scripts/upload-draft.sh "$DIR"
```

图片脚本是幂等的——再跑一次得到不同结果(生成有随机性)。

## 安装

```bash
git clone https://github.com/jianshuo/wjs-publishing-wechat ~/.claude/skills/wjs-publishing-wechat
```

之后在 Claude Code 里说「写一篇公众号」「润色」「准备发布」或 `/wjs-publishing-wechat` 就会触发。

## 依赖

- **macOS / Linux**(`open` / `xdg-open` 打开浏览器)
- **Python 3**、**Node.js**
- **[md2wechat](https://github.com/jianshuo/md2wechat) CLI** — 发草稿用。需配好 `WECHAT_APPID` + `WECHAT_SECRET`(`md2wechat config show`),并把**当前公网 IP 加进公众号后台 IP 白名单**(设置与开发 → 基本配置 → IP 白名单),否则报 `errcode=40164`。
- **[gpt-image-2-skill](https://github.com/Wangnov/gpt-image-2-skill)** — AI 配图用:

  ```bash
  git clone https://github.com/Wangnov/gpt-image-2-skill /tmp/g
  cp -r /tmp/g/skills/gpt-image-2-skill ~/.claude/skills/
  ```

  鉴权:`OPENAI_API_KEY`(`gpt-image-2` 需 OpenAI 组织认证)**或** Codex `~/.codex/auth.json`(任意 ChatGPT Plus 账号即可,免认证,推荐)。

## 自定义

两个图片生成器读可编辑的 prompt 模板:

- **`prompts/cover-prompt.md`** — 题图设计哲学,含 `[目标字词]` 占位符,锁定 2.35:1
- **`prompts/illustration-prompt.md`** — 解释图风格指南,含 `[文章内容]` 占位符,比例由模型按内容选

`upload-draft.sh` 的环境变量:
- `WECHAT_PUBLISH_FORCE_NEW=1` — 强制建新草稿(不复用 `draft_media_id`)
- `WECHAT_PUBLISH_NO_OPEN=1` — 不自动打开浏览器
- `WECHAT_PUBLISH_NO_PUSH=1` — 不自动 push 文章目录到 git

## 文件结构

```
.
├── SKILL.md                    # skill 的行为(它的 prompt)
├── prompts/
│   ├── cover-prompt.md         # 题图 prompt 模板
│   └── illustration-prompt.md  # 解释图 prompt 模板
└── scripts/
    ├── gen-cover-ai.sh         # gpt-image-2 题图 → 900×383
    ├── gen-illustration.sh     # 解释图,不裁
    ├── upload-draft.sh         # 生成 content.html + 经 md2wechat API 建/更新草稿
    ├── pangu.py                # 盘古之白(中英间加空格)
    ├── update-draft-via-api.py # 草稿原地更新
    └── …                       # 留言抓取 / 群发等辅助脚本
```

## 为什么两张图?

**题图**是读者在公众号信息流里点开*之前*看到的封面,要在 2.35:1(900×383,公众号封面槽的精确尺寸)里一击命中,靠的是字体和构图。

**解释图**在文章里,要帮读者在读文字前先抓住概念。把它硬塞进封面比例会毁掉它。不同的活,不同的比例。

## 它明确不做的事

- 不替你重写文笔。想让 LLM 代笔,这工具不对路。
- 不管理公众号账号、粉丝分析、定时发送。

## License

MIT — 见 [LICENSE](LICENSE)。

## 作者

[王建硕](https://github.com/jianshuo) — 为自己的公众号工作流而做,分享给有同样问题的人。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall