---

name: libtv-video-production description: Use when an agent needs to create or maintain LibTV CLI video shorts from storyboards, scripts, or reference images.

LibTV 短片制作（分镜 → 成片）

把"一组分镜"用 LibTV CLI 做成一支短片的通用方法论。美术基调可换（2D 绘本 / 写实 / 任意风格），方法论不变。本 SKILL.md 只给精简操作指引 + 速查；完整细节看同目录 AGENTS.md 与 references/*.md（见末尾索引）。

⚠️ 旧 sk-libtv-* OpenAPI 已废弃，只用 CLI（libtv login web 登录）。旧 API 建的项目不进 web dashboard。

v2 当前审计：认证、schema、模型标识符与受控多参考结论以能力快照（2026-08-05）为准；多参考 image2video 的唯一槽位契约在 AGENTS.md。

证据边界：仅认证、schema、modelName、受控多参考 image2video 槽位与 --run 超时后的既有节点查询属于当前审计观察；其余模型行为与生产启发式均为【历史经验，未重测】。

---

心智模型（一句话）

定调(质感词) + 建定版资产(角色/场景/道具) + 画故事板九宫格
  → 每镜 image2video(挂 故事板+定版图) 720p 试错
  → 全部齐 → ffmpeg 本地剪辑(转场+配乐+旁白) → 1080p 定稿

• CLI 三层结构：项目 → [分组] → 节点。节点参数 -s 写 data.params（走 schema），-u 写节点顶层属性。
• 故事板 = 唯一拍摄脚本：九宫格只决定"怎么拍/表达什么"（构图/景别/运镜/表演），风格色彩由设定图 + 质感词承担。
• 剪辑在本地做，不靠云端 video-clip 节点——ffmpeg 对转场/配乐/字幕可控得多。

---

SOP（每镜标准流程）

1. 看故事板九宫格实际画面，决定本镜挂哪些定版参考图（不按旧剧本文字加戏）。
2. 挑参考图：按 AGENTS.md 槽位契约安排受控多参考 image2video：clean 故事板（拍摄脚本）→角色定版（唯一外观依据）→场景定版（布局）→按需道具。
3. 写 prompt：质感词 + 按需套铁律模板（角色/比例/零文字/场景锁定/装备）。
4. 生成视频前先把方案报给用户，得到"OK"才 --run（图片生成可直接做）。
5. 【历史经验，未重测】可先用 720p 试错，再视需求以 1080p 定稿；价格以平台提交前的可见估算为准。
6. 段尾留转场钩子（光/门/手等出口动作），方便后期融合。
7. 全部镜头齐 → ffmpeg 统一剪辑成片。

单镜命令骨架：

$libtv = "$env:USERPROFILE\.libtv\libtv.exe"
& $libtv account info
& $libtv model star-video2  # 查询 schema 的 modelKey
& $libtv node create "shot07_video" -t video `
  --prompt "{{Image 1}} 是 clean 九宫格，唯一拍摄脚本；{{Image 2}} 是角色定版，唯一外观依据；{{Image 3}} 是场景定版，只确定布局。<本镜画面描述> + <质感词> + <按需铁律>" `
  --left "sb_07_clean" --left "wife_fixed" --left "scene_classroom" `
  -s model="StarVideo 2.0" -s modeType=image2video `
  -s ratio=16:9 -s resolution=720p -s duration=8 -s enableSound=off --run

---

关键铁律（5–8 条，违反多半返工）

#	铁律	要点
1	质感词锁死、每镜必带	开工先定一句固定质感词（如 2D 绘本：2D柔和动画绘本插画风格…gentle 2D storybook；绝不要3D/写实），所有图/视频原样复用，保证全片同风格。
2	定版图作锚、按角色槽位锁外观	凡涉及已定版的角色/场景/道具，必须挂定版图，绝不只靠文字还原。角色锚定说“角色定版图”，不把槽位编号外推到未测模式；九宫格重绘用 4K 是【历史经验，未重测】。
3	【角色铁律】+【人物比例铁律】	严格按角色定版图，9 格同脸同发型同服装；写明年龄+成年约 6.5 头身，禁幼态/大头娃娃/裁头/变形。【历史经验，未重测】
4	【零文字零数字铁律】	格内不写任何字（单据画横线、屏幕画亮屏）；prompt 注明"格号/箭头是标注不是画面内容"，否则视频会照抄穿帮。
5	负面词不点名（反召唤）	Seedance 负面指令弱：要排除某元素就通篇不提它的名字，改用【画面元素铁律】正面穷举"画面里有且只有：…"（"别想大象"效应）。
6	【场景锁定铁律】+ 控时长	长镜头后半会漂移：写"全程同一房间、家具按图不变"；时长压到 ≤12s 降漂移。
7	【镜头铁律】以人为主体	挂场景图易变成环境展示片：写"九宫格是唯一脚本、镜头紧跟人物、禁长段空镜/环境运镜，场景只是背景"。
8	真实记忆镜头先问用户	含真实仪式/道具/构图的镜头别凭脚本猜，先拿照片或口述参照再设计。

铁律完整模板（可直接复制）见 references/prompt-recipes.md。

---

高频坑速查（最常踩的 3–4 个）

坑（案例）	根因	解法
角色漂移/换脸（案例 06 长发漂移、13–16 幼态裁头）	编辑九宫格没挂锚点 / 分辨率低	【历史经验，未重测】重绘时以角色定版图作外观锚点 + 原九宫格只取构图 + 角色/比例铁律
格号/文字被照抄进画面（案例 19/22/27 气球上"②"、20 账单文字）	九宫格里有格号、箭头、文字	零文字铁律；仍穿帮就 nebula image2image 做 sb_XX_clean（去格号/箭头）喂片版，clean 版也要逐格 QC（重绘可能加戏）
多出实体（案例：第 3 只狗、水下凭空冒出狗）	参考图本身含该元素 / 负面词点名召唤	先查所有参考图有没有那元素，再改 prompt；用干净参考 + 正面穷举画面元素，排除项不点名
审核"未通过安全审核"三连拒（案例 30）	某参考图或某格触发审核（如人脸贴宠物特写）	【历史经验，未重测】短时探针 + 参考图二分排查定位真凶后替换；退款/积分以平台可见确认为准

全量 33+ 坑（CLI 操作 / 一致性 / 长镜头 / 道具 / 剪辑 / 审核 / Windows 中文路径）见 references/pitfalls.md。

---

Windows / 环境要点（一次性）

$libtv = "$env:USERPROFILE\.libtv\libtv.exe"   # CLI 路径
& $libtv login web                              # 浏览器登录，凭据落 ~/.libtv/credentials.json
# cd 到项目目录后：libtv project use <PROJECT_ID> 绑定 cwd（不假定 ID 是 UUID）

• 中文 prompt 用内联 PowerShell，不写 .ps1（GBK 读乱码）。
• cv2 等读中文路径用 imdecode(np.fromfile(...)) / imencode+tofile。
• 【2026-08-05 实测】--run 前台超时后先查询同名既有节点，再决定是否重试；只消费已验证 MP4 结果。
• 音乐节点 create 报"场景不一致"→ 加 -s scene=Music。

详见 references/content-safety-and-env.md。

---

安装方式

把本仓库目录（含 SKILL.md + AGENTS.md + references/）复制或软链到 Claude Code 技能目录即可被自动发现。<REPO_DIR> 替换为你 clone 本仓库后的本地绝对路径：

# Windows（软链推荐，改一处两处同步）
New-Item -ItemType SymbolicLink `
  -Path "$env:USERPROFILE\.claude\skills\libtv-video-production" `
  -Target "<REPO_DIR>"

# macOS/Linux 等价
ln -s "<REPO_DIR>" ~/.claude/skills/libtv-video-production

目录结构须保持 SKILL.md 在技能根、references/ 为同级子目录，否则下方索引的相对路径会失效。其他工具（Codex / CodeBuddy 等）的接入见仓库根 README.md。

---

完整细节索引（读这些拿全文）

想做什么	看这个文件
完整方法论（前期定调→建资产→生成→剪辑全流程深讲）	AGENTS.md
CLI 全命令矩阵 / 节点类型 / -s vs -u / NDJSON 管道 / 能力边界	references/cli-reference.md
端到端制作工作流（三阶段每步怎么落地）	references/production-workflow.md
Prompt 铁律模板全文（角色/比例/零文字/场景锁定/装备/in-scene 锚定…可复制）	references/prompt-recipes.md
ffmpeg 本地剪辑流水线（转场 xfade / 音轨 acrossfade / 字幕 / 拼装核对）	references/editing-pipeline.md
内容审核排查 + 真人合规 + Windows/PowerShell 怪癖	references/content-safety-and-env.md
全量踩坑速查表（按主题分类，跨项目通用）	references/pitfalls.md

版本

• 2026-08 · v2：根据 CLI 1.0.2 审计同步认证、模型名与受控多参考槽位；详见能力快照。