结构化视频生产工作流
目标
把“做一个视频”转换为一组有唯一事实源、明确人工门禁和确定性检查的阶段。质量来自前置设计和验证，不来自后期堆动画。
本技能只提供方法、契约和检查工具。它不携带视觉资产、字体、音效、音乐、动效实现、历史项目或账号专属风格。
首次使用
- 先读取 工作流与门禁。
- 需要建立新项目时，读取 项目契约，再运行：
text
python scripts/init_project.py --project <项目目录> --name <项目名称>
- 每次准备跨门禁前运行：
text
python scripts/validate_project.py --project <项目目录> --gate <0-10>
- 准备公开发布本技能包时运行：
text
python scripts/audit_public_package.py --package <技能目录>
执行原则
- 先服从当前工作区的权威规则，再使用本技能。
- 未经用户明确同意，不创建隔离工作树，不上传文件，不发布仓库，不调用付费生成服务。
- 先核验输入文件、媒体参数、时间范围、处理权利、可用工具、模型、预算和运行条件，不自行补全未知事实。
- 原始口播或已冻结文案是时间与语义基线。除非用户明确批准，不重写、增删、重排、拉伸或压缩口播。
- 动态事实只保存在一个导演计划中。节拍表、分镜、素材表和实现表是派生视图，不得形成第二套冲突时间线。
- 时间区间统一使用半开帧区间
[start_frame, end_frame_exclusive)。 - 每个镜头只设一个主视觉任务、一个主要动作路径和一个明确的观众理解点。
- 先关键静帧，再写代码前动态分镜，最后才进入正式实现。
- 确定性检查先于主观审美判断；最终视觉、听感、预算和破坏性清理由用户裁决。
- 新版本使用新文件名，不覆盖已验收基线。
标准流程
一、接管与分类
- 判断是全新项目、已有项目续做，还是历史项目迁移。
- 已有项目只执行当前状态声明的开放任务和受影响检查，不重跑已冻结阶段。
- 历史证据缺失时登记缺口，不补造过去的设计或批准记录。
二、冻结输入
- 记录源文件路径、大小、内容指纹、媒体参数和权利确认。
- 明确平台、画幅、分辨率、帧率、目标时长、字幕、真人、裁切、画中画、音效、音乐、封面和交付范围。
- 明确成功标准、禁用项、复杂度预算和人工批准人。
- 未通过门禁零，不进入内容制作。
三、建立语义与导演计划
- 生成或核验带时间戳逐字稿。
- 按语义事件拆分，不按字幕行或句号机械拆分。
- 标记内容功能、情绪变化、关键词、转折、证据、动作触发和可删减候选。
- 以语义密度、持续时间和视觉变化需求形成宏观节拍、微观镜头及连续时间轴。
- 每个镜头填写主视觉任务、构图、屏幕文字、动作四阶段、素材接口、声音接口、连续性和验收点。
- 详细规则见 时间与导演合同。
四、视觉与资产路由
- 从主题、时代、语气、受众和内容功能选择视觉方向，不默认套用账号风格。
- 先检索用户已授权资产，再决定复用、程序化生成、图像生成、实拍/录屏或占位方案。
- 所有真实资产登记来源、权利状态、用途、裁切、展示尺寸和替代方案。
- 不存在私人资产提供器时，只创建清单和占位，不伪造素材。
- 详细规则见 视觉与资产路由。
五、两次前置视觉验证
- 关键帧：覆盖开场、核心观点、证据、转折和结尾等关键状态。
- 第一次人工门禁：用户确认节拍、视觉方向、关键帧和预算后，才进入昂贵生成或正式实现。
- 动态分镜：用口播、占位运动和时间脚本验证节奏、构图、字幕、安全区、切换和同步。
- 第二次人工门禁：用户确认连续观看结果后，才冻结实现合同。
六、实现器交接
- 选择实际可用的实现器；本技能不绑定某个框架或生成模型。
- 冻结构图标识、宽高、帧率、总帧数、镜头区间、素材路径、音轨策略和检查点。
- 实现器必须直接消费冻结计划，不能重新解释镜头边界或改写口播时间。
- 私人素材库、账号动效或渲染组件只能通过外部适配器接入，见 私有适配器合同。
七、视觉、音频与交付
- 先做类型、时间轴、素材存在性、代表帧、字幕溢出、安全区和黑帧等确定性检查。
- 再做整片连续预览，由用户裁决视觉方向。
- 音频按“原口播基线—短音效决定—背景音乐决定—最终试听”处理；未知权利风险必须如实登记。
- 渲染后核验容器、编解码、轨道、时长、帧率、分辨率、音频和可播放性。
- 详细规则见 渲染、音频与质量检查。
八、复盘与收工
- 每个缺陷记录现象、错误假设、根因、修正和验证证据。
- 将结论分为通用规则、项目专用例外、自动检查或一次性结论。
- 清理前生成精确清单；只有已声明临时文件可自动删除，其他删除必须取得用户明确确认。
- 项目资产是否晋升共享由用户逐项决定，不因“可能复用”而自动公开。
人工门禁
涉及下列任一事项时必须停下等待用户确认：
- 目标、范围、口播内容或时间轴改变；
- 视觉方向、关键帧或动态分镜定稿；
- 付费生成调用、预算增加或批量重试；
- 新增、替换或移除音乐与重要音效；
- 最终视觉和最终听感；
- 上传、发布、共享晋升、覆盖验收基线或删除非临时文件。
门禁记录格式和重试边界见 人工批准与重试。
失败处理
- 缺输入：停在当前门禁，列出缺失事实和它们影响的决定。
- 工具不可用：保留中间契约，换实现器或转人工，不降低验收标准。
- 生成失败：先判定是提示、输入、模型、网络还是配额问题；只在批准预算内受控重试。
- 计划与成片冲突：以冻结导演计划为准；若计划本身需改，增加修订号并重新批准受影响门禁。
- 既有项目证据不全：标记“历史等效完成，证据缺口已登记”，不得伪造证据。
按需读取
- 全流程和门禁：
references/workflow.md - 项目目录、状态和文件契约：
references/project-contract.md - 语义、节拍、镜头和帧区间：
references/timing-and-director.md - 视觉选择、字幕、安全区和资产路由：
references/visual-and-assets.md - 实现、音频、渲染、交付和质量检查：
references/render-audio-qa.md - 人工批准、预算和重试：
references/human-gates-and-retries.md - 私有素材与实现器的隔离接口：
references/private-adapter-contract.md - 公开包允许和禁止包含的内容：
references/public-package-boundary.md
