The open-source full-stack studio for Opus 5.5 motion video. Reverse engineering for any video. Code video with HTML: recreate, edit and render. BYOA + BYOK · Motion.md · Images, Video, Music & Voice.
TypeScript agent-skillsagentic-aiai-agentsai-videobyokclaude-codecodexdeepseek-harnessdsh-plugingenerative-ailocal-firstmcpmotionmotion-graphicsmultimodalopenmotionreverse-engineeringvideo-editingvideo-generationworkbuddy
docs(motion): deliver template videos in the editor
Awek-015501762fc8ac5
diff --git a/AGENTS.md b/AGENTS.mdindex 04fb7855..05b87b35 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -41,4 +41,4 @@ Phase one exposes eleven motion_ Tools (nine project tools plus catalog fetch an## Template production and reuse-`motion-template-to-video` implements the default template route and reuses shared context/edit and managed-project revision protection. Unchanged requests can deliver the template's existing preview; edited content or missing previews use the appropriate render/verification path. `motion-video-to-template` separately produces a portable reusable template from a video; it does not replace ordinary video recreation. Visual acceptance belongs to the user. Repository work does not invoke production Skills.+`motion-template-to-video` implements the default template route and reuses shared context/edit and managed-project revision protection. Unchanged requests are delivered by opening the template in the editor; edited content is checked by playing it in the editor preview, with native snapshots only for layout; renders and exports, including of an unchanged template, happen only when the user asks for a video file. `motion-video-to-template` separately produces a portable reusable template from a video; it does not replace ordinary video recreation. Visual acceptance belongs to the user. Repository work does not invoke production Skills.diff --git a/README.md b/README.mdindex 6c023417..8137c677 100644--- a/README.md+++ b/README.md@@ -52,7 +52,7 @@ These are the editorial directions for the **planned public collections site**.These frames come from the bundled [Hyperframes examples](template-library/NOTICE.md). Pick a template and ask Codex:-> Keep the opening and the pace of the reveal. Use our logo and the product screenshots in this repo. Hold the second screen long enough to read the new headline. Give me the editable project and an MP4.+> Keep the opening and the pace of the reveal. Use our logo and the product screenshots in this repo. Hold the second screen long enough to read the new headline.The gallery's **one-click recreate** action copies the selected reference and instructions for your Agent. A bundled or Prism template opens directly; external footage needs analysis and reconstruction. In Studio you can change the text, timing, layout and assets, or ask your Agent to make the same edit. Imported footage stays a clip.diff --git a/docs/README.zh-CN.md b/docs/README.zh-CN.mdindex 230a635f..3469fb6e 100644--- a/docs/README.zh-CN.md+++ b/docs/README.zh-CN.md@@ -52,7 +52,7 @@这些画面来自随包提供的 [Hyperframes 示例](../template-library/NOTICE.md)。选好模板后,可以这样告诉 Codex:-> 保留开场和产品揭示的节奏,换成这个项目里的 Logo 和产品截图。第二张截图多停一会儿,让观众能读完新标题。给我可编辑工程和 MP4。+> 保留开场和产品揭示的节奏,换成这个项目里的 Logo 和产品截图。第二张截图多停一会儿,让观众能读完新标题。画廊里的**一键复刻**会复制对应的参考和指令。内置模板能直接打开;外部参考需要 Agent 分析并重建。随后可以在 Studio 里调整文字、时长、布局与素材,也可以继续在 Codex 里改。导入的视频仍是媒体片段。diff --git a/docs/motion-md.md b/docs/motion-md.mdindex 64634d88..43c5fcc5 100644--- a/docs/motion-md.md+++ b/docs/motion-md.md@@ -32,7 +32,7 @@ Use ordinary Markdown headings, prose and tables. The sections above are a propo2. Write a Motion MD using the [example](examples/product-launch.MOTION.md). Replace its illustrative content and record the real sources.3. Give the file explicitly to your Agent with the project and a task such as:- > Read this Motion MD and the attached brand assets. Use the specification to adapt our product-launch project. Keep the listed constraints, make the requested edits, and deliver the editable project and MP4.+ > Read this Motion MD and the attached brand assets. Use the specification to adapt our product-launch project. Keep the listed constraints and make the requested edits in the editable project.4. The Agent follows the existing creation/template workflow and writes the native project. Preview and revise it in openmotion.5. Review the final video and record the actual version and result. A file with a “Review” section is not automatically verified.diff --git a/docs/motion-md.zh-CN.md b/docs/motion-md.zh-CN.mdindex 8542a87f..f6f2f423 100644--- a/docs/motion-md.zh-CN.md+++ b/docs/motion-md.zh-CN.md@@ -26,7 +26,7 @@1. 从[资源索引](collections/README.zh-CN.md)选出参考或模板,准备好自己的品牌素材。2. 按[示例](examples/product-launch.MOTION.zh-CN.md)写出规范,填入真实来源和本次要保留的约束。-3. 把文件、素材和需求明确交给 Agent,例如:“读取这份 Motion MD,用我们自己的产品截图改编发布片。保留每次揭示后的停顿,交付可编辑工程和 MP4。”+3. 把文件、素材和需求明确交给 Agent,例如:“读取这份 Motion MD,用我们自己的产品截图改编发布片。保留每次揭示后的停顿,在可编辑工程里完成修改。”4. 在 openmotion 中预览、改稿并导出。完成后记录工程版本和实际观看结果。当前没有自动发现、解析、校验或注册 Motion MD 的接口。文件名本身不会触发工作流。diff --git a/docs/usage.md b/docs/usage.mdindex 5e641d9e..c2251858 100644--- a/docs/usage.md+++ b/docs/usage.md@@ -202,7 +202,7 @@ node --experimental-strip-types scripts/verify-export.ts /absolute/path/final.mp## 视频转模板与模板出片-视频转模板入口仅在要求可复用模板时使用,要求原样重建尽量匹配参考画面、构图、运动和节奏;素材与源码保持可编辑。原样使用模板时直接交付模板里的 `preview.mp4`,不重新渲染、不比对。制作时对照原片;打包后另外检查 ZIP 解压到别处能独立渲染,不缺文件、字体和素材,帧率、帧数、时长和预览一致;不做逐帧像素比对,不为肉眼看不出的差异返工。具体规范见 [模板制作验证](../skills/motion-video-to-template/references/verify.md)。视频转模板时不向用户提问,由 Agent 自行选择最贴近原片的方案并记录在模板内唯一的说明文件 `TEMPLATE.md`;常用修改声明为变量,在 Studio Variables 面板修改;交付回复只给预览、模板、原片对照、能改什么和与原片的差异,技术检查写在 `TEMPLATE.md`;用模板生成视频时,缺少品牌、产品、价格、图片等只有用户能提供的内容,或要求有明显歧义时,Agent 会一次性提问。motion-video-to-template 不承接普通视频复刻或直接混入修改要求;普通复刻由 motion-recreate 实现,已有模板的修改由 motion-template-to-video 处理。+视频转模板入口仅在要求可复用模板时使用,要求原样重建尽量匹配参考画面、构图、运动和节奏;素材与源码保持可编辑。原样使用模板时在编辑器里打开即完成,不渲染、不比对。制作时对照原片;打包后另外检查 ZIP 解压到别处能独立渲染,不缺文件、字体和素材,帧率、帧数、时长和预览一致;不做逐帧像素比对,不为肉眼看不出的差异返工。具体规范见 [模板制作验证](../skills/motion-video-to-template/references/verify.md)。视频转模板时不向用户提问,由 Agent 自行选择最贴近原片的方案并记录在模板内唯一的说明文件 `TEMPLATE.md`;常用修改声明为变量,在 Studio Variables 面板修改;交付回复只给预览、模板、原片对照、能改什么和与原片的差异,技术检查写在 `TEMPLATE.md`;用模板生成视频时,缺少品牌、产品、价格、图片等只有用户能提供的内容,或要求有明显歧义时,Agent 会一次性提问。motion-video-to-template 不承接普通视频复刻或直接混入修改要求;普通复刻由 motion-recreate 实现,已有模板的修改由 motion-template-to-video 处理。## 多 Agent 薄适配器diff --git a/skills/motion-production/SKILL.md b/skills/motion-production/SKILL.mdindex b8509a6b..70606500 100644--- a/skills/motion-production/SKILL.md+++ b/skills/motion-production/SKILL.md@@ -22,7 +22,7 @@ Agent 根据本轮意图选择入口,专业任务可直接进入对应 Skill1. 修改已有内容时读取 [共享修改流程](references/edit.md),确定变化、保持项及连带影响;仅查询、预览、审查或导出按本轮范围执行。2. Existing-project content edits apply the [continuing-edit preview rules](references/native.md#continuing-edits) before writing and after saving, including scoped engineering work. Preserve the current chat by default; queue its latest preview while inactive and inspect it on return. Only an explicit show-now request permits switching back for this turn. 操作工程前读取 [运行规范](references/production.md);编写原生内容前另读 [Native authoring](references/native.md) 及工具返回的固定版本引擎指南。确认 projectId、最新 revision 与 currentVersionId,复用已完成操作。3. 按共享上下文的依赖清单补齐受影响的质量规范。换现成音乐、调音量也需核对声画锚点与原有 SFX;画面锁定时保持视觉内容。补读结果先返回模型,后续调用再执行依赖操作。-4. 检查受影响区间、接点和保持项。需要新渲染的导出或成片交付读取 [验证](references/verification.md),针对已审查 revision/versionId 导出,已有适用任务先查询并复用;原样模板预览按专业入口核验,检查实际 MP4。技术通过与创作品质、正常播放及试听分别记录。+4. 检查受影响区间、接点和保持项。需要新渲染的导出或成片交付读取 [验证](references/verification.md),针对已审查 revision/versionId 导出,已有适用任务先查询并复用;模板出片按专业入口在编辑器中核验,需要导出时检查实际 MP4。技术通过与创作品质、正常播放及试听分别记录。5. 停在用户要求的方案、预览、工程或成片阶段。交付实际结果、检查与必要限制。## 专业导航与旧调用兼容@@ -33,7 +33,7 @@ Agent 根据本轮意图选择入口,专业任务可直接进入对应 Skill| --- | --- || 原创新片、动态图形、创作方案、大幅重编叙事 | [motion-director](../motion-director/SKILL.md) || 重新设计局部动作、节奏、声音叙事,或评价创作品质 | motion-director 的局部创作/审片范围;即使画面锁定,也可仅设计声音 |-| 使用已选可编辑模板或源码适配内容 | [motion-template-to-video](../motion-template-to-video/SKILL.md),保留已有原样预览交付与内容适配实现 |+| 使用已选可编辑模板或源码适配内容 | [motion-template-to-video](../motion-template-to-video/SKILL.md),保留原样交付与内容适配实现 || 明确要求把参考视频重建为可复用模板文件夹或 ZIP | [motion-video-to-template](../motion-video-to-template/SKILL.md) || 根据实际视频重建本次作品;只有成片文件/链接、没有对应可编辑工程时,即使只改几处字 | [motion-recreate](../motion-recreate/SKILL.md),沿用已有复刻方法与数字测量 || 参考视频只提供风格灵感 | motion-director |diff --git a/skills/motion-production/references/context.md b/skills/motion-production/references/context.mdindex 673f221a..b52dbd25 100644--- a/skills/motion-production/references/context.md+++ b/skills/motion-production/references/context.md@@ -29,7 +29,7 @@ Agent 结合当前目标、保持项与工程状态选择本轮入口;工程| --- | --- || 原创新片/大幅重编 | [动作脚本](../../motion-director/references/action-script.md)、[动态表现](../../motion-director/references/motion-craft.md)、[动作短句](../../motion-director/references/motion-phrases.md)、[审片](../../motion-director/references/motion-review.md) || 新设计声音叙事或工程音轨调整,含画面锁定 | [声音叙事](../../motion-director/references/sound-narrative.md)、[动作脚本的声画锚点](../../motion-director/references/action-script.md)、审片;只应用声音相关内容,不启动原创流程 |-| 仅原样交付与当前源文件对应的模板 preview.mp4 | Follow motion-template-to-video for file identity/existence/decode checks and the [editable preview handoff](native.md#editable-preview-handoff); load no authoring/export dependencies. An edited project cannot reuse the original template preview. |+| 原样使用模板、不做修改 | Follow motion-template-to-video: the [editable preview handoff](native.md#editable-preview-handoff) is the delivery; load no authoring/export dependencies. An edited project cannot reuse the original template preview. || 使用/适配可编辑模板,需要创建、编辑或渲染工程 | [模板能力说明](templates.md)、审片;默认内容的草稿也需读模板能力说明 || 明确要求视频转可复用模板 | [motion-video-to-template](../../motion-video-to-template/SKILL.md) 的制作与打包参考按阶段读取;制作决策、审片及实际参考视频 || 复刻视频 | [制作决策](../../motion-director/references/production-decisions.md)、审片,另实际检查参考视频 |@@ -69,7 +69,7 @@ Motion 质量是基础职责,不以用户是否说“丝滑”作为加载条工程操作前读 [运行规范](production.md);编写原生内容前读 [Native authoring](native.md) 及返回的固定版本引擎指南。确认活动项目和最新 revision,复用已有工程,只有任务确实需要时创建或切换项目。冲突时检查新源文件,不盲目重放旧写入。-需要新渲染的导出/成片交付读 [验证](verification.md)。已有适用的导出任务时先查询,不重复提交;验证依据须对应实际 revision 和文件。仅原样交付模板已有预览按 motion-template-to-video 的文件核验分支执行。starter 默认停在可编辑草稿,但用户本次明确要求成片或导出时,以用户范围为准。+需要新渲染的导出/成片交付读 [验证](verification.md)。已有适用的导出任务时先查询,不重复提交;验证依据须对应实际 revision 和文件。原样使用模板按 motion-template-to-video 在编辑器中交付,不导出。starter 默认停在可编辑草稿,但用户本次明确要求成片或导出时,以用户范围为准。## 防止漏读、重复与循环diff --git a/skills/motion-production/references/verification.md b/skills/motion-production/references/verification.mdindex fb74f1eb..6bc02998 100644--- a/skills/motion-production/references/verification.md+++ b/skills/motion-production/references/verification.md@@ -1,6 +1,6 @@# Review and delivery verification-Unchanged template preview reuse follows motion-template-to-video: confirm the actual preview exists and decodes, then deliver its copy without rendering, comparison or a fabricated export job. The fresh-export and job/revision checks below apply when a new render is required.+Unchanged template delivery follows motion-template-to-video: confirm the template loaded and plays in the editor, without rendering, comparison or a fabricated export job. The fresh-export and job/revision checks below apply when a new render is required.Use separate evidence for creative quality, technical media integrity and playback. Each check is `passed`, `failed` or `not_run`; a missing tool or an unseen render cannot become `passed`. Scores are optional diagnostics, never the acceptance criterion.diff --git a/skills/motion-template-to-video/SKILL.md b/skills/motion-template-to-video/SKILL.mdindex 7b055a64..c26f40fd 100644--- a/skills/motion-template-to-video/SKILL.md+++ b/skills/motion-template-to-video/SKILL.md@@ -15,7 +15,7 @@ The accepted installation experience follows [first-run defaults](../motion-prod## Open the supplied project-A template is a complete native HyperFrames project, not necessarily a catalog entry. For a supplied folder or ZIP, inspect/unpack it and make a working copy when editing or rendering is needed; resume that copy on later turns. Read `index.html`, native configuration and `TEMPLATE.md` (older templates may have `EDITING.md`/`REPLICA.md` instead) for changes or a fresh render. Unchanged video delivery needs the preview's identity and decode check, plus the editable preview handoff below. Preserve source, assets and hidden Studio manifests. Do not require `template.json`, a local template ID or catalog registration.+A template is a complete native HyperFrames project, not necessarily a catalog entry. For a supplied folder or ZIP, inspect/unpack it and make a working copy when editing or rendering is needed; resume that copy on later turns. Read `index.html`, native configuration and `TEMPLATE.md` (older templates may have `EDITING.md`/`REPLICA.md` instead) for changes or a fresh render. An unchanged request needs only the editable preview handoff below. Preserve source, assets and hidden Studio manifests. Do not require `template.json`, a local template ID or catalog registration.If the user selected a gallery/catalog item instead, read its exact source/guide and ID, then follow [catalog capabilities](../motion-production/references/templates.md). Bundled projects use `motion_create_project` with projectType=template, templateId, requestId, title and requirements only when the selected project has not already been created. Editable registry sources are inspected and adapted from their real source and assets; builtin and Prism catalog templates can create a project with projectType=template. For discovery call motion_list_templates, read or grep/jq the returned local JSONL index, and call motion_get_template for the chosen ID. Known IDs can go directly to motion_get_template. Preserve the instructions and review limitations in TEMPLATE.md. An external reference video is not an editable template: ordinary video recreation uses [motion-recreate](../motion-recreate/SKILL.md); a request to produce a reusable template uses [motion-video-to-template](../motion-video-to-template/SKILL.md). Correct the route once, carrying the selected source and scope, rather than substituting an unrelated example.@@ -23,9 +23,9 @@ See the [portable project contract](../motion-production/references/portable-proFor a plugin-managed artifact, use the [runtime adapter](../motion-production/references/production.md): confirm projectId/session ownership with `motion_get_project`, use `motion_import_assets` for supported local media, then read the current revision/version and save through `motion_edit_project` with projectId, requestId, expectedRevision and expectedVersionId. A real conflict requires reading the newer source and forming the edit again; preserve Studio changes and never bypass the guard or replay an old full file. For an independent folder/ZIP, work on its actual source/copy and record before-edit file evidence; a revision from an unrelated active MCP artifact cannot protect this directory. The MCP has no general folder/ZIP adoption or binary/font import Tool; use host capabilities for independent portable projects and report unavailable steps honestly.-## Unchanged: deliver the preview; changed: edit the working project+## Unchanged: open it in the editor; changed: edit the working project-With no requested changes to the supplied template, deliver its `preview.mp4`, which represents that source. Copy it into the current workspace (for example as `<template-name>.mp4`) without re-rendering, re-encoding or comparing it. On a continued project that has already been edited, the original template preview is no longer the current result: reuse an applicable completed export or render the latest inspected source/revision. Otherwise render only when the template has no preview (older or gallery projects) or the user explicitly asks for a fresh render. Use the existing working project, or create a copy once, without re-creating its design or changing its content/assets, using the pinned HyperFrames runtime identified in the project notes. Read its authoring guide/help via resources/read `motion://engine/SKILL.md` or the installed guide; managed project details return hyperframesCli/authoringGuide paths. Do not open Studio merely to locate a runtime. Render an independent directory directly with host shell capabilities, for example with HyperFrames 0.9.7:+With no requested changes to the supplied template, the editable preview handoff below is the delivery: the template's own `preview.mp4` already represents that source, so do not render, export, copy or compare it. If the editor cannot show this source (for example an independent folder the handoff cannot adopt), state that limitation and give the absolute path of its `preview.mp4` after confirming the file exists, decodes and belongs to this unchanged source. On a continued project that has already been edited, the original template preview is no longer the current result. Render or export only when the user asks for a video file. Use the existing working project, or create a copy once, without re-creating its design or changing its content/assets, using the pinned HyperFrames runtime identified in the project notes. Read its authoring guide/help via resources/read `motion://engine/SKILL.md` or the installed guide; managed project details return hyperframesCli/authoringGuide paths. Do not open Studio merely to locate a runtime. Render an independent directory directly with host shell capabilities, for example with HyperFrames 0.9.7:```shnode /absolute/path/to/hyperframes/bin/hyperframes.mjs render /absolute/path/to/project-copy -o /absolute/path/to/output.mp4@@ -41,14 +41,14 @@ When a reading hold shifts later pictures, inspect existing audio timing too. Pr## Open the editable result-Once this turn's requested HTML is ready, complete the [editable preview handoff](../motion-production/references/native.md#editable-preview-handoff) automatically, before export or delivery. This applies to unchanged templates, edited templates and drafts, including requests that only mention the video. Copying an existing `preview.mp4` still follows this step when the template HTML is available; it does not require a fresh render. Use the same working project and report any independent-folder adoption limitation described in the handoff.+Once this turn's requested HTML is ready, complete the [editable preview handoff](../motion-production/references/native.md#editable-preview-handoff) automatically, before export or delivery. This applies to unchanged templates, edited templates and drafts, including requests that only mention the video. An unchanged request needs no render or export for this step. Use the same working project and report any independent-folder adoption limitation described in the handoff.## Verify and deliver-For an unchanged request delivered from `preview.mp4`, only probe that the copied file exists and decodes; do not compare it with anything. If you had to render because there was no preview, decode/probe the output and inspect representative frames. For an edited request, decode/probe the actual exported MP4 and inspect representative frames.+For an unchanged request, confirm in the editor that the intended template loaded and plays; unless the user asks for a video file, do not render, export or compare it. For an edited request, play the changed content and its related motion and sound in the editor preview; native snapshots help with layout but do not show motion. Do not export unless the user asks for a video file, then verify that actual MP4.-For an edited request, inspect the requested content, its related layout/timing and unchanged sections against the template's `preview.mp4`. Verify that supplied replacement assets are actually used and old brand content does not remain at another relevant appearance. Record passed, failed and unrun checks separately in the copy's `TEMPLATE.md`. Save output files in the current workspace and link them by absolute local path, with only the plain path in each link target. For the editable Studio page, use the exact previewUrl from the handoff. Keep the reply short and in the user's words: the MP4, the edited project when applicable, one or two sentences on what changed, and only the limitations the user would notice. For an unchanged request, use one completion sentence and the playable MP4; the editable page remains open in the host. An accepted first-run experience follows the [first-run delivery and contextual invitation](../motion-production/references/templates.md#first-run-experience-defaults), including its limited exceptions, instead of adding project screenshots or technical evidence. Humans decide visual acceptance; do not give a subjective pass/fail verdict. Do not claim independent-agent verification unless a separate session actually performed it.+For an edited request, inspect the requested content, its related layout/timing and unchanged sections against the template's `preview.mp4`. Verify that supplied replacement assets are actually used and old brand content does not remain at another relevant appearance. Record passed, failed and unrun checks separately in the copy's `TEMPLATE.md`. The project open in the editor is the deliverable. Do not copy, link or attach MP4s or other files unless the user asks for them; save requested files in the current workspace and link them by absolute local path, with only the plain path in each link target. For the editable Studio page, use the exact previewUrl from the handoff. Keep the reply short and in the user's words: one or two sentences on what changed and only the limitations the user would notice. For an unchanged request, use one completion sentence; the editable page remains open in the host. An accepted first-run experience follows the [first-run delivery and contextual invitation](../motion-production/references/templates.md#first-run-experience-defaults), including its limited exceptions, instead of adding project screenshots or technical evidence. Humans decide visual acceptance; do not give a subjective pass/fail verdict. Do not claim independent-agent verification unless a separate session actually performed it.-For edited or freshly rendered requests, apply the relevant [review standards](../motion-director/references/motion-review.md); changed multi-scene relationships use [production decisions](../motion-director/references/production-decisions.md), and sound changes load the shared context's sound references. These standards do not restart original creative intake or impose a new style on the template. For a fresh managed export, follow [verification](../motion-production/references/verification.md) using the completed job/revision; reuse a matching existing job. Copied unchanged previews use only the existence/decode branch above and create no export job. Stop at the user's requested delivery stage; a draft or review-only request does not automatically render.+For edited or freshly rendered requests, apply the relevant [review standards](../motion-director/references/motion-review.md); changed multi-scene relationships use [production decisions](../motion-director/references/production-decisions.md), and sound changes load the shared context's sound references. These standards do not restart original creative intake or impose a new style on the template. For a fresh managed export, follow [verification](../motion-production/references/verification.md) using the completed job/revision; reuse a matching existing job. Without a request for a video file, create no export job. Stop at the user's requested delivery stage; a draft or review-only request does not automatically render.If source edits change exposed variables, keep those shortcuts connected or remove stale declarations and explain the source editing entry. A variable declaration alone does not prove the control still works.