| name | wjs-publishing-books-to-x |
| description | Use when 王建硕 wants to publish his VoiceDrop books (voicedrop.cn/books) to X/Twitter as threads — 列出他写的书、挑没发过的、整本拆成推文串发出。Triggers — "把书发到 X", "发书的 thread", "publish my book to X", "书架的书发推", "/wjs-publishing-books-to-x". |
wjs-publishing-books-to-x
把 VoiceDrop 书架上我写的书，一本一个 thread 发到 X。首条钩子 + 封面图，中间按书的脉络走，最后一条讲这本书是怎么用 VoiceDrop 写出来的。
Core Principle
一本书 = 一个 thread。 书已经是成品，thread 是它的预告片——从章节梗概和正文里抠最硬的内容，不重新构思、不写营销腔。
只发我的书。 书架是社区书架，上面有别的用户写的书，发出去就是替别人代言，绝对不行。
Workflow
Step 1: 列我的书，排除已发过的
mcp__voicedrop__list_books # 公开书架，免登录
- hidden 的书（book.json 里
hidden: true）服务端已滤掉，不用再处理。
- 我的书判定：
author == "王建硕" 或为空（早期的书没署名，都是我的）→ 是我的。其他署名（蜜蜡 / Dennis / sissi / …）→ 别人的书，不发。
- 对照
state/history.jsonl 排除已发过的，列出剩余清单让用户挑。用户点名某本 → 直接用那本。
Step 2: 读书
mcp__voicedrop__read_book <slug> # 目录 + 每章梗概 + 一句话简介
mcp__voicedrop__read_book_chapter <slug> intro # 序章；再挑 1-2 个最有料的章读正文
梗概给骨架，正文给 quotable 的细节（数字、比喻、反直觉的断言）。
Step 3: 拆 thread（结构合同）
| 条 | 内容 |
|---|
| 1 | 钩子：书的核心断言或问题 + 书名，配封面图 https://voicedrop.cn/books/<slug>/cover.jpg |
| 2 … N-2 | 按书的脉络每条讲透一个点，从梗概/正文里抠。总共 6–10 条 |
| N-1 | 全书免费读：https://voicedrop.cn/books/<slug>/ |
| N（必须） | 这本书怎么写的：真实过程——在 VoiceDrop 丢了一句什么中心思想（seed），书自己长出来、逐章补齐、不满意的地方一句话修书。落 voicedrop.cn |
硬约束：每条加权 ≤280（中文每字算 2），buffer 到 ~120 汉字。王建硕语气：平实、家常比喻。无 hashtag、无 emoji、无 @。链接只出现在 N-1 和 N 两条。盘古之白。
Step 4: 过目
整串列给用户确认（每条标序号 + 字数）。用户说过 --yes 或明确「直接发」才跳过。
Step 5: 发（xurl 链式）
SLUG=<slug>
curl -s -o /tmp/cover.jpg "https://voicedrop.cn/books/$SLUG/cover.jpg"
MEDIA_ID=$(xurl media upload --category tweet_image --media-type image/jpeg /tmp/cover.jpg \
| grep -oE '"media_id_string":"[0-9]+"' | grep -oE '[0-9]+')
resp=$(xurl -X POST -d "$(jq -nc --arg t "$T1" --arg m "$MEDIA_ID" \
'{text:$t, media:{media_ids:[$m]}}')" /2/tweets)
PREV=$(printf '%s' "$resp" | grep -oE '"id":"[0-9]+"' | head -1 | grep -oE '[0-9]+')
[[ -n "$PREV" ]] || { echo "POST failed: $resp"; exit 1; }
resp=$(xurl -X POST -d "$(jq -nc --arg t "$TN" --arg r "$PREV" \
'{text:$t, reply:{in_reply_to_tweet_id:$r}}')" /2/tweets)
任何一条失败：停在原地，把已发到第几条 + 失败原文给用户，别跳条继续（断链）。首条 URL：https://x.com/jianshuo/status/<首条id>。
Step 6: 记录
jq -nc --arg date "$(date +%F)" --arg slug "$SLUG" --arg id "$FIRST_ID" --argjson n $N \
'{date:$date,slug:$slug,thread_first_id:$id,tweets:$n,status:"posted"}' \
>> ~/.claude/skills/wjs-publishing-books-to-x/state/history.jsonl
收尾告诉用户：thread URL、哪本书、几条、还剩几本没发。
多本连发
一次 session 默认发一本。用户要「把书都发了」→ 每本间隔 ≥4 小时排期（一口气连发多个 thread 会被 X 判刷屏），机制照抄 wjs-tweeting-from-articles 的批量排期模式（队列 + cron 自节流）。
Daily 自动化（已装）
launchd 每天 10:10 跑 daily.sh：自动挑最新一本没发过的（chapters=0 的老书跳过）→ claude -p 按上面结构合同起草 → 校验加权长度 → 链式发出 → 记 history。书发完了自动歇着。
DRY_RUN=1 bash ~/.claude/skills/wjs-publishing-books-to-x/daily.sh
FORCE_SLUG=<slug> bash .../daily.sh
launchctl bootout gui/$(id -u)/com.jianshuo.wjs-publishing-books-to-x
日志：~/Library/Logs/wjs-publishing-books-to-x/。改时间：编辑 ~/Library/LaunchAgents/com.jianshuo.wjs-publishing-books-to-x.plist 后 bootout + bootstrap。
Anti-Patterns
| 不要 | 原因 |
|---|
| 发署名是别人的书 | 社区用户的书，不是我的 |
| thread 写成目录（第一章讲X，第二章讲Y…） | 要抠内容，不是报菜名 |
| 每条都塞链接 | 链接只在 N-1、N 两条 |
| 最后一条写成 VoiceDrop 广告词 | 讲这本书的真实写作过程，产品是顺带的 |
jq -r '.data.id' 解析发推返回 | 返回的 text 带裸换行，jq 报 control characters；用 grep |
| media upload 不带 --category | 默认按视频处理，图挂不上 |
File Layout
~/.claude/skills/wjs-publishing-books-to-x/
├── SKILL.md
├── daily.sh # launchd 每日入口（挑书→起草→校验→发→记录）
├── com.jianshuo.wjs-publishing-books-to-x.plist.template
├── scripts/
│ ├── pick-next-book.sh # 下一本没发过的我的书（新→旧）
│ └── fetch-book.py # 抓书素材（目录梗概+序章+前两章）→ 纯文本
└── state/
├── .gitignore # history.jsonl / today-* 不进公开 repo
├── history.jsonl # 每发一本记一行
└── today-*.{txt,json,jpg} # 当天工作文件
Dependencies
- xurl：
xurl whoami 能返回用户名
- voicedrop MCP：list_books / read_book / read_book_chapter（公开内容，免登录）
- jq
