插件安装: 在运行设置或新鲜度命令之前,如果此技能位于 HyperFrames 插件内,请遵循插件执行规则。独立安装请保留下面的更新说明。
通用视频
在工作流程刚读取过后,立即运行 npx hyperframes usage --json 检查使用情况,然后在重要里程碑处如草稿和渲染前再次检查。读取可用窗口和重置时间。如果使用情况未知,直言不讳而不猜测额度;与用户共同确定工作范围和流程选择。
在依赖此工作流之前,请运行:
npx hyperframes skills update general-video
成功且无操作的响应表示技能是最新的。如果更新失败,请报告错误,不要依赖记忆继续。
1. 应用跨项目源适配器
- 媒体: 对于任何音频、图像、图标、标志、语音、调色、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的 URL,请先运行/figma。从其导出的资产、令牌、组件或分镜帧构建。不要使用原始的 Figma 连接器调用,因为它们会跳过 SVG 消毒、媒体来源和品牌令牌绑定。
这些适配器不会更改 /hyperframes 选择的工作流。
2. 从项目状态开始
应用第一个匹配的行;不要评估更低的层级状态行:
| 状态 | 操作 |
|---|---|
| 特定编辑 | 进行编辑,保留现有项目决策,然后重新运行受影响的检查。不要重新开始探索。 |
BRIEF.md 存在 | 读取它。如果 workflow 命名了另一个工作流且 flow 不是 companion,则移交。不要询问简要问题。 |
无简要,但存在 hyperframes.json 或 STORYBOARD.md | 从文件和记录的偏好中恢复。仅从已知事实回填 BRIEF.md。 |
| 全新创作 | 运行 /hyperframes 及其意图层。仅当结果为 workflow: general-video 或 flow: companion 时返回到此处。 |
对于新项目,从简要中选择一个 kebab 格式的目录名,并在编写简要前搭建脚手架:
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 设置创作的放置/顺序。每个视频片段保留其声音:声音保留在剪辑上(data-has-audio="true"),因此剪辑视频也会相应剪辑其声音。/hyperframes-core 拥有这种时间编辑;仅将 /hyperframes-keyframes 用于视觉属性动画,如缩放、打孔、平移、裁剪、遮罩或内部包装器上的 clip-path。从 ../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、SFX、字幕、调色或变换 | /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 "<日常语言描述的外观>" --json并在计划命名如何构建该外观之前阅读排名靠前的结果。搜索不需要任何安装:不需要项目、不需要先前的add、不需要账户。它从任何目录对整个宿主注册表(约 400 个块和组件)进行排序,因此也适用于用户在构建过程中要求的外观。计划中命名的块在阶段 3 安装;仅在搜索后没有任何适合的结果时手动创作一个外观。多场景计划也记录为调度产物:每个场景在STORYBOARD.md中一个## Frame N块——status: outline,一个声明的src:,蓝图/规则引用,一个...
...
[由于内容被截断,此处翻译不完整]