打开 claude.ai（桌面 / CLI 版本），对 Claude 说一句话—— /giggle:video-production-image2 帮我做一集…… ——剩下的全是 Claude 替你做。它会自己跑脚本、写提示词、生成参考图和板图。你要做的，是在每个关键产物出来后点一下「这样可以」——剧本、参考图、分镜提示词，三道关，每道都是你说了算。

载入凭证 + 设置 SKILL_DIR

开工前先把 OpenRouter 凭证拉起来；接着把 SKILL.md 所在绝对路径塞进 shell 变量，后续所有脚本都通过它寻址。本机需要装好 uv（PEP 723 内联依赖运行器）。

$ # 1. 加载 OPENROUTER_API_KEY / _BASE_URL（参考 shared/config-loader.md）
$ # 2. 指向 SKILL.md 所在绝对路径
$ export SKILL_DIR="<本 skill 的绝对路径>"
$ uv --version  # 必须存在

一句话开机，Gemini 出剧本

把 idea 抛给 Gemini 3.1，产出 story.md。如果手头有满意的旧剧本，可以用 --ref-format 告诉它"照这个结构来"。

$ mkdir -p ./max-leaf-kitchen && cd ./max-leaf-kitchen

$ uv run $SKILL_DIR/scripts/gemini_script.py \
    --idea "根据 Max 三视图做一集 AI 英语学习短片" \
    --ref-format /path/to/reference-story.md  # 可选

→ story.md

• 质量检查：开头简介 → 标题中英双语 → 角色设定 → 核心概念 → 分镜剧本 → 制作建议。缺一项就 --extra "..." 重跑。
• 详细行为见 agents/gemini-editor.md。

两张参考板定下视觉基调

从 story.md 抽出角色 + 关键道具，写进 ref-prompts.md。脚本按 ## 板 NN 正则分段，所以这个格式不能错。

$ uv run $SKILL_DIR/scripts/image2_board.py \
    --prompts ./ref-prompts.md \
    --refs Max-ref.png \
    --aspect 16:9 --size 2K \
    --out-prefix ref

→ ref_01.png  · 角色参考板（所有新角色三视图）
→ ref_02.png  · 道具场景参考板（含俯视布局图）

电影制作板格式的提示词

每个 Scene 一张「电影制作板 / 视觉规划表」。中文撰写，按区域排版，让 image2 看一眼就知道整张板的章法。

• ① 创意指导：镜头数量 / 统一调色板 / 环境描述
• ② 角色与风格参考：多角度参考 + 本幕关键表情姿态
• ③ 环境与场景：俯视示意图 / 摄影机位置 / 运动路径
• ④ 分镜序列：4–8 个编号镜头，每个含镜头类型 / 大小 / 运动 / 动作 / 情绪
• ⑤ 灯光与情绪：光线条件 / 氛围变化 / 材质 / 跨幕灯光弧线
• ⑥ 约束：无水印 · 中文限制 · 4K

六项逐板逐镜过

写完提示词必须 review。漏一项，生成出来才发现角色飘逸 / 道具消失 / 位置穿帮 / 台词丢失——重跑的钱可比 review 的时间贵多了。

• ① 角色位置锚定——每次出现都带「坐在哪 / 站在哪」
• ② 道具连续性——手持物品、场景道具跨镜状态一致
• ③ 角色外观一致——每板重复完整外观描述，分镜带核心视觉锚点
• ④ 空间逻辑——镜头切换视角合理，相对位置不漂
• ⑤ 跨板衔接——上板结尾 ↔ 下板开头自然过渡，灯光弧线连贯
• ⑥ 音乐 / 音效 / 旁白——每个 Scene 末尾独立成块的三行块，旁白逐行 {角色}{情绪}『台词』；

image2 出故事板

把第 02 步生成的参考图作为 --refs 传进去，锁定角色 / 道具 / 场景。

$ uv run $SKILL_DIR/scripts/image2_board.py \
    --prompts ./board-prompts.md \
    --refs ref_01.png ref_02.png ref_03.png \
    --aspect 16:9 --size 2K

→ board_01.png ... board_NN.png（按 ## 板 NN 分段）

板图作参考图，整集就拍出来了

这一步提示词就一句。打开 Seedance / libTv，选「全能参考」，把每张 board_NN.png 作为参考图丢进去，提示词写：根据故事板 {{Portrait 1}} 生成视频。板图的章法已经把镜头逻辑写死了，模型直接顺着拍就行。