h3-storyboard

h3-storyboard 是一个专为 MiniMax H3 视频生成模型设计的 Claude Code 技能。与大多数仅负责将文本转换为 H3 提示词格式的工具不同，h3-storyboard 深入到了导演层面：它指导用户如何将脚本拆分为镜头、如何控制表演节奏、以及如何规避 H3 在面部表情和物理模拟上的已知缺陷。

该技能的所有规则均源自实际制作中的对照实验（而非文档推测），旨在解决 H3 在生成长序列情感表演时的核心痛点。

核心发现：为什么你的角色“面瘫”？

该技能揭示了一个关键机制：当单个镜头包含过多的面部指令时，H3 会静默地丢弃它们。

通过对照实验（保持种子、参考图不变，仅改变镜头结构）发现：

• 7秒单镜头 + 9个节拍：PSNR 高达 37–42 dB（几乎等于冻结帧），面部毫无变化。
• 拆分为3个短镜头（每镜头1个节拍）：PSNR 降至 22–23 dB，每个节拍的情感都精准落位。
• 加入对话标签 <d>：虽然能增强表现力，但会导致 H3 重新分配屏幕时间，挤压相邻镜头的帧数，甚至导致背景元素消失。

结论：在写任何提示词之前，先数好节拍数。一个镜头中若超过 2-3 个表情节拍，必须拆分。

实战指南：H3 导演的生存法则

h3-storyboard 提供了一套经过验证的创作准则：

1. 表演与构图

• 切勿写“什么都没有改变”：这可能导致整个镜头静止。将停顿交给剪辑，而非提示词。
• 尺寸与距离用关系描述：避免使用绝对像素或百分比。例如，“高度为画框的三分之二”比“500px”更稳定；“离底部差一只手的宽度”比具体数值更易渲染。
• 无声角色用身体表演：没有对话挂载点时，用“伴随肩膀下沉的呼气”代替“下巴紧咬”。
• 先定摄像机，再写面部：如果角色看向画外，H3 会让他们看镜头。与其强制转头，不如移动摄像机到他们注视的方向。

2. 避坑指南

• 尾部崩塌：H3 在结束前 1.2–1.7 秒画质会退化，务必为此预留余量或在后期剪掉。
• 液体与碰撞：不要拍摄碰撞瞬间或液体体积。让手臂横扫过画面，切镜头，再从后果（如洒出的咖啡）开始。
• 品牌资产保护：避免介词直接接触品牌物体（如“咖啡在其底部周围闪闪发光”可能导致咖啡涂满脸）。指定明确距离并说明表面干燥。
• 竖屏限制：在 9:16 画幅中，“全身”和“大特写”是互斥的。若要主体占满 70% 高度，需裁掉底部。

3. 高级技巧

• 用 PSNR 验证表演：使用 dB 值表判断节拍是否发生，而非仅靠肉眼。
• 隐藏情感转折：直接 A→B 切换会导致面部像橡胶一样交叉淡入淡出。改为“闭上眼睛 → 下方改变状态 → 睁开眼睛”，实现逐帧验证的自然过渡。
• 配音按镜头预算：H3 将口型运动分布在整个镜头中。不要在说话镜头内包含吞咽或“说完”后的节拍，这会破坏配音同步。

安装与使用

安装

npx skills add https://github.com/phileiny/h3-storyboard-skill --skill h3-storyboard

或将 skills/h3-storyboard/ 目录复制到您的 .claude/skills/ 文件夹中。

配合使用

建议与 minimax-h3 技能配合使用：

• minimax-h3：处理提示词语法、ComfyUI 设置、量化及故障排除。
• h3-storyboard：专注于内容策略——即在提示词中放什么、如何拆分镜头、如何指导表演。

关于证据等级

技能内的规则在 SOURCES.md 中被标记为：

• 已验证：有对照实验支撑（如镜头拆分对 PSNR 的影响）。
• 部分已验证：效果真实存在，但原因未完全隔离。
• 推断：基于逻辑推理但未经大规模测试（如具体的节拍密度上限中间值）。