diff --git a/system/agents/h3-video-prompt/.claude/skills/main_skill/SKILL.md b/system/agents/h3-video-prompt/.claude/skills/main_skill/SKILL.md new file mode 100644 index 0000000..7701081 --- /dev/null +++ b/system/agents/h3-video-prompt/.claude/skills/main_skill/SKILL.md @@ -0,0 +1,364 @@ +--- +name: h3-video-prompt-main-skill +version: 0.2.0 (evolve iteration 2, final, deployed 2026-08-25) +status: enabled +benchmark_score: 98.71(8场景均分,不含TS-07判断性打分;含TS-07为99.125,最低分97) +source: 官方 MiniMax-AI/MiniMax-H3 仓库 raw.githubusercontent.com 逐字原文 + (skills/h3-prompt-writing/{SKILL.md,references/base-en.txt,references/ref-en.txt}, + 2026-08-25 由 Evolver 直接 fetch 全文核实,非二手转述) +--- + +# H3 视频提示词写作方法论 + +## 0. 总览与一条硬规则 + +MiniMax H3 提示词写作分 **5 种官方输入模式**:T2VA / I2VA / FL2VA / L2VA(合称"基础模式", +共享同一套 Part One + 三字段结构)/ Ref2VA("全参考模式",六字段结构)。 + +**硬规则(本轮训练新发现,纠正了此前骨架的隐含假设)**: +官方仓库顶层 `SKILL.md` "Output Rules" 明确写道 +*"Write rewrite sections in English; preserve dialogue, lyrics, and visible scene text in their +original language."* —— **这条规则对基础模式和 Ref2VA 全部适用**,不是 Ref2VA 专属。 +也就是说:`integrated_multimodal_description` / `detailed_description` / +`overall_soundscape` / `non_diegetic_music` / `subject_definitions` / `summary` / +`retention_analysis` 这些**结构化字段本身必须用英文书写**,只有 `...` 内的对白/歌词、 +和画面里真实出现的可见文字(招牌/字幕/霓虹灯字样)保留原语言逐字不译,不要翻译。 + +这条规则**在此前 agent.md 里被写反了**(agent.md 现有措辞是"跟随用户输入语言")——这是本次 +Evolve 阶段直接读取官方原始文件(而非转述)新确认的发现,knowhow_v1.md §9.1 曾把这部分标为 +"未核实",本轮已用 `raw.githubusercontent.com` 逐字读取解决,不再是未核实状态。 +与用户沟通说明("这条提示词里每个选择对应你需求里的哪句话"那段附加说明)可以用中文, +但**喂给模型的最终提示词原文本身必须是英文结构 + 保留原语言的对白/可见文字**。 + +--- + +## 1. Step 0:信息收集(带优先级) + +按以下顺序收集,缺失且无法合理推断的,一次性列全反问,不要挤牙膏: + +**优先级 1(不变量与事件,必须锁定)**: +- 有没有参考素材?分别是图/视频/音频,各多少个?—— 决定走哪种模式 +- 核心主体是谁/是什么(人物身份特征、产品外观特征) +- 核心动作/事件顺序是什么 +- 若有多个参考素材:每个素材各自负责锁定什么(外观/动作/风格/音色),不能让素材"裸奔"堆叠 + +**优先级 2(时长与结构)**: +- 期望时长(4-15秒,H3 官方范围) +- 是单镜头还是需要分镜(多个 [Shot N]) + +**优先级 3(质感,最后补)**: +- 情绪基调、运镜偏好、光影氛围 +- 是否需要对白/歌唱、语言是什么 +- 音乐风格偏好,或明确不需要音乐/环境声 + +能从上下文合理推断的直接采用并注明"按 X 理解";只有推断会显著改变结果时才反问。 + +--- + +## 2. Step 1:5 种模式判断决策树 + +``` +有参考素材吗? +├─ 没有 → T2VA(纯文本原创场景) +└─ 有 → 素材构成是什么? + ├─ 仅 1 张首帧图 → I2VA + ├─ 首尾各 1 张图,描述中间过渡 → FL2VA + ├─ 仅 1 张尾帧图,需要反推之前发生了什么 → L2VA + └─ 多素材身份/风格锁定 + (最多9图+3视频+3音频,或素材本身承担"定义可复用主体/编辑源视频/音色参考" + 等结构化角色,而不只是"起止帧锚点")→ Ref2VA +``` + +**易错判断**(对应 knowhow §6 / benchmark D6"首尾帧模式与全参考模式混用"): +- 首尾各一张图 ≠ 自动等于 Ref2VA。如果两张图纯粹是"起点画面"和"终点画面",中间只是过渡动画, + 用 FL2VA;只有当参考素材需要被拆成多个可复用主体、且要求跨镜头一致性追踪时,才升级到 Ref2VA。 +- 3 张不同角度的同一产品图 = 同一个 `` 的多个来源图,不要拆成 3 个不同主体 + (对应 TS-06 的判分点)。 +- 用户说"给我做个视频"这种完全无参考、无场景描述的极简请求,**不要**臆造一个具体场景直接写, + 先反问(见 Step 8 边界情况)。 + +--- + +## 3. Step 2:基础模式(T2VA / I2VA / FL2VA / L2VA)结构模板 + +### 3.1 Part One:模式专属的起始指令行(逐字模板,来自官方 base-en.txt) + +- **T2VA**:无指令行,直接从三字段开始。 +- **I2VA**(固定句式,`N` 恒为 1、`[Shot 1]` 恒为 1,因为只有一张首帧图): + ``` + For the target video, at 0.00 seconds into the target video, (from [Shot 1]) is fully referenced. + ``` +- **FL2VA**(`N` 是首尾图各自所在的实际镜头号,`S.SS` 是尾帧对应的精确到两位小数的时刻): + ``` + How the reference pictures align with the target video — Picture 1 (from Shot 1) aligns with the 0.00-second mark of the target video; Picture 2 (from Shot N) aligns with the S.SS-second mark of the target video. + ``` +- **L2VA**(`N` 是最后一个镜头号,`S.SS` 是有效视频时长): + ``` + How the reference pictures align with the target video — (from [Shot N]) aligns with the S.SS-second mark of the target video. + ``` +指令行必须是整段提示词的第一行,后面空一行再接三字段。 + +**硬规则(round 2 新增,修复 round 1 实测踩过的坑)**:上面模板里的 `N` / `S.SS` 是要你 +替换成本场景具体数值的占位符,**交付的最终提示词里绝对不能原样留下字面的 "Shot N" / +"S.SS-second mark" 这类未解析文本**——round 1 在 FL2VA/L2VA 两个场景里都真实犯过这个错误 +(把模板照抄进最终输出,没有替换成具体镜头号和具体秒数),交付前必须自查一遍指令行是否已经 +全部替换成实际数字。例:15 秒单镜头 FL2VA 的正确指令行是 +`Picture 2 (from Shot 1) aligns with the 15.00-second mark of the target video.`, +不是 `Picture 2 (from Shot N) aligns with the S.SS-second mark...`。 + +### 3.2 Part Two:三字段(顺序固定) + +``` +integrated_multimodal_description: [Shot 1] <风格声明>,<画面/动作/对白/同步音沿时间线展开>... + +overall_soundscape: <环境声/动作触发音/非语言人声,1-4句连续段落> + +non_diegetic_music: <角色听不到、只有观众听到的配乐,1-3句,聚焦配器/节奏/力度变化> +``` + +### 3.3 各模式推荐结构(内容组织,非字段本身) + +| 模式 | 推荐展开结构 | +|---|---| +| T2VA | 直接按时间线构建完整时间线,细节需与用户意图保持一致 | +| I2VA | 首帧锚定(还原 Picture 1 的主体/构图/场景)→ 动作起势 → 连续展开 → 结果/反应 | +| FL2VA | 首帧状态 → 可观察的中间变化 → 差异逐步收窄 → 尾帧状态;**优先单镜头**,模型据此在首尾帧间插值;仅在用户明确要求时才拆多镜头;末尾必须落到尾帧 | +| L2VA | 合理的前置状态(自行反推)→ 明确的动作与过渡路径 → 末镜头逐步收敛 → 落到尾帧画面 | + +--- + +## 4. Step 3:Ref2VA 全参考模式六字段结构 + +顺序固定:`subject_definitions` → `summary` → `retention_analysis` → +`detailed_description` → `overall_soundscape` → `non_diegetic_music`。 + +### 4.1 subject_definitions —— 四种标签 + +| 标签 | 含义 | 使用时机 | +|---|---|---| +| `` | 可复用的可见内容(人/动物/物体/场景/服装/道具/风格/动作/表情) | 参考素材里会被实际用到目标视频中的内容单元 | +| `` | 参考图作为具体目标帧或分镜锚点 | 仅当该图本身就是某镜头的首帧/关键帧/尾帧/构图锚点时才单独立项;如果一张图只是用来定义某个 Subject 的外观,不单独立项,在该 Subject 定义里引用来源即可 | +| `