电影短片制作流程
根据想法或剧本创建一个可供审查的制作包。此技能仅用于规划与验证；不授权生成图像、音频、3D模型、渲染或视频。仅在无法推断重要创意或技术决策时提问。尊重明确的制作授权和目标项目的指示。
流程与审批关卡
| 阶段 | 输入 | 可审查输出 | 批准前进条件 |
|---|---|---|---|
| 任务委托 | 想法、剧本或请求 | 包含受众、格式、时长、语言、基调、限制与交付物的简报；标注未知项 | 基本要求齐全；事实与限制已理解 |
| 故事 | 已批准的简报 | 主题句、目标、障碍、风险、节拍、转折与结局 | 因果关系清晰；事实与虚构分离；无阻碍性叙事决策 |
| 美学与资源 | 已批准的故事 | 风格表、角色/环境标准、候选资源列表 | 风格一致；每个使用的资源均有已验证的来源/许可/格式/骨架，或被标记为待定且不包含在已批准的计划中 |
| 故事板 | 已批准的故事与指导 | 每个镜头的JSON；可选块 cinematography 和 animation 描述按节拍的摄影机/灯光与表演 | 验证器通过；焦点/剪切意图以及节拍/连续性已审查。静止9:16和序列有各自的关卡；未验证的骨架不能批准用于制作 |
| 技术方案 | 已批准的故事板 | 引擎与版本、资源/许可、动画、声音/字幕、配置文件与预计成本/限制 | 本地路径可行；依赖项和资源度量明确；无隐藏的关键不确定性 |
| 质量控制 | 之前的完整包 | 带有证据的评分标准，自动结果，视觉审查与人工评估分开 | 所有错误均已修正或明确接受；列出阻塞项；未执行检查不宣称通过 |
不要跳过失败的关卡。一个计划、预览、帧、旁白或渲染不授权进入下一制作阶段。
对于每个故事板，执行 python scripts/validate-storyboard.py path/to/storyboard.json。validate-skill.py 也验证所有 examples/**/storyboard.json 和 templates/storyboard.json 的结构和时间线，重用故事板验证器。要审查完整技能，执行 python scripts/validate-skill.py . 和 python -m unittest discover -s tests -v。
项目可以版本化一个 pipeline.json，其中 pipeline_version: 1，独立于故事板。使用 python scripts/pipeline.py validate path/to/pipeline.json 验证；使用 plan 或 dry-run 检查DAG而不执行或写入；使用 validate-manifest pipeline.json run-manifest.json 验证现有清单。编辑该合同前请查阅 references/pipeline-orchestration.md。
字幕使用区间 [start_ms, end_ms)：默认拒绝重叠。如果故意重叠，需要在后开始的字幕中包含非空的 overlap_exception 并记录理由。
为了关联声音与镜头，narrative_timing 在 schema_version: 1 中是可选的：将时钟标记为估算值或已录制值，并标注节拍、暂停和剪切，通过场景引用的锚点。使用真实录音时，以其时长作为时钟并重新审查字幕。锚点不证明同步性；没有对齐器或手动审查的证据，不要声明逐字对齐。
将新包保存到 deliverables/<slug>/ 中，包含一个brief/plan和 storyboard.json。使用稳定的slug并保留现有交付物；创建新包时不要移动或覆盖旧包。
能力状态
已实现：规划指南、可选的摄影与动画合约、定性评分标准、本地DAG规划器以及流水线/清单合约验证。pipeline.py plan 和 dry-run 显示图形但不执行阶段或创建文件。故事板验证检查结构性和声明的时间线；不验证摄影机、表演、骨架的存在性/兼容性或视觉质量。清单验证器检查状态、完整性校验和和输出，但不创建或恢复执行。
视听阶段及其适配器仍待实现。无媒体生成、渲染引擎、TTS适配器、合成、时间性视听QA或法律扫描器。基准测试结果、资产可用性、许可、工具和兼容性按任务验证。
本地上下文
在 VideoIA 工作时，首先阅读 AGENTS.md 和相关的本地指令。已知的参考环境为 Windows 11、GTX 1650 4GB、16GB RAM、本地 Blender、Remotion/React/Three.js/R3F、FFmpeg、Kokoro TTS 以及可选的 CC0 资源包。这是上下文，不保证二进制文件、模型、包、许可或版本仍然安装。优先考虑本地/免费流程和适度预览；在使用框架模式前验证活跃版本。
重用已安装的 Remotion 技能，而不是复制其手册。仅当任务需要时查阅最佳实践、标记、3D、字幕、Studio 或渲染指南。渲染需要明确请求。未经授权，不要安装依赖项、下载资源、使用付费服务、发布或修改他人项目。
使用电影质量评分标准来分离自动验证、静止帧检查和人工判断。静止图像不能证明动画的时间质量。
资源
- 叙事: references/storytelling.md
- 视觉识别: references/art-direction.md
- 镜头设计: references/cinematography.md
- 角色、环境与动画: references/animation-3d.md
- Remotion/R3F 集成: references/remotion-integration.md
- TTS、音频与字幕: references/voice-and-captions.md
- 审查关卡: references/quality-control.md
- 电影质量评分标准: references/cinematic-quality-rubric.md
- 流水线架构与使用: references/pipeline-orchestration.md
- 流水线安全与可重复验证: references/pipeline-security.md
- 来源审计: docs/sources.md
- 候选技能: docs/skill-candidates.md
- 本地发现: docs/lessons-learned.md
- 初始提示: docs/prompt-library.md
- 待办事项: docs/roadmap.md
- Codex 本地发现: docs/codex-discovery.md