SuperAPI AI 工具集

to-storyboard

设计与创作

查看项目

更新于 10-16 02:48

技能介绍

用途

to-storyboard 用于把已完成的视频场景翻译成 HyperFrames 分镜,产出 STORYBOARD.md。它的定位是:场景(SCENES.md)定义事件,分镜定义观众如何看到这些事件。该技能属于 sugarforever/boring-video-studio 技能集,通常在场景与旁白产物齐备、进入正式制作之前使用。

主要能力

  • 校验产物血缘:重新计算节拍(beats)、旁白(narration)与场景(scenes)的产物摘要,只有当 NARRATION.md 指向当前节拍、SCENES.md 指向当前节拍与旁白,且每个已存产物摘要与文件匹配时才继续。
  • 读取权威格式:打开 SCENES.md 记录的 HyperFrames 项目与修订版本,加载 /hyperframes 并读取其当前的 references/storyboard-format.md,该契约对当前唯一的 STORYBOARD.md 具有权威性。
  • 划分帧边界:遇到硬切、独立转场、新的视觉世界、明显不同的媒体来源或可独立构建的单元时开启新帧;连续的镜头运动与共享对象状态保留在同一帧内,并在帧内描述其镜头时刻。
  • 编写镜头时刻:每个 HyperFrames 帧视为一个可构建块,在其叙事正文中按视角、景别、主体动作或信息焦点的变化,写出有序的 Shot moments 列表。每个时刻声明:时刻 ID 与大致偏移;初始状态 → 动作 → 最终状态;镜头与注意力路径;旁白锚点或标记为静默;向下一时刻或下一帧的交接。
  • 记录元数据:在全局 YAML frontmatter 中以 unknown 键各写一次 boring_source_scenes_digest、boring_source_narration_digest、boring_hyperframes_project、boring_hyperframes_revision 与 boring_artifact_digest,由规范解析器保留在 globals.extra 下。boring_artifact_digest 为移除该单行摘要后完整分镜文件的 SHA-256。帧级工作流附加字段(如 boring_scene_id)保留在帧上,不携带文档摘要或项目身份。
  • 约束与延续:以场景的世界、主角、事件、连续性、节奏与可行性作为约束,保留 BEATS.md 中的认知任务;沿用 SCENES.md 记录的渲染证据决策与项目状态,记录当前项目身份与修订版本以保持连续性,但本阶段不修改项目、不构建动态分镜。
  • 终端内容处理:当某帧展示终端托管的代码输入、shell 命令、CLI 输出、数据库输出或 TUI 时,必须使用 record-terminal 子技能,把其有证据支撑、可安全寻址回放的契约与选定的视觉处理带入镜头时刻。
  • 审计序列:检查每个旁白锚点是否被一个或多个镜头时刻覆盖、有意静默的时刻是否不带锚点、帧边界是否符合上述规则、计划动作在不读旁白时是否可读、时长分配是否符合目标。在 HyperFrames Studio 依据已构建时间线确认之前,时间只视为计划。

使用方式

  1. 确认 SCENES.md 与 NARRATION.md 已存在且血缘有效。
  2. 重新计算并比对节拍、旁白、场景的产物摘要。
  3. 打开 SCENES.md 记录的项目与修订版本,加载 /hyperframes,读取 references/storyboard-format.md。
  4. 按帧边界规则划分帧,逐帧编写 Shot moments 列表。
  5. 在全局 YAML frontmatter 写入规定的 boring_* 元数据,并计算 boring_artifact_digest。
  6. 在呈现 STORYBOARD.md 或任何后续修订前,遵循 ../boring-video/references/markdown-review.md 进行 Markdown 评审,检查帧边界、镜头时刻、旁白映射、计划时长与转场。

适用场景

适用于已有完整、血缘有效的视频场景,需要在制作前确定 HyperFrames 帧边界、镜头时刻、转场与时间安排的视频项目。尤其适合包含终端代码、命令、CLI 输出、数据库输出或 TUI 画面的分镜规划。

限制

  • 新帧一律保持 status: outline;规划阶段不创建或声明已实现的 src。
  • 本阶段不修改项目、不构建动态分镜;可播放的运动、时间与转场评审由 HyperFrames Studio 负责。
  • 规范 HyperFrames 字段具有权威性,boring_* 附加字段只作补充,不得重述规范字段。
  • 只有当帧的构图依赖已评审的视觉决策时,才引用相关场景证据。
  • 分镜完成的判定条件:每个帧都是可独立构建的 outline,其镜头时刻完整描述场景事件,每个旁白锚点与计划转场都有交代,共享项目身份与来源修订版本已记录,且 Markdown 评审完成标准已满足。在 /to-video 开始制作前不要求可播放的动态分镜。
  • 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。