--- name: h3-storyboard-main description: "H3 分镜设计师操作手册:把 prd+artifact 换算成逐镜头分镜脚本 sdd(镜号/时长/画面/运镜/音频/参考id),落在 04-storyboard/。" layer: 1 domain: video keywords: - storyboard - sdd - shots - camera - h3video --- # Skill: H3 分镜设计师 四段式操作手册 角色契约见 `../../agent.md`,本手册只管"怎么干"。 ## 我的坐标(固定落点) | 坐标 | 路径 | 规矩 | |------|------|------| | 输入(必需) | `03-asset/artifact.md`(含资产缺口表) | 缺口表有洞 → blocked 打回 h3-asset | | 输入(needs) | `02-story/prd.md` | 叙事节拍是分镜母体 | | 交付物 | `/app/data/companies/h3video/workspace/04-storyboard/sdd.md` | **只有写到这里才算交付** | | 禁写 | `01-*` ~ `03-*`、`05-*` ~ `07-*` | 越界 = 节点判失败 | ## 四段式(本角色具体化) ### RESEARCH 1. 抄进 `_research.md`:prd 节拍表(编号)、brd 时长约束数字、artifact 的 id 列表 (`char-*` / `scene-*` / `ref-*`)。 2. 先算账:总时长 ÷ 节拍数 = 平均每拍几秒,决定镜数(一拍可拆 1-3 镜,不硬凑)。 ### PLAN `_plan.md`:镜数、逐镜时长草案、节拍↔镜号映射草表。 验收标准写死为 agent.md 的 1-6 条(镜号连续 / 五字段无空 / 每镜一运镜 / 时长偏差 ≤10% / 节拍全覆盖 / id 引用真实存在)。 ### EXECUTE 按 agent.md 的逐镜表写 `sdd.md`。措辞纪律: - 画面字段引用资产 id(`char-01`),不复述外观 —— 资产包是唯一事实源。 - **一镜只写一个主导运镜动词**;需要"推进后横移"就拆成两镜。 - 音频字段台词逐字引自 prd;参考素材字段写 `ref-0N`,不复制 url 全文。 - 文末:节拍↔镜号映射、时长台账(逐镜时长 + 总和 + 偏差)、「本次没做什么」。 ### VERIFY 1. `grep -c "^## Shot\|^| Shot" sdd.md` 核对镜数 = plan 数。 2. 逐镜检查运镜字段只含一个动词(出现"推进并横移"即打回)。 3. 时长台账亲手加一遍(node/awk 累加,不口算),与 brd 时长约束比偏差。 4. `grep -o "char-[0-9]*\|scene-[0-9]*\|ref-[0-9]*" sdd.md | sort -u` 与 artifact 的 id 列表比对, 引用了不存在的 id 即打回。 ## 硬规矩(本角色) - 不写 H3 提示词正文(那是 h3-video-prompt 的活)。 - 不发明 artifact 里没有的外观/细节。 - 时长总和超 10% = 没做完,不留给下游"想办法压缩"。