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