通用视频
在此工作流之前,请运行:
npx hyperframes skills update general-video
成功的无操作表示技能已最新。如果更新失败,请报告错误,不要凭记忆继续。
1. 应用跨项目源适配器
- 媒体: 对于任何音频、图像、图标、Logo、语音、调色、LUT、处理/特效、字幕或媒体操作需求,请加载
/media-use并遵循../media-use/references/resolve.md(解析、采用、复用)和../media-use/references/setup-providers.md(提供商、身份认证)。模糊的素材反馈和命名的样式在使用前请查阅../media-use/references/media-treatments.md;不要使用 CSS/SVG/透明度即兴创作支持的媒体效果。在首次认证提供商操作之前,请运行npx hyperframes auth status并逐字输出其结果。如果已登出,请应用../hyperframes/references/brief-contract.md中的门控:协作模式下等待登录或明确的离线选择;自主模式下则声明状态并通过可用的离线提供商继续。当没有离线提供商能满足所需能力时,报告阻塞。仅本地采用不需要身份认证门控。 - Figma: 如果任何输入是
figma.comURL,请先运行/figma。从其导出的资源、令牌、组件或故事板帧进行构建。不要使用原始的 Figma 连接器调用,因为它们会跳过 SVG 清理、媒体来源跟踪和品牌令牌绑定。
这些适配器不会更改由 /hyperframes 选择的工作流。
2. 从项目状态开始
应用第一个匹配的行,不要评估较低的状态行:
| 状态 | 操作 |
|---|---|
| 特定编辑 | 进行编辑,保留现有项目决策,然后重新运行受影响的检查。不要重新开始发现阶段。 |
BRIEF.md 存在 | 读取它。如果 workflow 指定了另一个工作流且 flow 不是 companion,则移交控制权。不询问任何简报问题。 |
无简报,但存在 hyperframes.json 或 STORYBOARD.md | 从文件和记录的首选项中恢复。仅根据已知事实回填 BRIEF.md。 |
| 全新创建 | 运行 /hyperframes 及其意图层。仅当 workflow: general-video 或 flow: companion 时返回此处。 |
对于新项目,从简报中选择一个短横线命名法的目录名称,并在编写简报前进行脚手架搭建:
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video
然后在项目根目录使用 ../hyperframes/references/brief-format.md 编写 BRIEF.md。在现有项目中,根目录是包含 hyperframes.json 的目录。仅记录简报格式指定的、已确认的偏好支持字段,使用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>;切勿记录推断的默认值。这里的 <MEDIA_DIR> 是已安装的 /media-use 技能目录,<PROJECT_ROOT> 是包含 hyperframes.json 的目录。如果意图层采用了某个配方,请立即使用 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> 应用它,不要再次询问。
3. 解释运行形态
仅使用来自 ../hyperframes/references/brief-contract.md 的规范术语:
| 字段 | 含义 | 效果 |
|---|---|---|
flow | 驱动者 | automation:选择并执行路线。companion:在对话中共同创作。 |
storyboard | 在构建前规划、草图设计和审查 | yes:运行规划和草图审查(storyboard.html)。no:直接构建。 |
衍生的 mode | 检查点门控的行为方式 | 遵循简报契约。切勿要求用户命名一个模式。 |
不要为这些状态发明同义词。持续的“只管构建”信号由意图层处理,并以 flow: automation、storyboard: no 的形式到达。
- 对于
flow: automation,选择路线并在第一次进度更新中用一行说明。 - 对于特定编辑,进行编辑,不要发明新路线。
对于现有素材的硬切、修剪、拼接或重新排序,将同一视频源复制到多个剪辑元素中。在每个副本上,使用 data-media-start 加 data-duration 设置源范围,然后使用 data-start 设置创作者的放置/顺序。单独创作的音频在匹配的 <audio> 元素上遵循相同的剪辑范围和时序。/hyperframes-core 掌管此类时间编辑;仅在对内部包装器进行视觉属性动画(如缩放、推拉、摇摄、裁剪、遮罩或 clip-path)时使用 /hyperframes-keyframes。从 ../hyperframes-core/references/creator-editing-recipes.md 复制完整契约。
协作流程
当 flow: companion 时:
- 读取
BRIEF.md,并将已接受的## Assets和## Customizations与项目产物进行核对。完成已接受但仍悬而未决的工作;对已完成的工作不予处理;不要将已接受的能力当作新能力再次提供。 - 以导演而非承包商的身份介入。 选择协作模式的用户是选择了参与和质量;诚实的回应是你能够设计出的最佳版本,而不是你能够辩护的最小版本。第一个方案是天花板级别的处理:故事弧线(借用最近的类型视角——菜单 § 类型视角)、设计规范、每个场景以其名字命名的动态处理(§ 5 的方案规范)、转场、音频身份——音乐和声音标记,或有意的沉默——用户素材的放置,以及设计好的开场和结尾。用一句话说明每一层增加了什么;在提及它们时标注出昂贵的部分(渲染时间、登录、计费)。用户是在裁剪方案,而不是通过逐项批准来拼凑一个。
- 天花板属于概念,而非工具箱。 每一层都必须服务于简报的信息——一个可以套用在任何视频上的方案只是装饰。精湛的工艺达到天花板;内容永远不会超出被要求的范围(§ 6)。
- 在检查点之间,
../hyperframes/references/capability-menu.md有两种工作方式。作为触发列表:当用户提到某个能力的输入或构建过程达到其需求时,提供相关能力。作为每次传递的升级渠道:一个方案、草图或构建检查点可能会附带一到两个针对用户当前关注素材的定向提供(“场景 3 的统计需要计数处理”)。在提供之前先阅读;永远不要倾倒整个目录。 - 在用户接受某个能力后,立即产出其产物,并将决策记录到匹配的
BRIEF.md正文部分。仅当用户明确更改时,才重写 frontmatter 字段并记录已确认的偏好。 - 保持相同的故事板、验证、最终预览和渲染批准门控。协作模式改变的是谁在掌舵,而不是质量要求什么。
4. 在每个阶段前加载所需知识
当条件匹配时,以下读取是强制性的:
| 条件 | 在操作前读取 |
|---|---|
| 任何合成 HTML 或场景布局 | /hyperframes-core;使用 references/determinism-rules.md 获取其布局契约 |
| 任何非平凡的创作或视觉处理 | /hyperframes-creative → references/house-style.md 和 references/video-composition.md |
| 任何动态、动画或场景转场 | /hyperframes-animation;遵循其路由到匹配的规则、适配器、蓝图或转场参考 |
storyboard: yes | ../hyperframes/references/storyboard-format.md 和 ../hyperframes/references/review-loop.md |
| 任何媒体资产或操作,包括旁白、BGM、音效、字幕、调色或变换 | /media-use;对于框架播放和放置,还需阅读 /hyperframes-core → references/variables-and-media.md |
| 多场景装配 | ../hyperframes/references/production-loop.md |
flow: companion,在第一个方案之前 | /hyperframes-creative → references/story-spine.md 和 references/house-style.md;最近的类型视角和完整的 ../hyperframes/references/capability-menu.md —— 天花板级方案是根据这些设计的,而不是回忆 |
| 协作能力提供、捕获、节拍网格、生成式视频、地图、发布或跨工作流能力 | ../hyperframes/references/capability-menu.md |
| 存在设计规范,在最终批准之前 | /hyperframes-creative → references/design-adherence.md |
不要用回忆替换这些读取。渐进式披露仅在匹配的参考文件被实际加载时才能节省上下文。
5. 执行合成
使用此依赖顺序。仅当其输入缺失时跳过某个阶段。
- 方案。 说明观众弧线、结构、节奏和时长驱动因素。对于简短的单场景使用一个文件;对于三个或更多硬场景切换或任何重复使用的场景,使用子合成。阅读
/hyperframes-creative→references/story-spine.md了解叙事弧线,references/beat-direction.md了解节奏,以及/hyperframes-core→references/composition-patterns.md了解结构。对于开放式的多场景简报,通过/hyperframes-creative→references/prompt-expansion.md扩展提示。多场景方案引用每个场景的形状:当有合适的蓝图时,使用来自/hyperframes-animation→blueprints-index.md的蓝图 ID;否则,引用其组成的命名规则(来自rules-index.md)——动态名称来自这些索引,切勿发明。故事真相决定哪些场景存在;引用来修饰它们。在你计划自行构建任何命名外观之前,请先搜索实时目录:对于简报中提到的每个外观、特效、处理或转场——例如“CRT 扫描线”、“故障效果”、“胶片颗粒”、“闪光扫掠”、“五彩纸屑爆裂”——请运行npx hyperframes catalog --query "<the look, in plain English>" --json并在方案命名如何构建该外观之前阅读最相关的结果。搜索无需安装任何东西:无需项目、无需预先add、无需账户。它会从任何目录对整个托管注册表(约 400 个块和组件)进行排序,因此它也适用于用户在构建过程中要求的某个外观。方案中命名的块将在阶段 3 安装;仅当搜索后没有找到合适结果时,才手工创作某个外观。多场景方案也作为调度产物记录下来:在STORYBOARD.md中每个场景一个## 帧 N块——status: outline,声明的src:,蓝图/规则引用,以及节拍文本——即使storyboard: no。该块是调度单元;故事板表格只是审查界面。 - 根据要求审查方案。 对于
storyboard: yes,在这些块上运行共享审查循环。对于storyboard: no,继续执行,无需方案暂停或草图表格。如果方案暂停无论如何发生了,请将子代理委派授权(步骤 4 的调度需要,例如 Codex)合并到该暂停中,而不是稍后再次停止。 - 解决依赖关系。 在并行工作之前安装注册表块。暂存用户资源,采用现有资源,并安装任何缺失的注册表包。对于方案引用的每个块 ID,运行
npx hyperframes add <block-id>。如果步骤 1 的搜索发现了适合尚未引用的外观的块,也请添加它们。 - 调度构建。 对于单场景:直接使用
/hyperframes框架的compose或build命令。对于多场景:使用子合成模式,每个场景有一个独立的文件,并通过主合成文件进行编排。在每个场景文件中,严格遵循/hyperframes-core的布局契约。对于每个场景,声明data-media-start和data-duration用于源修剪,data-start用于时序定位。使用<hyperframes-scene>元素进行场景级别包装。在可能的情况下并行构建场景。 - 验证。 运行
npx hyperframes validate。修复所有报告的问题。对于storyboard: yes,在最终预览之前运行故事板审查。 - 最终预览。 提供预览。对于
flow: companion,展示并等待输入。对于flow: automation,继续。 - 渲染批准。 运行
npx hyperframes render。通知用户渲染完成。
6. 遵循创作约束
- 除非简报明确要求,否则不要添加额外的转场或特效以“填充”时间。
- 对于
flow: automation,仅在必要时进行交互。 - 素材放置必须可追溯到来源。使用
data-src属性。 - 音频放置必须与视觉元素同步。使用匹配的时间范围。
- 除非简报指定更短的时长,否则保持合理的节奏。
- 对于长篇幅作品(>2 分钟),使用场景结构以获得更好的可管理性。