Use when the user wants a book turned into YouTube chapter videos — 每章用 VoiceDrop 读书的有声书 mp3 做音轨，配 GPT Image 2 画面和中心思想大字，输出 1920×1080 横屏视频发 YouTube。
Triggers — "把这本书做成视频", "有声书做成视频", "讲书视频", "book video", "/wjs-creating-video-book <书名>".
インストールする前に、エージェントに与えられる指示の中身を確認できます。
把一本书做成 按章节的 YouTube 视频：每一章用 VoiceDrop 读书的有声书 mp3 作为音轨，从章节内容提炼 1-3 个中心思想，为每个中心思想设计提示词、用 GPT Image 2 生成画面（Ken Burns 缓推 + 交叉淡化），中心思想以大字叠加在画面上，最终合成 1920×1080 横屏视频，上传 YouTube。
| 维度 | 默认 |
|---|---|
| 尺寸 | 1920×1080 横屏 (16:9)，30fps |
| 粒度 | 一章一支视频（章节 mp3 多长视频就多长） |
| 音轨 | VoiceDrop 读书的章节有声书 mp3（不重新 TTS） |
| 画面 | 每章 1-3 张 GPT Image 2 生成图，Ken Burns 缓推，段间 1s 交叉淡化 |
| 文字 | 每个中心思想：大字标题（≤12 字）+ 一句阐释，淡入淡出，Pillow 渲染 |
| 项目目录 | ~/code/book-videos/<book-slug>/ |
| 输出 | <slug>-chNN.mp4 × N 章 + UPLOAD_META.md |
| 发布 | wjs-uploading-video 上传（横屏普通 video），默认 public |
/wjs-creating-video-book <书名或书架章节>/wjs-converting-text-to-video/wjs-voicedrop-reading-aloud/wjs-publishing-wechat这是「听为主、看为辅」的视频。 音轨是整章朗读，观众是在"听书"；画面的职责是给眼睛一个可以停留的锚点，不是动画表演。所以：
SLUG=<book-slug> # 优先用书的英文名短 slug（如 naval-almanack）；没有英文名才用拼音
BOOK=~/code/book-videos/$SLUG
mkdir -p $BOOK/chapters/{01,02,...} # 每章一个两位数目录
| 素材 | 来源（按优先级） |
|---|---|
| 章节 mp3 | ① jianshuo.dev 书架有声书已合成的章节 mp3（R2，见 memory [[jianshuo-dev-audiobook]]）直接下载 ② 没有 → 用 /wjs-voicedrop-reading-aloud 从章节文本生成 |
| 章节文本 | 书架页面 / 用户给的 PDF・EPUB（EPUB 先 pandoc x.epub -t plain，pandoc 未装先 brew install pandoc） |
存为 chapters/NN/audio.mp3 和 chapters/NN/chapter.md。
ideas.json读 chapter.md，挑真正的支柱观点。数量跟着音频长度走：<5 分钟 1-2 个，5-15 分钟 2-3 个，>15 分钟也最多 3 个（画面是锚点不是字幕）。
[
{"title": "杠杆是新的钱", "caption": "代码和媒体是无需许可的杠杆", "image": "img-1.png", "start": 0},
{"title": "把自己产品化", "caption": "独特知识乘以杠杆才有复利", "image": "img-2.png", "start": 312}
]
title ≤12 字（大字）；caption 一句话 ≤20 字；都不写标点结尾start（秒）= 该思想在朗读中开始被讲到的位置，按文本位置比例估算即可；全部省略则均分音频先给全书定一个风格底稿 $BOOK/style.md（只做一次）：媒介必须是插画类（editorial illustration / 水彩插画 / 极简扁平插画等，不用照片写实——插画在 Ken Burns 缓推和文字叠加下最耐看）、色调家族、光线气质，2-3 句。
每张图的提示词按视频友好插画模板拼装 = 全书插画风格 + 该思想的具象场景 + 固定收尾：
node ~/.claude/skills/gpt-image-2-skill/scripts/gpt_image_2_skill.cjs \
--json --provider codex images generate \
--prompt "<全书插画风格>. <这个中心思想的具象场景>. Wide horizontal panoramic composition, landscape orientation, cinematic 16:9 framing. Generous negative space, calm lower left area for text overlay. Illustration, not a photograph. No text, no words, no letters." \
--out $BOOK/chapters/NN/img-1.png --format png --size 1920x1088 --quality high
固定收尾三句缺一不可，各治一种实际踩过的坑：
--size 只是参考，构图实际跟着提示词走；不写这句会返回方图甚至竖图（竖图被 16:9 居中裁剪后损失大半画面）。渲染脚本虽有兜底裁剪，但源头出横图才是正解其余要求：
cd $BOOK/chapters/NN
uvx --with pillow python ~/.claude/skills/wjs-creating-video-book/scripts/render-chapter.py .
mv chapter.mp4 $BOOK/$SLUG-chNN.mp4
脚本（已在本机验证）做的事：每张图 3840 上采样后 zoompan 缓推（12s 约 1.09×）、段间 1s xfade、中心思想大字 + 阐释句 Pillow 渲染成透明 PNG 后 overlay（1s alpha 淡入淡出，避开段首段尾各 0.8s/0.5s）、章节 mp3 直接做音轨，-crf 19 输出。字体自动探测 PingFang → Hiragino Sans GB → STHeiti。
注意：本机 ffmpeg 没编译 drawtext，文字必须走脚本里的 Pillow 路径，别试图手写 drawtext 滤镜。
用视频帧 + 大字（不另画 AI 插画）：挑该章标题字最清晰的一帧：
ffmpeg -y -ss <标题完全显示的秒数> -i $BOOK/$SLUG-chNN.mp4 -frames:v 1 -vf scale=1280:720 $BOOK/thumb-chNN.jpg
uploader 不支持 API 设缩略图 — 上传后提醒用户在 YouTube Studio 手动设置。
UPLOAD_META.md + 上传格式必须严格照抄下面骨架 — upload_youtube.py 的解析器只认 ## NN · 文件名 块头 + **短标题** / **视频描述** 小节 + 正文里的 #tag，别的格式解析出 0 个块直接退出。每章一个块：
## 01 · <slug>-ch01.mp4
**短标题**
《书名》第一章：<章名或一句话钩子>
**视频描述**
<本章讲什么，2-3 句> + 本章的中心思想列表
有声书朗读来自 VoiceDrop。
#有声书 #听书 #<书名> #<作者> #读书
---
uvx --with google-auth --with requests python \
~/.claude/skills/wjs-uploading-video/scripts/upload_youtube.py --dir $BOOK
章节多时注意 YouTube 每日配额（默认约 6 个/天）：建 upload-batch-N/ 暂存目录放当天要传的 mp4 软链接 + UPLOAD_META.md 软链接，--dir 指向暂存目录分天传。
--dir 模式自动配对目录里的 mp4 和 UPLOAD_META.md（不要用 --video + --meta — --meta 只在 --dir 分支生效，--video 分支要求 --title 且忽略 meta 文件）。多章节视频建议加 --playlist <id> 归入同一播放列表。上传完把链接回给用户。
每支视频上传后，把该章文稿以「置顶评论 + 按小节分条回复」的形式挂在视频下面（听书的人可以对照读）：
uvx --with google-auth --with requests python \
~/.claude/skills/wjs-creating-video-book/scripts/post-transcript-comments.py \
<video_id> chapters/NN/chapter.md \
--header "📖《书名》第 N 章「章名」全文文稿"
脚本行为：自动剥离 chapter.md 里的站点页眉页脚，按 ## 小节切成 3-6 条评论（第一条是置顶主评论，其余作为它的回复，每条 ≤4200 字、标 k/N 序号），回复间隔 2s 防 spam 判定。
权限：需要 youtube.force-ssl scope。若 token 只有 youtube.upload（发评论报 403 / 脚本提示 re-auth），跑一次 uvx --with google-auth-oauthlib python ~/.claude/skills/wjs-creating-video-book/scripts/reauth-youtube.py — 会弹浏览器让用户点一次授权，新 token 同时含 upload + force-ssl，以后不用再弹。
~/code/book-videos/<slug>/
├── style.md # 全书视觉风格底稿（一次定）
├── <slug>-ch01.mp4 ... # ⭐ 每章最终视频（在根目录，供 --dir 上传扫描）
├── thumb-ch01.jpg ... # 每章缩略图（YouTube Studio 手动设）
├── UPLOAD_META.md
└── chapters/
└── 01/
├── chapter.md # 章节文本
├── audio.mp3 # VoiceDrop 读书 mp3
├── ideas.json # 1-3 个中心思想
├── img-1.png ... # GPT Image 2 画面
└── overlay-1.png ... # 脚本生成的文字层（中间产物）
| 不要 | 原因 |
|---|---|
| 把章节文本重新 TTS | 音轨就是 VoiceDrop 读书 mp3，重新合成既浪费又不一致 |
| 一章塞 5-6 个中心思想 | 画面变成字幕机。锚点宁少勿多，≤3 |
| 提示词里让 AI 画字 | GPT Image 2 画中文必崩。提示词强制 "No text"，文字走 Pillow 叠加 |
| 提示词不写 landscape/wide composition | Codex 端 --size 只是参考，会返回方图竖图，16:9 裁剪损失大半画面 |
| 用照片写实风格 | 插画才耐得住 Ken Burns 缓推 + 大字叠加；photo 风显廉价 |
| 画抽象概念图解（箭头/图表/概念词） | 画具象场景，让画面自己会呼吸 |
| 每章换一种画风 | 全书一个 style.md，章间一致 |
| 手写 drawtext 滤镜 | 本机 ffmpeg 没编译 drawtext，会 "No such filter"。用脚本的 Pillow 路径 |
| 在版权书直接公开发布 | 整章朗读原文的版权风险远大于讲书评论。公版书 / 有权利的书才默认发；否则先确认 |
| 缩略图另画 AI 插画 | 用视频帧 + 大字（同封面约定） |
上传用 --video + --meta | 该组合不成立（--video 要求 --title 且忽略 meta），用 --dir |
uvx --with pillow python ...）~/.claude/skills/gpt-image-2-skill/，--provider codex）— 画面生成~/.config/youtube/token.json — 上传brew install pandocまだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
王建硕的思维框架与表达方式。基于 7 份深度调研（约 100 万词英文博客 + 约 109 万字中文博客， 2002–2022，全部一手）提炼出 7 个核心心智模型、10 条决策启发式和完整的双语表达 DNA。 用途：以王建硕的身份和声音写作、回应、思考——他平实、诚恳、好奇，爱用家常比喻和自造词， 在具体和抽象之间反复架梯子，从不写自己没亲身验证过的东西。 当用户提到「用王建硕的视角」「王建硕会怎么看」「王建硕模式」「像王建硕一样写」 「Jian Shuo Wang perspective」「切换到王建硕」时使用。 即使用户只是说「帮我用王建硕的角度想想」「如果是王建硕会怎么写这篇」也应触发。 一旦激活，本次对话后续所有回应都保持王建硕身份，直到用户明确说「退出」—— 不需要每轮重新点名。 不适用：用户要的是关于王建硕本人的客观介绍 / 事实查询（「王建硕是谁」「他哪年创业的」）， 那种问题正常回答即可，不要进入角色扮演。
日本語の概要は準備中です。原文の説明を表示しています。
Use when the user asks to audit what's wrong with a project, "make it right", "看看项目出了什么问题", "为什么用户的需求还没上线", "为什么没提交App Store", "为什么没新build", or wants a holistic state-of-the-project check covering unmerged branches, stalled PRs, failed GitHub Actions, stale builds, plan drift (TODOS.md / ROADMAP), unreleased commits, and log errors. Runs read-only investigation, presents a grouped checklist, fixes only after explicit user confirmation. Aware of the Cathier iOS app workflow (Xcode + fastlane + auto-merge @claude PRs from in-app feedback).
日本語の概要は準備中です。原文の説明を表示しています。
Use when the user has a video + an SRT and wants the subtitles either burned into the pixels (libass, always-visible) or soft-muxed as a togglable track. Also handles the final composite step for the localization pipeline — burn subs, mix a dub track, and keep the original audio as a low-volume bed, all in ONE ffmpeg encode (no cascade). Verifies libass availability and auto-downloads a static evermeet ffmpeg build when Homebrew's stripped binary lacks it. Triggers — "烧字幕", "硬字幕", "burn subtitles", "burn-in subs", "embed subtitle", "soft mux SRT", "把字幕烧进视频", "做最终合成".
日本語の概要は準備中です。原文の説明を表示しています。
Use when the user complains about spam on his X/Twitter posts — 同城面付 / 寻固炮 / 线下上门 / 免费破处 这类引流号在他推文下刷的 emoji 垃圾回复 — and wants them removed. Covers the last 7 days (X recent-search window). Triggers — "把这些spam删掉", "清理X垃圾回复", "推文下面好多引流号", "clean spam replies", "/wjs-cleaning-spam".
日本語の概要は準備中です。原文の説明を表示しています。
Use when the user wants a 王建硕-style WeChat article (article.md) turned into a narrated short MP4 video — TTS voiceover via 火山引擎 Volcano TTS, HyperFrames CSS/GSAP animation per scene, subtle SFX, abstract watercolor background, full pipeline rendering to 1080×1920 portrait MP4 (30-90s). Triggers — "把这篇文章做成视频", "做一个解说视频", "讲解视频", "/wjs-converting-text-to-video".
日本語の概要は準備中です。原文の説明を表示しています。
Use when migrating a WordPress site to a Hugo static site on GitHub Pages from a WXR export (.xml) plus the wp-content/uploads folder — preserving /archives/<id>/ URLs, localizing images, and deploying via GitHub Actions. Triggers — "把 WordPress 迁成 Hugo", "wordpress 转静态站", "migrate WordPress to Hugo", "WXR to Hugo", "publish WordPress to GitHub Pages", "/wjs-converting-wp-to-hugo".
日本語の概要は準備中です。原文の説明を表示しています。