generate-video

## 约束 本 skill 是 AI 可按用户自然语言提交、准备或配置请求在当前上下文本地加载的内部知识。 用户后续明确要求生成视频，即表达已解析范围的首次提交意图，不再询问“是否授权生成”或“开始吗”。先核对目标和实际模型/参数并保存原请求，不把 scope 核对变成重复批准。仅查看配置或准备任务的请求不提交；short/series 不自动调用本入口。首次提交不以询问自动重试/监控许可为前提，无 retry grant 不重试。新问题先查配置、材料和 grants，由 Creator/Director 在权限内处理，仅真实范围/固定设置冲突、缺必要权限或指定检查点才提问。 按共享 intake 规则复用当前已审核材料和真实授权；只读能力查询可先做。准备中若需要新设计/提示，先由 Director 确保相关需求已知或有明确角色/范围/约束委托，不由入口临时编造。仅问当前必要缺口，意外问题仅暂停受影响工作。 按选定模型/参数提交，不要求预算、费用、积分/余额或最低价检查，不为省钱降级。用户实际费用限制仍绑定，真实账号/provider 失败仍报告。constraints 不必含费用；范围、覆盖、首次/重试、inflight 和独立视频授权保持不变。 用户决策前必读 `${CLAUDE_PLUGIN_ROOT}/skills/_meta/rules/user-decision-relay.md`。发起角色一次提供全部相关问题及题界/分支；主 AI 读全并内部保留计划，沿作者题界完整展示当前题全部选项/解释再原生单题询问，不用摘要或按钮替代正文、不倾倒全表。仅应用所给条件；相关原始答复及全部条件批量完整回原角色原任务，不逐题往返，提前回询仅限共享规则例外；创作事项保留 Director 协调且 relay 不压缩。 配置读取/准备/写入/evidence 前，从项目根运行 `node "${CLAUDE_PLUGIN_ROOT}/scripts/review-evidence.mjs" config-path`，得到 SVD_CONFIG（未设才 config.md）的 canonical 项目相对 config_path。项目内绝对路径与 ./ 可规范化；外部配置（含 symlink 越界）不支持，在副作用前报告，不自动复制。查看配置只读此路径，缺失不初始化。 每次配置相关 Bash 显式用 `SVD_CONFIG="{config_path}"`，包括 video-task-inputs 的 profile/capture/gate/reserve、review-evidence check 和生成 wrapper；需要位置配置参数的 helper 也传同一路径。所有 Task/relay、配置/approval 写入与 fingerprint 使用 config_path，不能读取默认配置后对另一文件取证。纯已登记任务取回转 checker，不运行 profile 或配置门禁。 - 新提交由真实 Creator Task 使用已接入 scripts 执行；加载 provider skill 不转移角色。禁止测试性付费调用。 - tasks.json 保持数组，由用户交互上下文维护准备和授权，按 task_id 唯一并保存完整 shots。提交状态仅由 wrapper 的 reserve/settle 写入，LLM 不重复写回。不得与提交脚本并发编辑 tasks；发现 `.submit-lock` 或 inflight 先停止准备并核实，不删除绕过。 - 预登记后 creator 不改 prompt/references/duration/submission；submitted/done 及 inflight 保护。 - 用户本次实际视频生成请求就是该范围首次提交依据，不需要另一条同意消息；材料就绪或 review pass 本身不是视频请求。failed 状态不产生重试或修改授权。 - 对请求范围内首次提交的 prepared pending，持久化 `initial_authorization:{decision,episode,task_id,shots,constraints}`：decision 保留实际生成请求原文及澄清；episode/task_id/shots 精确绑定整个任务，constraints 保留真实条件，无额外条件可为 []。当前 manifest 成员必须等于 record 和 grant；错误身份、成员/输入漂移或部分选组在 reserve/付费前阻塞，零调用且不改次数。无生成请求不造 grant，初始 grant 不允许失败重提，retry grant 不能替代它。 - 不在首次提交前例行询问重试许可；仅用户要求自动重试，或实际失败阻塞且需用户决定时处理。按 check-video 的格式保存真实 `retry_authorization`、decision/scope/constraints；仅用户给出次数时写 max_attempts/attempts，不从生成请求推断无限重试。拒绝/无 grant 不重试，不阻止首次提交。监控同样仅用户要求或已有同意默认才启动。 - 重跑准备不得重置已有 grant 的次数；输入/范围变化时不自动继承旧 grant，先核对真实授权是否明确覆盖该变化及重准备/重提，未覆盖才取得新决定。原输入重试许可不授权改输入。符合授权时按当前目标保留真实决定与剩余限制，不伪造新许可。submitted/done 保持保护，撤销授权可单独清除 grant，不改输入或状态。 ## 系列继承与单集规格 任何准备写入（含 converter 字段、状态、grant）前，先运行只读命令： ```bash SVD_CONFIG="{config_path}" node "${CLAUDE_PLUGIN_ROOT}/scripts/video-task-inputs.mjs" profile "story/episodes/{ep}/videos/tasks.json" ``` 使用实际 `SVD_CONFIG` 或 `config.md` 检测 mode、读取固定值与参数选择授权；目标 tasks/目录尚不存在也可检查，不创建文件。非零停止，不改记录、不付费。JSON 返回 `{mode,profile,source}`：series 的 source=`tasks` 表示继承完整四元组，source=`config` 表示首次选择，profile 中 null 字段仅限已有明确 video delegation，须由 Creator 在授权内解析；short 返回 profile=null、source=`episode`，仍须核对整集 ratio/resolution。 series 全系列所有集共用 `provider/model/ratio/resolution`。扫描所有 canonical `story/episodes/epNN/videos/tasks.json`，不限前集或本次 shots；一致的已准备快照优先，即使尚无前集任务，也继承其他集或本任务已有快照。包含 prepared pending、submitted/done/failed 和 inflight；只忽略无 submission、无 submit_id、无 inflight 的全新 pending。任何历史四元组缺失或冲突阻止新准备/付费，不阻止查询下载，不能猜默认、补造历史或删除快照重新选型。sole pending 自身快照也绑定，不能借重准备换型。 继承仅限四项设置，不继承 duration、prompt、images/refs 或 grants。无任何快照时才从实际固定配置和明确委托解析；固定配置与继承冲突或 provider=none 时停止，不静默覆盖。按系列串行执行 profile 检查、准备写入和提交，不并发准备不同集；现有 episode `.submit-lock` 不是跨集事务，不保证跨集原子更新。 short 模式同集全部生成任务共用 `resolution + ratio`，不设逐镜清晰度。Creator 读取整集 tasks（不限本次范围），在明确委托内解析公共规格，固定值仍绑定；已有 pending/submitted/done/failed 的 submission 约束新任务。仅 short 不要求各生成任务 provider/model 相等，所选能力仍须支持公共规格。 short 准备写入前核对整集；历史缺少 ratio/resolution 时阻止新生成，不猜测或补造，查询下载不受影响。仅 short 获准重准备的 pending 可在不与其他任务冲突时换规格；保护任务不可改写。capture 与 gate/reserve 在本集 `.submit-lock` 内按 mode 复核整集或全系列，拒绝时不写 tasks、不消耗重试次数、不调用提供方。capture 只返回快照，reserve 在付费前再次核对，但不建立全系列锁。 这些参数保证请求的分辨率档位与比例一致，不保证精确像素几何或主观清晰度；不自动转码、缩放或转换，不增加 codec/AI 质量审核。 ## 流程 单次请求上下文仅为最终 prompt 与实际 typed references，遵循共享 visual-prompt-craft-common/video 和必读 [shot-inputs](../_meta/rules/shot-inputs.md)。准备时核对转换结果，不以读过剧本补齐模型缺口；创作缺口交 Director/Storyboarder，入口忠实保存。 Creator 在摄影设计后将连续 shots 装组，保留时长、对白及切点。核实模型最大时长 M，以 `ceil(0.7*M)..M` 为语义装组目标而非机械下限；实际 provider 时长边界（含硬上限）用于任务。装组/提交操作中不延长 shot、场景或整集；无法合理装组交 Director 协调 owner，按原始确认集预算修订 canonical script/storyboard、同步受影响下游并取得当前相关审核后返回准备。该修订可在原始边界内净增，不扩大边界或绕过真实 grants、输入一致性及受保护记录。 Materials 将各成员完全相同的单行 `视频风格` 提取一次，仅从成员移除该字段；不一致交 owner。内部源标题、其余字段、对白、空格、续行及 prose 保留并绑定声明引用；仅行首结构 cue 按派生 offset 重基，校验镜内范围且允许合理重叠。Creator 据材料写最终任务时间 prose、统一媒体参考时钟/内部切点/声音衔接；仅清理非成片源标题、内部 shot/task IDs、路径和审核元数据，保留叙事/动作、对白及有意上屏的准确原词。按 [转场与片中文字](../_meta/rules/transition-craft.md) 区分正式文字与内部预览标注，clean MP4 可含正式卡片/UI/SUPER，不额外增加装组时长，也不承诺模型文字准确性。 准备使用已审最终 `task-inputs/taskNN.json` 的 `{shots,references,prompt}`，prompt 为 Creator 在审核前据源、所选 provider 的材料工具及实际 refs 编写的非空白语义字符串；`{shots,references}` 草稿仅供该 provider 材料准备，不通过最终审核/就绪。工具/pack/引用语法见所选 provider 文档，Dreamina 见 [video.md](../creator-provider-dreamina/video.md#dreamina-authoring-materials)。task_id 来自文件名且独立于首镜；通用 converter 两入口使用 `--json STORYBOARD TASK_ID EP`，返回 `{task_id,shots,timeline:[{shot,start,end}],prompt,duration,references,assetCards,sources,inputPath}`，prompt 原样来自 manifest，不生成或重写。不维护第二份装组索引或可编辑 offset/duration。Header 身份图按首次使用求并集后接本地 PNG/MP4，每任务至少一个全组时间线 MP4；静态段可用静态 clip。每镜链接须自身 header 声明，sources 不上传。 源结构边界仍为 shot heading 后的下一个 ATX heading、独立 `---`、行首 HTML comment 或 EOF。作者将下一场景/预算及制作说明放在边界外；所选 provider 材料工具负责自身引用绑定和时间表达，供 Creator/Reviewer 对照源核对。缺源事实交 owner，不编造 use；最终 `--json` 仅原样返回 manifest.prompt，不拼接源文字。 Creator 在参考视频/装组映射完成后写最终 prompt，自查实际 `--json` 后由 fresh shot-input Reviewer 验收源忠实度、完整性和集成；manifest target 指纹绑定 prompt。准备把原文存入 tasks.json，保留 submission 快照。付费 gate/reserve 比较最终 manifest 的 prompt/references/duration，不比较源拼接文字或在提交时追加/重写。要求 typed references 与本地 MP4；漂移阻止提交，恢复/重试不静默刷新。submitted 按已登记 ID/provider 取回，submitted/done/inflight 保护不变。 以下准备依赖只适用于获准的新/重新准备任务。任何 tasks 写入前完成目标与授权核对、只读 profile 预检，并把结果与实际 config 路径委托 Creator；source=tasks 时只验证继承设置的能力，不重新选择。能力诊断先于 capture 和付费，不是写完任务后再选。已有 prepared/pending 续交或 failed 原输入重试只验证持久设置，不重新 resolve/capture。实际配置用 SVD_CONFIG 或 config.md；提供方 none 阻止新提交，不阻止查询。 1. 整体理解原始请求 `$ARGUMENTS` 和会话中的集数、镜头、文件参考与提交意图。查看配置只 Read 实际配置（SVD_CONFIG 或 config.md），缺失不初始化。写入/付费前确定 canonical ep 与 exact shots；只有明确全范围才选全部，遗漏或歧义先澄清，不默认 latest/all。读取对应 config/storyboard；路径或审核通过不等于付费授权。 2. 按真实状态区分准备/提交与取回，submitted 缺 ID 或 inflight 未决先人工核实。下述完整就绪检查包含结构检查；只诊断结构时可单独运行 `check-shot-inputs.mjs EP [SHOT...]`。 3. 以严格 heading `### shot N` 精确匹配所选镜头。整集要求 1..N 且每镜恰好分配一次，任务按首成员排序；局部源允许缺号但递增唯一、目标存在且选择完整组。全局校验声明组重叠和缺失源成员，局部不要求未选媒体或完整全片计划。未分配目标或部分选组报告 task_id、完整成员及需额外选择的镜头，不静默扩大授权。 4. 确认目标 task manifest 已由 Creator 在授权内组装，最终包已有独立 shot-input 审核，或用户明确要求且已依法签录[单任务人工视觉例外](../_meta/rules/shot-input-visual-exception.md)。例外不代替本入口真实生成授权，不自动创建/续期。执行 `SVD_CONFIG="{config_path}" node "${CLAUDE_PLUGIN_ROOT}/scripts/review-evidence.mjs" check "{ep}" {全部所选成员编号}`，非零停止，不自动重生。例外接受时原独立 unknown 和 `user_visual_exception` 接受依据同时输出，以实际 exit code 判断就绪，不能声称独立 pass。通过后调用 `storyboard-to-prompt.sh --json "{storyboard}" "{task_id}" "{ep}"`（.mjs 同参数），失败不写半成品；保存 task_id/shots 及原样 prompt/duration/references，不把 resolver 元数据塞入上传数组。 5. 核对本地 reference/sources 路径，每任务至少一个全组 MP4，可辅以 PNG；sources 只作审核输入。最终就绪要求 script/storyboard/asset-visual/shot-input；新生图另须 asset-prompt。独立 reviewer 检查最终集成、内部切点/声音桥和必要外部边界，按实际依赖取指纹；机械就绪不证明穷尽连续性。 6. 预登记到 `story/episodes/{ep}/videos/tasks.json`： - 为请求内首次提交的 prepared pending 按上述格式登记实际请求的 initial_authorization；与 capture 得到的 submission 一起在提交前保存。不得省略 grant 而指望 wrapper 从聊天推断许可，也不为已有 protected 或范围外任务造记录。 - 不存在：新增 `{task_id,shots,submit_id:"",status:"pending",prompt,references,duration,fail_reason:""}`，输出为 `story/episodes/{ep}/videos/taskNN.mp4`。 - `pending`：仅在无 inflight 且授权准备范围内刷新 converter 输入字段；单纯恢复保留已有字段与 submission。 - `failed`：默认完整保留；仅真实授权重准备、接受当前材料且授权重提时才刷新输入并改 pending，不静默刷新失败输入。 - `submitted` / `done` 或任何 inflight：完全保护，不刷新、不自动重提；若 converter 已变化只输出人工处理警告。不得将 unresolved intent 改 pending 来重新准备。 7. 使用 Creator 已验证的设置，series 四元组共用，short ratio/resolution 整集共用；验证 operation/duration/references。获准 pending 执行 `SVD_CONFIG="{config_path}" node "${CLAUDE_PLUGIN_ROOT}/scripts/video-task-inputs.mjs" capture "{tasks}" "{task_id}" "{provider}" "{model}" "{ratio}" "{resolution}"`。把返回的 `{provider,model,ratio,resolution,references:[{media,path,sha256}]}` 存为 submission；helper 只返回，sources 不在 submission。失败不提交；写前重读锁/inflight/submitted/done。 8. 主 AI 按首成员源顺序将已 capture 的授权 pending 交真实 Creator Task，传提交成果、tasks/材料路径、生成 task_id/完整 shots、config_path、实际 grants 和约束。Creator 按当前 provider 知识及持久 submission 执行。若请求来自真实受托子任务且嵌套不可用，该子任务返回 role/outcome/references/scope/constraints，主 AI 派 sibling Creator 后将实际结果送回原请求任务。本地入口由主 AI 直接继续；主 AI 无法派发所需角色时报告阻塞，保留任务状态，不冒充 Creator 执行。 9. 只有明确请求或已同意的监控默认才进入 auto-video，传 resolved target 与 unattended 意图及间隔；否则返回提交结果，不自动装监控。监控同意不创建重试授权。 `视频提供方` 为 none 时不提交，可询问配置或取消；已有任务仍可取回。固定配置绑定其范围，缺值不授权选择，任务选择不改项目默认。重试/恢复已有 prepared 记录不重新 resolve/capture。最终报告新增、刷新、保护、提交、失败与未决项。 Converter 的执行字段为 prompt/references/duration；准备及付费尝试使用 typed references 和 `--references-json`，每任务至少一个全组本地 MP4。交接携带 task_id 和完整 shots；报告计数以生成任务为单位，human_needed 为 `{ep,task_id,shots,reason}`。submitted 按 recorded ID/provider 取回，保留状态/授权。接口不满足契约交主 AI/general，不能绕过。