mcpField
T
to-storyboard

to-storyboard

github.com/sugarforever创意与媒体18640 次安装5 天前更新
代码仓库

关于 to-storyboard

to-storyboard 是一项创意技能,可将场景和旁白文档转为 HyperFrames 分镜。它定义可制作的画格和镜头节点,同时保留旁白对应关系、视觉约束与项目连续性。

主要功能

  1. 01将场景转为分镜画格
  2. 02定义有序镜头节点
  3. 03将旁白对应到视觉状态
  4. 04保留演示的真实性与标签
  5. 05记录项目身份和修订版本

适用场景

  1. 01根据已确认场景规划镜头
  2. 02将旁白锚点映射到画面
  3. 03为 HyperFrames 制作准备大纲

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/sugarforever/boring-video-studio --skill to-storyboard

安装后在 Claude Code 中输入/to-storyboard确认已加载。

详细介绍

转为分镜稿

将 SCENES.md 和 NARRATION.md 转换为 HyperFrames STORYBOARD.md。场景定义事件;分镜稿定义观众如何看到这些事件。

流程

  1. 重新计算节拍、旁白和场景产物的摘要。只有当 NARRATION.md 指向当前节拍,且 SCENES.md 指向当前节拍和旁白,并且每个已存储的产物摘要都与其文件匹配时,才继续。打开 SCENES.md 中记录的 HyperFrames 项目和修订版本,然后加载 /hyperframes 并阅读当前的 references/storyboard-format.md。这份规范是唯一当前 STORYBOARD.md 的权威依据。
  2. 选择 HyperFrames 帧边界:
    • 遇到硬切、独立转场、新的视觉世界、实质上不同的媒体来源或可独立构建的单元时,开始新帧;
    • 连续的摄像机移动和共享的对象状态保留在同一帧中,并描述其内部镜头时刻。
  3. 将每个 HyperFrames 帧视为一个可构建的区块。在其叙事正文中,于视点、镜头景别、主体动作或信息焦点发生变化时,编写有序的 Shot moments 列表。每个时刻都要声明:
    • 时刻 ID 和大致偏移;
    • 初始状态 → 动作 → 最终状态;
    • 摄像机和注意力路径;
    • 旁白锚点,或 silent;
    • 与下一时刻或帧的衔接。
  4. 只要当前规范已有对应含义,就使用规范元数据。将文档级 boring_source_scenes_digest、boring_source_narration_digest、boring_hyperframes_project、boring_hyperframes_revision 和 boring_artifact_digest 各写一次,作为未知键放入全局 YAML frontmatter;规范解析器会将它们保留在 globals.extra 下。计算 boring_artifact_digest 时,先从完整分镜稿文件中仅移除这一行摘要,再对剩余内容计算 SHA-256。帧级工作流扩展字段(例如 boring_scene_id)保留在各自的帧中,绝不承载文档摘要或项目信息。
  5. 将场景的世界、主角、事件、连续性、节奏和可行性作为约束。保留 BEATS.md 中的认知任务。
    • 在相关镜头时刻中保留每个演示的确切内容、真实性模式和可见代码标签。不得将教学性重现升级为看似真实的证据。
    • 当帧展示终端中输入的代码、shell 命令、CLI 输出、数据库输出或 TUI 时,必需子技能: 使用 record-terminal。在镜头时刻中保留其有证据支撑且可安全定位回放的约定,以及选定的视觉呈现方式。
  6. 将 HyperFrames 规范字段视为权威。boring_* 扩展字段用于补充规范,绝不重复陈述规范字段。
  7. 将所有新帧的状态设为 status: outline;规划不会创建或声称已实现 src。当帧的构图依赖已审核的视觉决策时,引用相关场景证明。HyperFrames 制作流程负责构图 HTML,并将帧推进到 built 或 animated。
  8. 审核序列:每个旁白锚点都由一个或多个镜头时刻覆盖;视觉状态在对应时刻支撑口述内容;有意静默的时刻不带锚点;帧边界符合上述规则;演示保留其声明的真实性和标签;时长分配符合目标。在 HyperFrames Studio 根据已构建时间线确认之前,将时间安排视为计划。
  9. 沿用 SCENES.md 和项目状态中记录的渲染证据决策。记录当前项目身份和修订版本以保持连续性,但在此阶段不要修改项目或构建动态分镜。 在提交 STORYBOARD.md 或任何后续修订版之前,请遵循 ../boring-video/references/markdown-review.md。请在权威 Markdown 中检查画面边界、镜头时刻、旁白映射、计划时长和转场。后续由 HyperFrames Studio 负责可播放动画、时间安排和转场审查。

当每一帧都是可独立构建的 outline,其镜头时刻完整描述场景事件,所有旁白锚点和计划转场均已纳入,已记录共享的项目标识和源修订版本,且满足 Markdown 审查完成标准时,分镜即告完成。在 /to-video 开始制作之前,无需提供可播放的动态分镜。

评论

支持 Markdown