插件安装: 在执行设置或新鲜度命令之前,如果此技能位于HyperFrames插件内,请遵循插件执行规则。独立安装则保留下方的更新说明。
通用视频
除非工作流刚读取过,否则在开始时运行 npx hyperframes usage --json,然后在里程碑节点(例如草稿完成后、渲染前)再次检查。读取可用的窗口和重置时间。如果使用量未知,请如实说明而不猜测配额;与用户一起确定范围和工作流选择。
在依赖此工作流之前,运行:
npx hyperframes skills update general-video
成功的空操作(no-op)表示技能已是最新。如果更新失败,请提示用户,而不是依赖内存继续。
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.com网址,首先运行/figma。基于其导出的资源、令牌、组件或故事板帧进行构建。不要使用原始的Figma连接器调用,因为它们会跳过SVG清理、媒体来源追踪和品牌令牌绑定。
这些适配器不会更改 /hyperframes 选择的工作流。
2. 从项目状态开始
应用第一个匹配的行;不要评估更低的状态行:
| 状态 | 操作 |
|---|---|
| 特定编辑 | 执行编辑,保留现有项目决策,然后重新运行受影响的检查。不要重新开始发现阶段。 |
BRIEF.md 存在 | 读取它。如果 workflow 指定了另一个工作流且 flow 不是 companion,则交接。不询问任何brief问题。 |
没有brief,但存在 hyperframes.json 或 STORYBOARD.md | 从文件和已记录的偏好中恢复。仅基于已知事实回填 BRIEF.md。 |
| 全新创作 | 运行 /hyperframes 及其意图层。仅当得到 workflow: general-video 或 flow: companion 时才返回此处。 |
对于新项目,从brief中选择一个kebab-case风格的目录名,并在写入brief之前进行脚手架搭建:
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video
然后使用 ../hyperframes/references/brief-format.md 在项目根目录写入 BRIEF.md。在现有项目中,根目录是包含 hyperframes.json 的目录。仅记录brief格式指定的、已确认的基于偏好的字段,使用 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 | 检查点门控的行为方式 | 遵循brief契约。绝不要求用户命名模式。 |
不要为这些状态发明同义词。持续的“直接构建”信号由意图层处理,并以 flow: automation、storyboard: no 的形式到达。
- 对于
flow: automation,选择路线并在首次进度更新中用一行说明。 - 对于特定编辑,执行编辑而不发明新路线。
对于现有素材的硬切、修剪、拼接或重新排序,将同一视频源复制到多个剪辑元素中。在每个副本上,使用 data-media-start 加 data-duration 设置源范围,然后使用 data-start 设置创作放置/顺序。每个视频片段保留其声音:声音保留在剪辑上(data-has-audio="true"),因此剪切视频也会剪切其声音。/hyperframes-core 负责这种时间编辑;仅对视觉属性动画(如缩放、冲击、平移、裁剪、遮罩或内部包装器上的 clip-path)使用 /hyperframes-keyframes。从 ../hyperframes-core/references/creator-editing-recipes.md 复制完整契约。
协作流程
当 flow: companion 时:
- 读取
BRIEF.md,将已接受的## Assets和## Customizations与项目制品进行核对。完成已接受但仍待完成的工作;保留已完成的工作;不要将已接受的能力当作新事物再次提供。 - 以导演而非承包商的角色出现。 选择协作模式的用户选择了参与和质量;诚实的回应是你能设计出的最佳版本,而不是你能辩护的最小版本。第一个计划是天花板级别的处理方案:故事弧(借用最接近的类型视角——菜单§ 类型视角)、设计规范、每个场景的运动处理(按名称引用自§ 5的计划规范)、转场、音频身份——音乐和声音标记,或故意的沉默——用户素材的放置,以及精心设计的开场和结尾。用一行说明每一层增加了什么;在命名时标记成本较高的部分(渲染时间、登录、计费)。用户是修剪一个处理方案;他们永远不应该逐项批准地组装一个。
- 天花板属于概念,而非工具箱。 每一层都必须服务于brief的信息——一个以同样方式处理任何视频的方案只是装饰。工艺上升到天花板;内容永远不能超过被要求的范围(§ 6)。
- 在检查点之间,
../hyperframes/references/capability-menu.md有两种工作方式。作为触发列表:当用户提及某个能力的输入或构建过程达到其需求时,提供相关能力。作为每次通过的升级渠道:计划、草图或构建检查点可以携带一两个指向用户正在查看的素材的追踪建议(“场景3的静态画面需要计数处理”)。在提供之前读取它;不要完整转储整个目录。 - 在用户接受某个能力后,生成其制品并立即在匹配的
BRIEF.md正文部分记录该决策。仅当用户明确更改时,重写一个前置字段并记录已确认的偏好。 - 保持相同的故事板、验证、最终预览和渲染批准门控。协作改变的是谁掌舵,而不是质量要求什么。
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 |
| 任何媒体资产或操作,包括旁白、背景音乐、音效、字幕、调色或变换 | /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了解结构。对于开放式多场景brief,通过/hyperframes-creative→references/prompt-expansion.md扩展提示。多场景计划引用每个场景的形状:一个来自/hyperframes-animation→blueprints-index.md的蓝图ID(如果合适),或者当没有蓝图合适时,引用它从rules-index.md组合的命名规则——运动名称来自这些索引,绝不发明。故事真实性决定哪些场景存在;引用为它们着装。在你的计划如何构建任何命名外观之前搜索实时目录:对于brief中命名的每个外观、效果、处理或转场——"CRT扫描线"、"故障效果"、"胶片颗粒"、"闪光扫过"、"五彩纸屑爆发"——运行npx hyperframes catalog --query "<以普通英语描述的外观>" --json并在计划命名该外观如何构建之前读取顶部结果。搜索不需要安装任何东西:无需项目、无需事先add、无需账户。它从任何目录对完整托管注册表(约400个块和组件)进行排序,因此也适用于用户在构建过程中要求的外观。计划命名的块在第3阶段安装;仅在对某外观的搜索没有返回合适结果时,才手动编写该外观。多场景计划也被记录为调度制品:STORYBOARD.md中每个场景一个## Frame N块——status: outline、声明的src:、蓝图/规则引用。