用途：为当前项目创建或管理短视频片段，如产品演示、营销短片、电影感镜头、UI 模拟。默认使用 sora-2 模型，采用结构化提示词增强流程，优先使用内置 CLI 以保证可复现运行。注意：$sora 是提示词中的技能标签，不是 shell 命令。
主要能力：根据提示词生成新视频；按 ID 重混已有视频；轮询状态、列出任务、下载素材（视频/缩略图/精灵图）；批量运行（多提示词或多变体）。决策逻辑：有视频 ID 且要修改则重混；有 ID 且要状态或素材则查询/下载；需要多提示词或素材则批量创建；需要同一镜头的小改动两版则先创建基础版再重混；否则创建（或创建并轮询一步到位）。
使用方式：先确定意图，收集提示词、模型、尺寸、秒数和参考图；批量时在 tmp/ 下写临时 JSONL（每行一个任务），运行一次后删除。优先使用 CLI 增强标志（--use-case、--scene、--camera 等），若已有结构化提示词文件则加 --no-augment 避免重复包装。长提示词用 --prompt-file 避免 shell 转义问题。异步任务需轮询至完成，或使用 create-and-poll。下载素材并保存本地，清理中间文件。
认证：实时 API 调用必须设置 OPENAI_API_KEY。缺失时引导用户在 https://platform.openai.com/api-keys 创建密钥并在本地设置环境变量，切勿让用户在聊天中粘贴完整密钥。
默认与规则：默认模型 sora-2（sora-2-pro 更高保真）；默认尺寸 1280x720；默认 4 秒（允许 "4"、"8"、"12" 字符串）。尺寸和秒数必须通过 API 参数设置。使用 OpenAI Python SDK，不用原始 HTTP。参考图须为 jpg/png/webp 且匹配目标尺寸。下载 URL 约 1 小时后过期，需转存自有存储。除非用户要求，不要修改 scripts/sora.py。
API 限制：模型仅限 sora-2 和 sora-2-pro；需组织验证账户；时长仅 4/8/12 秒且以字符串枚举传入；输出尺寸受模型限制；创建为异步需轮询；速率限制按使用层级；内容限制由 API 执行。
护栏：仅限适合 18 岁以下受众的内容；禁止版权角色或音乐；禁止真实人物（含公众人物）；含人脸的输入图会被拒绝。
提示词增强：将提示词改写为结构化生产规格，仅显式化隐含细节，不虚构新创意要求。模板含用例、主要请求、场景、主体、动作、相机、灯光/氛围、色板、风格、节奏、音频、文字、对话、约束、避免项。重混时明确列出不变量。若关键细节缺失阻碍成功则提问，否则继续。
最佳实践：每镜头一个主动作加一个相机运动；用计数或节拍控制时间；UI 或屏幕文字保持简短并锁定相机；出现伪影时加简短避免行；短提示更创意，长提示更可控；对话放独立块且行短；重混明确不变量；单变量迭代保持连续性。
参考文件：references/cli.md（CLI 命令）、video-api.md（API 参数）、prompting.md（提示结构）、sample-prompts.md（示例）、cinematic-shots.md（电影镜头模板）、social-ads.md（社交广告模板）、troubleshooting.md（排错）、codex-network.md（网络/审批排错）。