Akira Video
akira-video 是 Akira Video Skills 的主要路由 Skill。它负责视频制作入口、VIDEO.md 的维护、当前制作任务的判断、专业 Skill 路由以及停止边界的定义;具体的视频脚本、复用素材、镜头、生成包、审片和整片后期方法由对应的专业 Skill 负责。完整项目的依赖与人机交接遵循 references/workflow/PRODUCTION-FLOW.md;对于已有项目,直接从当前实际工作继续,不机械地重跑上游步骤。
整个制作过程始终优先保护以下约束(优先级从高到低):用户与来源事实 → 剧情/镜头意图(适用时)→ 人物/物体身份与结构 → 产品事实(广告时)→ 空间与时间连续性 → 画面美感 → 炫技。具体的层级、冲突回查以及“采用结果实际出口”等例外情况按 references/workflow/AUTHORITY.md 处理;后面的目标不能以破坏前面的约束为代价。
1. 进入或接管项目
首先读取项目根目录的 VIDEO.md。如果文件不存在,则按 references/project/PROJECT-LAYOUT.md 建立最小视频项目;项目定义与当前状态按 references/project/VIDEO-HOME.md,命名按 references/project/NAMING.md。只创建当前真实需要的目录和文件,不预先生成空分类;第一次需要生成一次性生成包时,再确保目标项目的 .gitignore 忽略 .tmp/ 目录。
如果用户已经提供了现成的图片、视频、音频、粗剪或参考成片,先按 references/project/IMPORT-MEDIA.md 判断它在当前项目中的真实用途;可直接复用的成果不强制重走设计或生成流程。
然后,根据当前任务读取最小必要内容:
- 视频脚本与镜头总览:
video/script/; - 跨镜头复用内容:
video/materials/; - 当前镜头:
video/shots/<shot-id>/; - 已进入整片后期时:
video/edit/; - 上游小说、章节、品牌资料或其他来源:沿当前项目的真实 pointer 读取,不复制成第二份上游事实源。
完成标准:能够说明当前视频目标、交付要求、正在推进的制作内容、已有的可复用素材、当前镜头/后期状态以及真实的阻塞项。
在进入下一项昂贵制作之前,按 references/workflow/PRODUCTION-GATES.md 只运行当前项目适用的轻量门禁;门禁不产生额外的项目状态文件。如果当前项目已经大到平铺影响阅读,或者确实需要同时比较创意版本,再读取 references/project/SCALING-VERSIONS.md,不要预设长片目录。需要清理失败结果、一次性生成包、缓存或旧媒体时,按 references/project/MEDIA-LIFECYCLE.md 先确认该文件不是唯一的输入、当前采用的结果,或者后期工程的唯一依赖。
重要的制作决定如何落盘、VIDEO.md 何时更新、镜头采用结果为何只写入 SHOT.md,参见 references/project/RECORDING.md;聊天历史和一次性生成包都不是长期的项目记录。
2. 维护 VIDEO.md
VIDEO.md 是供人和下一位 Agent 直接阅读的视频制作首页,只保存当前仍有用的信息。固定关注以下内容:
- 项目与视频目标;
- 交付要求;
- 当前制作进度;
- 当前正在推进的工作;
- 阻塞项;
- 仍然影响后续的关键决定;
- 指向视频脚本、复用素材、镜头和整片后期的导航。
普通的提示词历史、所有的生成结果、生成日志以及已经被 Git 历史取代的旧决定,不进入 VIDEO.md。
详细写法见 references/project/VIDEO-HOME.md。
3. 路由专业工作
根据用户的当前目标和已有的项目内容,选择下一项实际制作工作。完整的项目不要求机械地经过所有能力;已经有脚本时可以直接进入镜头,已经有镜头与素材时可以直接准备生成包,返回生成结果后直接进入审片。
根据当前任务加载对应的 Skill:
- 从小说、章节、brief 或其他上游内容形成/修订视频脚本、人物表演、场景或镜头总览 → 使用
video-script; - 角色或场景只有功能描述,尚未形成具体的外形/服装/材质/空间/光线设计 → 使用
video-design; - 角色需要跨镜头稳定的音色、声音参考,或者项目需要规划对白声音、环境声、音效与整片声音边界 → 使用
video-audio; - 规划或维护跨镜头复用的人物、场景、道具、产品提示词与参考素材 → 使用
video-materials; - 将镜头总览展开成
SHOT.md,处理动作、摄影、声音与相邻镜头的连续性 → 使用video-shot; - 编写当前生成的提示词、选择最小参考集、整理一次性生成包、导回用户生成结果 → 使用
video-generation; - 用户带回图片或生成结果后判断是否采用、调整后续、后期修复、重生成或重写 → 使用
video-review; - 多个采用镜头进入 Premiere Pro、After Effects、DaVinci Resolve 等整片后期 → 使用
video-editing; - 同一视频需要多语言字幕、旁白、配音或正式成片版本 → 先读取
references/workflow/LOCALIZATION.md,翻译内容交给video-script,声音交给video-audio,字幕/图文/最终导出交给video-editing,不复制整套项目; - 品牌、产品植入或广告需要核验产品功能、结构、官方素材与广告表达边界 → 按需加载可选 Skill
video-advertising;若当前 Target 未安装,则使用明确的协调标识akira-tl/akira-video-skills/video-advertising,交给akiraRouter / Skiloom 生成候选计划(Candidate plan)并在授权后安装。
Router 只保存上述职责摘要;进入任一分支后,以实际加载的权威 Skill 为该专业方法的唯一权威来源。
若目标需要视频模型的专用适配,先读取 references/workflow/MODEL-ADAPTERS.md 选择当前仓库已有的最小适配 Package;若尚未安装,则将明确的协调标识交给 akira Router / Skiloom 正常生成候选计划(Candidate plan)并安装。不要将模型参数或供应商细节硬编码进 akira-video。图片生图目前使用 video-design + video-materials 的通用规则,不单独维护图片模型适配器。
若外部生成任务已交给用户,需要跨会话等待时,按 references/workflow/WAITING-RESUME.md 在 VIDEO.md 中只记录生成包路径、预期返回、下一步和真实的阻塞项;下一轮优先恢复现有的包/返回结果,不因换会话而重复打包。
4. 外部生成的人机边界
默认允许用户在外部图片/视频模型中完成实际生成。当需要外部生成时,专业生成 Skill 从正式项目内容中整理出一个一次性生成包:
正式项目内容 → .tmp/ 一次性生成包 → 用户外部生成 → 结果返回 → 归档正式目录 → 删除临时包。
一次性生成包是派生产物,不作为长期项目的事实源;长期提示词保留在对应的归属素材或镜头目录中,临时包只复制当前生成真正需要的内容。
5. 重新路由与停止边界
每次专业 Skill 完成一个有明确边界的动作后:
- 将返回的正式素材、生成结果、镜头决定或整片工程归档到对应的归属目录;
- 更新仍然影响当前制作的
VIDEO.md; - 根据用户目标和当前产物决定下一项制作工作。
只有在以下情况下停止:用户限定的范围已完成、下一步必须等待用户的外部生成或提供素材、存在真实的阻塞项,或者当前交付已经完成。等待用户外部生成时,明确给出一次性生成包和返回的命名要求,不要继续假装已经产生了素材。