| name | h3-guide |
| description | MiniMax H3 视频创意规划、参考素材编排、Prompt 设计与迭代质检指南。用于文生视频、首尾帧视频、多图/视频/音频联合参考、角色与物体替换、动作和运镜迁移、背景与光影编辑、台词音色修改、TVC、片头、MG、短剧、产品、电商、游戏 UI、动画及风格化影像；当用户提到 H3、MiniMax 视频、H3 Prompt、参考图视频或希望用 opc-cli 生成/编辑 H3 视频时使用。 |
H3 Guide
把模糊创意转成可执行的 MiniMax H3 方案，并通过现有 opc skill 运行。本 skill 负责创意决策、素材分工、测试矩阵和质检；Prompt 的最终结构由 MiniMax 官方 h3-prompt-writing skill 负责。
前置规则
- 创建、改写或扩写 Prompt 时，先完整读取官方
h3-prompt-writing skill；Base 模式读取其 references/base-en.txt，Ref2VA 读取其 references/ref-en.txt。
- 需要真正生成或编辑视频时，再读取可用的
opc skill 及其 references/video.md，以当前 CLI 能力为准。
- 先检查用户提供的图片、视频和音频。视频至少读取时长、尺寸、帧率和音轨，并抽帧观察；图片实际查看后再分配角色。
- 用户只要求策划或 Prompt 时，不提交生成任务。用户要求生成、测试或继续迭代时，完成安全的生成、质检和交付。
- 不把风格词当方案。明确故事或功能、时间节拍、参考素材职责、镜头、声音、不变量和禁止项。
Prompt 格式归属
| OPC 工作流 | 官方模式 | 最终结构 |
|---|
h3-t2v | T2VA | integrated_multimodal_description、overall_soundscape、non_diegetic_music |
h3-i2v + 首帧 | I2VA | 官方首帧对齐句 + Base 三字段 |
h3-i2v + 首尾帧 | FL2VA | 官方首尾帧对齐句 + Base 三字段 |
h3-i2v + 尾帧 | L2VA | 官方尾帧对齐句 + Base 三字段 |
h3-r2v | Ref2VA | subject_definitions、summary、retention_analysis、detailed_description、overall_soundscape、non_diegetic_music |
最终 Prompt 使用英文；对白、歌词和画面内文字保留原语言。官方字段、顺序、[Shot N]、时间戳、<Subject N>、<Picture N>、<Video N>、<Audio N>、(S1) 和 <d> 语法不得由本指南另行发明或改写。
工作流选择
| 目标 | 工作流 | 选择条件 |
|---|
| 从零生成完整场景 | h3-t2v | 不要求固定角色、产品或构图 |
| 固定首帧，或规定首尾状态 | h3-i2v | 构图/主体外观由首帧决定，或必须到达尾帧 |
| 多图联合、动作/镜头参考、视频编辑、声音参考 | h3-r2v | 任意图片、视频、音频需要作为独立条件 |
默认采用两阶段生成。抽卡、试 Prompt、筛选 seed 时先做低分辨率 5 秒 Turbo 8 steps 预览；确定方案后保持 Prompt、参考素材顺序和 seed 不变，移除 --turbo，用 Base 20 steps 按用户目标分辨率最终出片。Turbo 是预览工具，不作为最终交付。H3 在 24 fps 的帧网格上会把 5 秒请求输出为约 5.167 秒；用户指定其他规格时遵从用户并用 opc video info 核实现时支持。
标准流程
1. 把需求拆成约束
提取并确认：
- 发布目标、观众、画幅、时长、分辨率。
- 主体、场景、动作、叙事或功能演示。
- 必须保持的身份、产品、构图、机位、声音和文字。
- 可以变化的部分，以及明确禁止变化的部分。
- 成功标准：观众看完应该感到什么、记住什么、相信什么。
2. 给参考素材分配单一职责
先写素材映射表，再写 Prompt。每份素材尽量只有一个主职责：
- 身份图：脸、发型、体型、服装或角色设定。
- 产品图：几何、材质、Logo、结构和颜色。
- 场景图：空间、色彩、光线和美术方向。
- 风格图：排版、材质、画面语言；不要让其覆盖身份。
- 分镜图：镜头顺序和构图变化。
- 视频：动作、表演节奏、运镜、剪辑或原场景。
- 音频：音色、台词、音乐结构或环境声。
h3-r2v 的媒体序号由命令行出现顺序决定，Prompt 必须使用完全一致的 <Picture 1>、<Video 1>、<Audio 1>。上限和音轨编号规则以 opc 当前文档为准。
3. 按官方骨架写 Prompt
先把输出合同、全局不变量、参考绑定、分秒动作、镜头、视觉、声音、文字和禁止项整理为创意约束，再按官方 h3-prompt-writing 对应模式写入固定字段。完整的创意拆解方法见 prompt-framework.md，但其中任何本地模板都不能覆盖官方字段名和顺序。
4. 选择风格语法
不要只写“电影感”“高级感”。从 style-cookbook.md 选择相应的构图、镜头、材质、剪辑、声音和反例。需要可复用视觉参考时，先读 reference-library.md，再用 view_image 查看具体资产。
涉及审美片、TVC、微距、材质转场、实拍融合或用户要求“惊艳”时，必须再读 aesthetic-mechanics.md。提交生成前把审美目标改写成可观察的光学、材料、空间、转场和停留机制；“电影感”“高级感”“丝滑”不能单独作为执行指令。
5. 执行编辑策略
角色/物体替换、背景和光影、动作/运镜迁移、多项同时修改、台词/音色编辑，按 editing-playbook.md 处理。编辑 Prompt 必须先声明原视频不变量，再列出唯一允许变化的部分。
6. 测试与迭代
先用 --turbo 抽卡并筛选 Prompt/seed，做六格抽帧和关键局部对比，再决定重试。选中方案后必须用相同 Prompt、参考素材顺序和 seed 去掉 --turbo 重跑 Base 20 steps，并以 Base 成片完成最终质检。按 qa-iteration.md 判断是改 Prompt、换参考、拆任务还是承认模型边界；不要仅凭首帧宣布成功。
opc video -w h3-t2v --prompt-file prompt.txt \
--width 608 --height 352 --duration 5 --seed 42 --turbo
opc video -w h3-t2v --prompt-file prompt.txt \
--width 1376 --height 768 --duration 5 --seed 42 --steps 20
h3-r2v --turbo 可用于编辑方案预览，但必须重点检查身份、动作、镜头方向和时序保留；最终 Ref2VA 成片同样移除 --turbo。
每次运行前先记录一个“美感假设”和一个“最大风险”。技术规格通过不等于创意通过；失败运行保留为研究样本，下一轮只改变最可能的根因。
每次规划的交付格式
按下列顺序输出，缺少的项明确写“无”：
- 创意一句话与成功标准。
- 工作流、画幅、时长、分辨率、steps，以及当前属于 Turbo 抽卡还是 Base 最终出片。
- 参考素材映射表及命令行顺序。
- 可直接保存为文件的完整 Prompt。
- 可执行的
opc video 命令或 dry-run 命令。
- 首轮测试重点、失败判据和下一轮只改哪个变量。
完成标准
- Prompt 与命令中的媒体序号完全一致。
- 参考职责没有互相冲突。
- 声音、文字、镜头和动作都有明确时序或保持规则。
- 生成结果通过实际抽帧、音轨和解码检查。
- 若两次有针对性的迭代收敛到同一缺陷，报告边界并给出拆镜、遮罩合成或后期方案，不继续盲目烧算力。
