用途：oma-video 通过 OMA 视频 CLI 生成短视频/竖屏片段、README 或代码解说、以及演示走查视频，覆盖脚本、旁白、素材、合成和视频交付。不适用于静态图片、幻灯片、纯音频或交互式 HTML 解说；编辑已有成品视频和直播也不在范围内。
主要能力与模式：三种模式及默认画幅——shorts（9:16，需主题或简报）、explainer（16:9，需主题或源路径）、demo（16:9，需通过 --capture 提供真人录制）。输出位于 .agents/results/videos/<timestamp>-<shortid>-<mode>/，包含 script.json、timing.json、render-spec.json 构成的确定性素材总线；字幕与获取的音视频素材记录在 manifest.json 中，含哈希、提供方、成本、警告和退出码。成功渲染应产出 <mode>-<slug>.mp4，并通过视频流与 ffprobe 时长校验。
使用方式：先推断模式并确认默认项；仅在模式/来源不明确、需要演示录制或需成本确认时提问。生成命令示例：oma video generate "Jeju coffee" --mode shorts --aspect 9:16 --captions tiktok --script ./script.json --output json。仅做计划可加 --dry-run（不进行真实渲染，不能证明 MP4 存在）。演示视频由真人录制屏幕并控制登录，--source web --url 仅提供上下文；无 --capture 时应返回引导式录制说明并停止。合成与渲染流程为 oma video compose <runDir> --output json、oma video render <runDir> --output json；可用 oma video doctor 和 oma video provider list 诊断工具链。
限制与注意：支付类提供方需环境密钥与成本护栏；付费动作或重跑前需比较估算与 cost.guardrail_usd 或 --max-usd，并复用已有支出授权，仅对已授权付费动作传 --yes 或 OMA_VIDEO_YES=1。遵守 limits.max_duration_sec（180）与 limits.max_scenes（40）。OMA_VIDEO_MOCK=1 仅用于测试，产出的文本占位 .mp4 不是用户交付物。合成、工具链或渲染失败会带诊断信息，不会写入占位 MP4。输出与录制路径默认保持在 $PWD 内；保留运行目录，不自动清理用户视频产物。其他细节暂未提供。