Wjs Syndicating Articles

---
name: wjs-syndicating-articles
description: Use when the user wants to auto-syndicate their latest 微信公众号 article across social platforms — picks the newest un-syndicated article, extracts one core copy, auto-posts to API platforms (X / Bluesky / Threads / LinkedIn) and prepares a copy-paste outbox for manual platforms (Facebook / 小红书 / 即刻 / 知乎). Triggers — "分发文章到各平台", "同步到社交平台", "今天的文章发各平台", "/wjs-syndicating-articles".
---

# wjs-syndicating-articles

每天把最新一篇还没分发过的公众号文章，扇出（syndicate）到各社交平台。**一套文案走天下**，有 API 的真发，没 API 的备好待发件箱让你手动粘。

## Core Principles

- **稳定第一**：每个平台是独立步骤，一个失败绝不影响其它。
- **幂等去重**：`state/history.jsonl` 按 `(slug, platform)` 记录；重复跑只补发没成功的，永不重复发。
- **凭证降级**：API 平台缺/过期凭证 → 自动转 outbox（手动），不报错。
- **署名 / CTA 用「王建硕」**（用户全局偏好），不写营销腔、不堆 hashtag/@/emoji（除非原文有）。

## Inputs

```
/wjs-syndicating-articles                 # 选最新未分发文章，走完整流程（默认/定时用）
/wjs-syndicating-articles <article-folder># 显式指定文章
/wjs-syndicating-articles --open          # 交互模式：打开手动平台 web 页 + 文案进剪贴板
/wjs-syndicating-articles --dry-run       # 只草拟，不发、不写 history
/wjs-syndicating-articles --mark <slug> <platform>  # 手动标记某平台已发
```

`SKILL_DIR = ~/.claude/skills/wjs-syndicating-articles`

## Workflow (default / scheduled run)

### Step 0: --mark short-circuit
若调用是 `--mark <slug> <platform>`：`bash $SKILL_DIR/scripts/history.sh record <slug> <platform> posted` 然后告诉用户已标记，结束。

### Step 1: 选文章
```bash
bash $SKILL_DIR/scripts/pick-next-article.sh
```
- 显式指定了 `<article-folder>` 则跳过此脚本，直接用它。
- 输出为空 → 最近文章都分发完了，今天 rest day，结束。
- 记 `FOLDER`，`SLUG=$(basename "$FOLDER")`。

### Step 2: 抽一套核心文案（你来做，不是脚本）
读 `$FOLDER/article.md` 和 `$FOLDER/meta.json`。抽出**一段最 quotable 的核心句/小段，≤120 字**（保证塞进 X 的 280 字符；中文每字算 2），保留王建硕语气。再加一行软 CTA + 文章链接（公众号链接，没有就用 `meta.json` 里信息+ `article_url_base`）。

把最终文案写进 `$SKILL_DIR/outbox/<date>-<SLUG>/post.txt`（先 `mkdir -p`）。`<date>=$(date +%F)`。

`--dry-run` 时：打印 post.txt 内容 + 下面每个平台「将发什么」，**不**继续 Step 3+，结束。

### Step 3: 扇出（一个确定性脚本搞定，LLM 不碰 key）
```bash
bash $SKILL_DIR/scripts/syndicate.sh "$FOLDER" "$POST_TXT"
```
`syndicate.sh` 内部：slug 一律取 `basename "$FOLDER"`；API 平台（X/Bluesky/Threads/LinkedIn）逐个 try/catch 真发，X 会先查 tweeting skill 的 history 防双发，缺凭证的自动降级记 `queued`；手动平台（Facebook/小红书/即刻/知乎）调 `build-outbox.sh` 备好 `outbox/<slug>/` 并记 `queued`。**不要自己手写平台循环或拼 slug** —— 全交给脚本，避免 key 漂移。`--dry-run` 时改跑 `syndicate.sh "$FOLDER" "$POST_TXT" --dry-run`（不发、不写 history）。脚本 stdout 的每行 `  <platform>: ...` 和末尾 `outbox=...` 就是 Step 5 汇总的数据来源。

### Step 5: 通知 + 汇总
打印一张表：每个平台 status（posted+URL / queued(outbox) / failed / skipped）。
无人值守（定时）跑：发一条 PushNotification，例：「✅ X、Bluesky 已发；📋 Facebook/小红书/即刻/知乎 在 outbox 待粘：$OUTBOX」。
**不要**在 Step 5 自动开浏览器——那是 `--open` 的事。

## --open mode（交互，发手动平台时）
1. 找到今天的 outbox：`$SKILL_DIR/outbox/$(date +%F)-<SLUG>`（或最新一个）。
2. `cat OUTBOX/post.txt | pbcopy`（文案进剪贴板）。
3. 用 `/browse` skill 打开 config 里 facebook、jike、zhihu 的 `web_compose`。
4. 小红书：`open "$OUTBOX/image.png"`（Finder 弹出），提示用户 AirDrop 到手机、文案已在剪贴板。
5. 逐个提示：粘贴 → 发布。用户发完某个可 `--mark <slug> <platform>`。

## File Layout
```
$SKILL_DIR/
├── SKILL.md  config.json  secrets.json(gitignored)
├── scripts/  lib.sh history.sh pick-next-article.sh post-*.sh build-outbox.sh
├── outbox/<date>-<slug>/  post.txt image.png OPEN.md
└── state/history.jsonl
```

## 配置 API 平台（可选，配了才真发）
拷 `secrets.json.example` → `secrets.json`，按需填 bluesky / threads / linkedin。不填的平台自动走 outbox。

## Daily 自动化
```
/schedule daily 10:00 /wjs-syndicating-articles
```