HyperFrames Agent 工作流完全指南从 HTML 到视频的路由、意图与技能编排【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframesHyperFrames 是一个用 HTML 写视频的开源框架——一段视频组合composition就是一个 HTML 文件DOM 通过data-*属性声明时间轴动画运行时可任意 seek媒体播放由框架接管。本文基于仓库中 skills/hyperframes/SKILL.mdHyperFrames 的强制入口点展开完整讲解 Agent 面对做视频、改视频、渲染视频类请求时应遵循的决策状态机如何从项目状态出发、如何路由新鲜创作、如何安装并加载领域技能以及支撑这套编排的BRIEF.md、意图访谈与 CLI 版本管理。读完本文你将掌握 HyperFrames 项目中从一句话需求到可渲染 composition 已确认 BRIEF的完整 Agent 工作流以及每条路由、每个命令背后的源码级依据。1. 起点永远从项目状态开始SKILL.md的第一条铁律是任何视频相关请求创建、编辑、动画、渲染、检查、诊断、校验、预览、发布、批量渲染都必须先读取本技能然后从项目状态出发决策而不是从通用创作流程出发。决策依据是第一张状态表自上而下匹配第一行命中的规则命中的更低行一律不再评估状态动作明确将现有 Remotion 源码移植到 HyperFrames读取references/routes/remotion-to-hyperframes.md直接路由到该工作流跳过意图层对现有 HyperFrames 项目执行特定操作检查/诊断/校验/预览/渲染/发布/批量渲染只执行该操作跳过意图与路由加载/hyperframes-cli及所需领域技能对现有项目做特定编辑直接编辑不运行意图层项目存在BRIEF.md读取其workflow与flow字段执行对应工作流flow: companion一律在/general-video中执行不再询问任何 brief 问题无 brief但存在hyperframes.json或STORYBOARD.md从项目文件与已记录偏好恢复从现有产物推断归属工作流无法唯一确定时才允许问一个纯路由问题不做意图访谈全新创作运行意图层references/intent-interview.md然后按 §2 的路由表路由一次配套规则若全新请求没有说明主题或输入先问视频主题再路由提问前必须先查偏好与配方见 skills/hyperframes/references/intent-interview.md 第 1 步。figma.com输入或已命名配方只改变摄入方式而非路由——由访谈中的 Adapt orthogonal inputs 一节处理。这套状态机的设计意图很清晰意图访谈intent layer只对全新创作运行一次。编辑、项目操作、已有 brief、可恢复项目、显式 Remotion 移植都直接绕开它避免重复提问和重复路由。2. 保持项目 CLI 版本新鲜升级探测是只读的脚手架项目会在package.json的 scripts 中固定pinhyperframesversion保证渲染可复现pin 永远不会自行前进且被 pin 的旧 CLI 运行时不打印任何升级警告。因此恢复一个带 pin 的项目时应在第一个影响渲染的命令之前做一次探测npx hyperframeslatest upgrade --project . --check这条探测是只读的只报告 pin 与最新版的差异。注意保留显式的.——旧版 CLI 上裸写--project后紧跟另一个 flag 时会把那个 flag 当作目录值吞掉。以下任一信号出现时执行升级探测报告项目落后任何 CLI 输出已提示stderr 通知This project pins hyperframes… (latest …)被 pin 的脚本在--json结果中出现_meta.updateAvailable: true。执行升级并验证npx hyperframeslatest upgrade --project . npx hyperframes checkcheck通过只说明composition 在新版本上依然通过校验不代表渲染输出与旧 pin 逐帧一致——因此一次成功的升级绝不能静默必须在本次运行的摘要中同时写出新旧版本号。尚无 composition 的项目无需验证若check失败则回滚package.json变更继续使用被 pin 的版本并报告项目停留在哪个版本及原因。对信号采取行动而不是把信号转述给用户永远不要留下一个已升级却未验证的 pin。3. 路由新鲜创作先匹配交付物再读路由契约SKILL.md的第二张表是新鲜创作的路由表同样取第一个匹配行。关键原则匹配的是请求的交付物而不是顺带提到的某个词或文件类型。优先级请求工作流1显式移植现有 Remotion 源码/remotion-to-hyperframes2编写演示文稿、pitch deck 或可导航交互式 deck/slideshow3为现有 talking-head 素材添加纯字幕/副标题而不改动画面/embedded-captions4为现有 talking-head/访谈/播客素材添加设计好的图形叠层而不改动画面/talking-head-recut5由音乐曲目构建节拍同步视频无旁白、无网站抓取/music-to-video6创作显式简短、无旁白、以动效为先的单元通常 10s/motion-graphics7从 PR 引用解释 GitHub 拉取请求或代码变更/pr-to-video8从 URL 或站点专属 brief 营销/展示网站、产品页、App 或公司/product-launch-video9用虚构视觉解释主题/文章/笔记无产品、无站点抓取/faceless-explainer10其他任何自定义视频或组合/general-video定稿路由前必须读取references/routes/workflow.md——每个路由对应一个小文件内含该路由的输入/输出/触发契约在懒安装的工作流技能尚不可用时即可用以及该路由的访谈入口。若候选路由不满足其契约继续向下匹配而不是强行套用只读取命中的那个路由文件。3.1 常见歧义裁决SKILL.md给出了一组精确的裁决规则是路由实践中最容易出错的地方短动画标题、logo sting、数据/图表命中、地图命中、独立 lower-third无旁白且动效即信息时归/motion-graphics静态标题卡、有旁白的序列、较长蒙太奇或自定义循环归/general-video。显式短视频动效可以使用 URL、推文、文章或截图作为素材而用这个网站做个视频的泛化请求是/product-launch-video。现有素材加字幕走/embedded-captions素材加设计化信息卡走/talking-head-recut。重定时、重排、重新调色、重取景或重混素材属于自定义编辑落到/general-video。音乐文件只有在节拍网格驱动成片时才选/music-to-video作为背景音乐使用时不覆盖按主题匹配的路由。我想要个故事板改变的是评审流程而不是工作流无其他路由信号时用/general-video。已确认的草图板本身可以是交付物评审循环定义该停止点。专项叙事工作流支持约 3 分钟以内的成片30–90s 最强明显更长的片子路由到/general-video。时长永远不覆盖显式移植、deck、字幕、叠层或音乐驱动交付物。3.2 路由契约速览来自各 route 文件slideshow 路由交付物是可导航的 deck 而非 MP4——离散幻灯片、片段揭示、分支、热点、演示者模式与演讲者备注配套SlideshowController使用的 JSON island。访谈只有一个问题路由确认本身前端能力推荐跳过两个 run-shape 问题都不适用。embedded-captions 路由输入是真实媒体文件非 URL 或创作 brief输出是原素材不动 字幕层与选定字幕身份必须问题是哪个 clip延迟告知字幕身份选择先探测素材再从目录中短选 2–3 个并推荐run-shape 不适用。talking-head-recut 路由输入素材原样播放输出叠加转录同步的图形卡动态标题、lower-thirds、数据标注、引文、侧栏或画中画渲染策略问题宽高比、布局、样式组、卡片数延迟到其 Step 7由已探测素材与转录给出推荐。general-video 路由兜底路由覆盖静态标题卡、长品牌/sizzle 片、多场景蒙太奇、静态循环/海报、类 NLE 素材重混与自由组合同时执行所有flow: companionbrief两个 run-shape 问题都适用且它是 companion 宿主。4. 路由一次然后离开意图层产出 BRIEF.md对于新鲜创作意图层skills/hyperframes/references/intent-interview.md运行完整对话——记忆、分流、pitch 轮、must-haves、run-shape、交接——并以写入BRIEF.md收尾。BRIEF.md是工作流唯一读取的路由产物此后任何这条路由要求了什么的问题都从BRIEF.md回答不会再重开本技能或访谈。4.1 意图层的八个步骤提问前先读记忆用node MEDIA_DIR/scripts/prefs.mjs get --hyperframes MEMORY_ROOT --json读取记住的默认值脚手架前用不存在的探针路径如/tmp/hyperframes-intent-memory-run-id再用recipe.mjs list检查配方命名的配方若与可能路由匹配先提出采纳采纳会锁定配方所含字段只问缺失字段与两个 run-shape 问题且不取消评审与渲染审批门槛。分流输入判断请求是已成型信息、素材、场合都可读还是未成型有主题没观点。未成型请求在路由后进入 pitch 轮并在此处先问一个问题用户已经想象到什么。选路由用 §3 的路由表与歧义规则然后读routes/workflow.md。pitch 轮仅未成型请求沿五条真正不同的路径各取样一个概念其中至少两个必须落在分布尾部概率 0.10全部展示后再推荐一个每个 pitch 三行概念一句话、视觉世界、开场钩子。选中的概念是 brief 的创作核心落入BRIEF.md的## Intent其命名的能力随## Customizations确认。路由 must-haves每字段一问推荐选项在前并附带收据receipt请求已回答的字段可跳过——推断不算回答但选中的 pitch 算。两个 run-shape 问题(a)故事板——在活板上逐 pass 评审或跳过板子从已确认 brief 一次出片(b)自动化还是伴跑——automation是匹配工作流端到端执行 briefcompanion是回到/general-video一起构建。两者正交绝不合并成一个菜单flow×storyboard四种组合全部合法。锦上添花推荐而非盘问——发一轮 offer推荐优先目录按需展示素材当场回答其具体用途设计规格保持三态提问。交接一次整合检查陈述与推断分开展示推断组是纠错区修正后必须重新展示确认绝不执行已编辑但未确认的 brief。4.2 BRIEF.md 的 frontmatter 契约BRIEF.md约 1KB是访谈的交付物。核心键如下键含义示例workflow执行工作流companion 运行记录为general-videofaceless-explainerflowautomation——匹配工作流的流水线 ·companion——在/general-video中共创automationstoryboardyes——在活板上评审 ·no——从已确认 brief 一次出片yesmessage视频必须传达的那一件事Ship it in an afternoondestination/aspect/language/audience/length/angle…该路由确认的注册表字段—工作流在hyperframes init之后且仅在其之后的第一动作就是据此写出BRIEF.md——init拒绝非空目录顺序不可颠倒。5. 安装并进入工作流在读取选中的工作流之前先安装或刷新它与核心领域技能npx hyperframes skills update workflow-name使用不带/的裸名称。命令失败时浮出错误绝不凭记忆重建工作流。其余一切——core 与 lazy 的划分、init刷新什么、诊断、CI 退出方式、无 CLI 回退——都记录在 skills/hyperframes/references/skill-lifecycle.md 中。关键生命周期事实来自 skill-lifecycleHyperFrames急切安装核心集/hyperframes、hyperframes-*领域技能、/media-use懒安装工作流技能路由选中时才通过skills update workflow-name安装。npx hyperframes init检查 GitHub 并刷新核心集与已装技能不安装从未用过的工作流离线或限流时优雅降级不阻断脚手架。--skip-skills暂被忽略CI 可用HYPERFRAMES_SKIP_SKILLS1退出。诊断命令族skills check陈旧或核心集不完整时非零退出、skills check --json、裸skills update刷新核心集与已装项、剪除未发布技能、不扩张工作流集、skills update name...额外安装命名技能、裸skills安装完整发布集。无 CLI 回退npx skills add heygen-com/hyperframes --skill workflow-name装单个--all装全套。6. 按需加载领域技能能力地图与创作者编辑路由SKILL.md的第三张表是领域技能能力地图——按需加载绝不一次全装需求技能组合结构、时间属性、轨道、变量、确定性/hyperframes-core动效规则、场景蓝图、转场、运行时适配器/hyperframes-animationSeek 安全的 GSAP、CSS、Anime.js、WAAPI、FLIP、路径、遮罩、SVG、3D 关键帧或hyperframes keyframes诊断/hyperframes-keyframes设计规格、概念、调色板、字体排印、旁白、节拍规划/hyperframes-creative图片、图标、logo、音频、字幕、调色、LUT、可复用媒体/media-use配音 carving、音频效果链、自动化包络、跨轨单链/单推子submix bus/hyperframes-audioinit、lint、check、snapshots、compare、批量渲染、Studio、render、publish 或诊断/hyperframes-cli注册表块与组件/hyperframes-registryFigma 资产、tokens、组件或故事板帧重建为动效/figma6.1 创作者编辑短语是跨领域请求当用户说出剪辑式口语指令时需要加载匹配行中命名的每一个领域技能典型组合见下表例如把这段素材剪了需要/general-video/hyperframes-corecore 拥有data-start、data-duration、data-media-start与轨道布局创作者请求必需领域剪切素材、硬切、修剪、拼接、重排或使用源区间/general-video/hyperframes-core放大、punch-in/out、多状态平滑缩放/重取景、Ken Burns、运镜/general-video/hyperframes-core/hyperframes-keyframes动画内层视觉/裁剪包装而非定时 clipmatch cut 或 whip pan 运镜转场/general-video/hyperframes-animation/hyperframes-keyframes/hyperframes-registry先搜索/安装转场原语再手工编写淡入淡出、交叉淡化、轨道增益/音量、自动化、duck/carve、音频效果或跨轨单效果/general-video/hyperframes-core/hyperframes-audio画面声音混合编辑剪切叠加运镜或混音/general-video/hyperframes-core/hyperframes-keyframes有视觉动效时 /hyperframes-audio有音频处理时生成素材或预处理不支持的变速/源内冻结/media-use仅生成/预处理不做轨道混音两条关键限制data-playback-rate常量对画面与保音高声音是渲染安全的但不使源变速可做关键帧——变速需预处理跨领域编辑契约的可复制版本见/hyperframes-core的references/creator-editing-recipes.md。另外关于摄影类媒体观感的宽泛反馈太暗了、太平了、风格化一下、遮住脸也路由到/media-use即便用户从没说过调色或效果。6.2 领域技能不接管端到端交付物领域技能只是能力提供方永不拥有端到端交付物——只加载当前工作流实际需要的那些。构建期若涉及重要摄影素材最终质量 pass 中应包含一次基于事实的媒体润色扫描保持素材原样也是合法结果。关于素材处理必须先读 skills/media-use 的 media-treatments 参考 的对应说明——它约束的是素材如何被处理绝不约束媒体是否可用不得用通用 LUT、CSS 滤镜/叠层或透明度 tween 替代既有的规范处理原语。7. 完整入口链路从请求到可渲染项目综合SKILL.md及其参考文件一条完整的新鲜创作链路是读取本技能强制入口按状态表定位全新创作 → 进入意图层其余状态按表直达意图层八步记忆与配方 → 分流 → 路由 →未成型时pitch 轮 → must-haves → 两个 run-shape 问题 → 推荐/素材/设计规格 → 交接安装工作流npx hyperframes skills update workflow-name进入工作流其 Setup 在hyperframes init之后写入BRIEF.md按需加载领域技能§6 能力地图执行构建、npx hyperframes check校验、preview评审、获批后render。这条链路确保三个不变式意图只问一次、路由只做一次、BRIEF.md是唯一的路由契约载体。对 Agent 而言SKILL.md就是做视频这件事的决策内核——所有后续工作流、领域技能与 CLI 命令都围绕这张状态表和两张路由表展开。【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考