Skip to content

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.

feat(skills): share material sourcing priorities across production routes (#346)

open-design-crew[bot]66431d76890a
diff --git a/README.md b/README.md
index 0929d8e9..22136404 100644
--- a/README.md
+++ b/README.md
@@ -399,6 +399,8 @@ Reference-only entries start a reconstruction workflow. When editable source is
## 🛠️ Setup and technical documentation
+When choosing or replacing media, creation workflows share a [material sourcing policy](skills/openmotion-production/references/materials.md): reuse suitable supplied assets, prefer original sources for established subjects, and create original/supporting visuals as needed. Explicit user constraints and each workflow’s supported scope still apply.
+
### Install from source
For agent-led installation, use the [installation instruction above](#quick-start). To run from source, follow the steps below.
diff --git a/docs/openmotion-director.md b/docs/openmotion-director.md
index 76c908c2..6307cafe 100644
--- a/docs/openmotion-director.md
+++ b/docs/openmotion-director.md
@@ -5,7 +5,7 @@
This update integrates the creative guidance developed after v1.4.5. The existing five Skill routes, eleven public Tools, MCP Resources, editable-preview handoff and requested-export boundary remain unchanged.
- Describe a concrete visual event and its recognizable result, then design materials, subject motion, framing and timing together. Reference analysis transfers the viewing mechanism rather than copying a color palette or transition name.
-- Select or acquire materials within the task's permissions; inspect identity, structure, quality and controllability at the largest intended framing. Programmatic graphics remain valid final materials when they fit the film.
+- Use the [shared material policy](../skills/openmotion-production/references/materials.md) for source priorities, acquisition and usability checks. Director decisions retain the relationship between materials, subject motion, framing, time and state.
- Keep the subject's important change legible when framing, occlusion and camera motion also change. Test difficult views and geometry before expanding the film.
- Prototype the representative creative risk, including middle or ending sections when relevant. Preserve accepted implementations and timing while adding context; a successful opening does not validate the remaining film.
- Choose sound materials and timing order for the task, then cross-check actual visible action phases against real audio events. Shared edit and verification guidance invalidates affected timing evidence after changes and separates technical integrity, player operation, event timing and normal-speed perception.
diff --git a/docs/product/architecture.md b/docs/product/architecture.md
index dc9384be..0ce53d02 100644
--- a/docs/product/architecture.md
+++ b/docs/product/architecture.md
@@ -137,6 +137,8 @@ README 参考 OpenDesign 的产品导览和 HTML Anything 的贡献、来源表
后续需求应注明改变了哪一步、影响哪些角色,以及用户能观察到的完成条件。
+Asset selection, acquisition and replacement use the shared [material policy](../../skills/openmotion-production/references/materials.md) across all five production routes. Source priority is a host-Agent decision within existing workflow scope and user constraints; this does not add a search/generation backend or trigger acquisition for preview/export-only work.
+
## 职责分层与依赖方向
产品由“创作决策、素材执行、原生编辑、成片交付”串成完整流程。Agent 和人都可以提出修改,但媒体模型、编辑器与渲染器各自只承担本层工作。新增能力应先明确落在哪一层,再确定入口;不能因增加一个按钮就建立另一套工程或任务状态。
@@ -195,7 +197,7 @@ Preview/export preflight and the bundled OpenMotion lint command use the pinned
| 产品服务与代理 | `server.ts`、`editor-server.ts` | 通用会话 API `/design-api/`、兼容 `/motion-api/`,原生 API `/api/` |
| 引擎与生命周期 | `hyperframes.ts`、`preview.ts`、`editor-runtime.ts`、`shared/owned-studio.mjs` | 锁定 Hyperframes;macOS 共享后台与 Studio 守卫,校验身份/版本/目录并管理崩溃清理 |
| 导出与质量验证 | `server.ts`、`scripts/verify-export.ts`、制作 skills | 独立快照、后台渲染、技术验证;视觉审阅另行完成 |
-| Skill 路由与文档读取 | `skills/`、`shared/workflow.ts`、`mcp.ts` | production 通用工程入口 + 可直达 director + openmotion-template-to-video + openmotion-recreate 实际流程 + openmotion-video-to-template(五个入口均分发);26 份唯一文档含共享 edit(27 个 workflow/section 地址,portable 共享),具有 canonical ID/哈希/引用映射,按需读取,不自动执行或强制编排;见 [调用契约](../skills.md) |
+| Skill 路由与文档读取 | `skills/`、`shared/workflow.ts`、`mcp.ts` | production 通用工程入口 + 可直达 director + openmotion-template-to-video + openmotion-recreate 实际流程 + openmotion-video-to-template(五个入口均分发);27 份唯一文档含共享 edit/materials(28 个 workflow/section 地址,portable 共享),具有 canonical ID/哈希/引用映射,按需读取,不自动执行或强制编排;见 [调用契约](../skills.md) |
| 动态叙事指导 | `skills/openmotion-director/` | v1.5.5 guides concrete visual events, material/motion design, representative prototypes and actual audiovisual phases; shared edit/verification preserve locked content and evidence scope. Five routes, eleven public Tools and editor-first handoff remain unchanged. Cross-task reliability and native model audiovisual review remain unverified; see [director guidance](../openmotion-director.md). |
源码位置的详细映射见 [编辑器开发指南](../editor-fork.md),引擎适配见 [Hyperframes 集成](../hyperframes.md)。
diff --git a/docs/product/changes.md b/docs/product/changes.md
index ddeeee54..50b67c38 100644
--- a/docs/product/changes.md
+++ b/docs/product/changes.md
@@ -1,5 +1,13 @@
# 公开变更记录
+
+## 2026-11-13: Share material sourcing priorities across production routes
+
+- Centralize source priority, acquisition and usability checks in one shared material reference: explicit choices first, suitable existing assets next, original sources for established subjects, and generated/procedural content for original or supporting expression.
+- Link all five canonical Skills conditionally, retain compatibility forwarding entries, and expose the reference through the canonical workflow resource and legacy URI alias. Existing media support, reference fidelity and preview/export-only scope remain unchanged.
+- Consolidate the director, intake, template and execution rules rather than maintaining competing acquisition policies. No new media service, Tool, permission or release is introduced.
+- Retain the prior local Harry Potter trial as a single execution observation: one user message, original footage retrieved and used, ten excerpts totaling 20.5 seconds in a 32-second film. It is an existing example and a prior local snapshot, not a behavioral rerun of this PR head, a generalization result or a listening/visual acceptance claim. The viewing copy is attached to the PR; film media and private traces are excluded from product distributions.
+
## 2026-11-12: Version motion guidance source in the product repository
- Import 286 public guidance templates with stable IDs, existing eleven-locale metadata and authored text examples; preserve pending conversion state and original source attribution.
diff --git a/docs/skills.md b/docs/skills.md
index 40403fd6..01197dea 100644
--- a/docs/skills.md
+++ b/docs/skills.md
@@ -51,7 +51,7 @@ MCP 工具说明和领域执行位于 `mcp-tools.ts`;`mcp.ts` 保留初始化
| Skill | workflow 短 ID | section |
| --- | --- | --- |
-| openmotion-production | production(默认) | start、context、intake、templates、native、production、verification、edit、portable |
+| openmotion-production | production(默认) | start、context、intake、templates、native、production、verification、edit、portable、materials |
| openmotion-director | director | start、actions、craft、phrases、decisions、sound、review、examples |
| openmotion-template-to-video | template | start |
| openmotion-recreate | recreate | start、rebuild、verification |
@@ -71,6 +71,10 @@ Gallery prompts carry the guide URL and exact template ID; the host reads the gu
## 共享质量与工具边界
+When selecting, obtaining or replacing media, all five routes conditionally read the [shared material policy](../skills/openmotion-production/references/materials.md), exposed as `openmotion://workflow/production/materials`. It owns source priorities, acquisition and usability checks; director decisions retain material/motion, timing and state relationships. Viewing, previewing or exporting existing content does not trigger acquisition. User constraints, supported workflow scope and reference fidelity remain authoritative; no new generation or retrieval Tool is introduced.
+
+A prior local trial used only “做一个哈利波特宣传片” in a fresh gpt-6.1-sol/high session, with no supplied media or follow-up sourcing prompt. It retrieved the Warner Bros. trailer and official imagery/wordmark, using ten original excerpts totaling 20.5 seconds in a 32-second 1080p30 MP4. Selected/project hashes and exported frames were checked. That trial used runtime 0.6.1 and director 1.5.5; this PR preserves current main and canonicalizes the shared policy links. The attached sample is historical execution evidence, not a behavioral rerun of this PR head. Harry Potter is already a policy example; no causal, generalization, conflicting-upload or full playback/listening claim follows from this single run.
+
修改已有内容时,五个入口按需接入 [共享修改流程](../skills/openmotion-production/references/edit.md),MCP resource 为 `openmotion://workflow/production/edit`;不新增自动触发的 motion-edit。该流程确定变化、保持项及连带影响,基于当前源文件修改,并核对受影响区间、邻接转场、声画锚点和后续再现。初次创建默认草稿、仅打开预览或复用成片链接不因此重走修改流程。
首次缺少的规范和源文件须通过完成的工具调用先返回模型,再执行依赖操作;不能在同一个外层调用里补读并写入/套模板。完整正文仍可用时直接复用。长文档按实际返回预算分批,识别截断后补缺口;命令成功或 STATE 阅读记录均不能代替实际正文。此为宿主 Agent 的执行指导,MCP 未增加无法证明模型阅读状态的硬门禁。
@@ -87,7 +91,7 @@ Gallery prompts carry the guide URL and exact template ID; the host reads the gu
| --- | --- | --- |
| [SKILL.md](../skills/openmotion-recreate/SKILL.md) frontmatter description | 触发范围按动态图形复刻描述 | 支持新视频类型后同步触发范围,并重跑选路测试 |
| SKILL.md Role and goal 第二段 | 只支持动态图形;实拍、口播、AI 视频说明不支持,不暗示给素材就能复刻,只提出动态图形版 | 放宽支持范围,缩小拒绝条件 |
-| SKILL.md §3 素材缺口(“This package exposes no generation Tool”) | 缺图片、片段、声音时用用户素材、询问,或提出宿主实际已有的生成工具 | 本包公开生成 Tool 时改写此句,补调用、采用结果和失败处理规则 |
+| SKILL.md §3 素材缺口(“This package exposes no generation Tool”) | Within supported media scope, use shared materials guidance for missing assets; ask only for unresolved inputs or access/capability limits. No generation Tool is added | 本包公开生成 Tool 时改写此句,补调用、采用结果和失败处理规则 |
| [production.md](../skills/openmotion-production/references/production.md) 第 3 条 | 一期 MCP 包不提供生成 Tool,生成交给宿主或 Studio | 与上一行同步修改 |
| SKILL.md §5 Sound | 默认沿用原片音轨并重新对齐;删去念出原品牌的旁白 | 有 TTS 后可改为重新配音,不只删除 |
| SKILL.md §5 原片作底层(用户自有成片只改几处细节) | 仅此情况可把原片放在时间线上并打补丁 | 支持实拍局部修改或分镜混排时扩展适用条件 |
diff --git a/shared/workflow.ts b/shared/workflow.ts
index 12ac308e..7336e4d0 100644
--- a/shared/workflow.ts
+++ b/shared/workflow.ts
@@ -18,6 +18,7 @@ export const workflowRegistry = {
native: 'skills/openmotion-production/references/native.md',
edit: 'skills/openmotion-production/references/edit.md',
portable: 'skills/openmotion-production/references/portable-project.md',
+ materials: 'skills/openmotion-production/references/materials.md',
},
},
director: {
diff --git a/skills/openmotion-director/SKILL.md b/skills/openmotion-director/SKILL.md
index 915a8827..1bcb6c97 100644
--- a/skills/openmotion-director/SKILL.md
+++ b/skills/openmotion-director/SKILL.md
@@ -41,7 +41,7 @@ MCP-only 使用 resources/read `openmotion://workflow/director/start` 读取本
确认受众、主要信息、期望感受或行动、发布规格、事实依据、素材与声音需求。检查实际工具、素材和渲染能力;真实界面演示与概念化表达分开标注。
-当需要取得/创作素材、现有主视觉质感不足,或任务含截图、跨段复现、多段落及展示感问题时,读取 [制作决策与状态延续](references/production-decisions.md)。用户不提供素材时,由Agent按任务允许的生成或检索途径补齐;素材来源、质量、占时与状态复用应落实到工程。
+需要选择、获取或替换素材时读取 [共享素材规范](../openmotion-production/references/materials.md)。现有主视觉质感不足,或任务含截图、跨段复现、多段落及展示感问题时,另按需读取 [制作决策与状态延续](references/production-decisions.md),落实材料与动作、占时及状态复用的关系。
已有成片或审片反馈时,先看实际问题区间,把仍未解决的现象与保留的有效部分作为本次创作输入;不要把用户指出的展示感缩减成几个接点或字号问题。
diff --git a/skills/openmotion-director/references/production-decisions.md b/skills/openmotion-director/references/production-decisions.md
index 7d8b68d7..1bdfeef2 100644
--- a/skills/openmotion-director/references/production-decisions.md
+++ b/skills/openmotion-director/references/production-decisions.md
@@ -1,22 +1,10 @@
# 把导演判断落实到素材、时间和状态
-用于素材取得与质量、截图、跨段复现、多段强 Motion,或已有展示感/状态回退问题的任务。复用动作脚本和审片记录,不新增必填表。它约束判断与实现的一致,不指定风格、镜头数、速度或具体转场。
+用于材料与动作配合、截图、跨段复现、多段强 Motion,或已有展示感/状态回退问题的任务。复用动作脚本和审片记录,不新增必填表。它约束判断与实现的一致,不指定风格、镜头数、速度或具体转场。
-## 用户不供素材时,由 Agent 补齐视觉材料
+## 让材料支撑实际动作
-用户没有素材或明确不愿提供时,在本次任务和既有授权内自主选择 **AIGC生成**、**网络检索**或组合使用;不继续把上传变成默认前置步骤。沿用禁止联网/生成、限用现有素材等明确约束。方案或只读审片不因此自动启动生成。
-
-按素材职责选路,不固定先生成或先搜索:
-
-- **真实品牌与具体商品**:优先取得可核对的官方产品图、媒体包或有明确可用依据的素材,核对型号、配色和外观。相似商品不能冒充指定商品。AIGC可补氛围、场景和概念视觉;生成图不证明真实产品细节或功能。
-- **概念品牌、自设产品或独特主视觉**:可生成符合目标质感的产品图、背景或短片;先选定一份合格的主体,再用可用的参考编辑/派生能力维持不同镜头的身份。不要为每镜头独立重造产品。
-- **排印、图形与数据表达**:HTML/SVG/3D等程序化材料可直接成为最终媒介。根据观看效果选择,而非因没有附件就默认用廉价几何图替代产品质感;也不为纯文字片强行生成照片。
-
-生成时把片中职责写进输入:主体与所需状态、材质/光向/视角、构图、可放文字的空间,以及抠图或拆层需要;需要连贯物体动作时选择可支持该动作的素材形式。用实际可用工具,查看真实完成的结果;排队成功不算取得素材。已有素材先复用,失败时按原因修正或切换允许的来源,不无依据地重复生成。
-
-检索时从内容与镜头需要出发,回到原始来源取可用原文件,记录来源页面及使用依据。搜索缩略图只用于筛选,不能当作足够清晰的成片资产;可下载不自动代表可商用。来源或使用依据不成立时选其他来源或自行生成,不把不确定资产默默混入交付。
-
-**在实际最大取景下检查素材**:主体轮廓和细节是否清晰,外观/结构/文字有无错误,光影与材质是否达到目标,跨镜头身份是否一致,裁切和背景是否支持构图与所需动作。不合格就更换/修正材料,再扩建影片。成功生成、分辨率标称高或文件已导入都不能代替该检查。
+素材来源优先级、取得方式和可用性检查统一使用 [共享素材规范](../../openmotion-production/references/materials.md);本页负责材料与动作、时间及状态的配合。
围绕关键动态片段联合选择材料与实现:先确认素材可控制的对象、状态、视角与遮挡,用实际材料做成关键变化,再扩充其余素材。主体一致性是设计身份一致,不要求各镜头复用同一姿态;派生状态仍须核对身份与结构。真实结构动作需要相应分层/模型、状态或连续视频;材料不支持时换表达,并调整相关编排与时长。
diff --git a/skills/openmotion-production/SKILL.md b/skills/openmotion-production/SKILL.md
index aa4a0398..2dbe51b9 100644
--- a/skills/openmotion-production/SKILL.md
+++ b/skills/openmotion-production/SKILL.md
@@ -21,7 +21,7 @@ Agent 根据本轮意图选择入口,专业任务可直接进入对应 Skill
1. 修改已有内容时读取 [共享修改流程](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;画面锁定时保持视觉内容。补读结果先返回模型,后续调用再执行依赖操作。
+3. 需要选择、获取或替换素材时读取 [共享素材规范](references/materials.md);按共享上下文补齐其他受影响的质量规范。换现成音乐、调音量也需核对声画锚点与原有 SFX;画面锁定时保持视觉内容。补读结果先返回模型,后续调用再执行依赖操作。
4. 检查受影响区间、接点和保持项。需要新渲染的导出或成片交付读取 [验证](references/verification.md),针对已审查 revision/versionId 导出,已有适用任务先查询并复用;模板出片按专业入口在编辑器中核验,需要导出时检查实际 MP4。技术通过与创作品质、正常播放及试听分别记录。
5. 停在用户要求的方案、预览、工程或成片阶段。交付实际结果、检查与必要限制。编辑器中打开的工程就是交付物,只有用户明确要 MP4、视频文件、下载或导出时才附 MP4。
diff --git a/skills/openmotion-production/references/context.md b/skills/openmotion-production/references/context.md
index 72e48ca4..c461f4f2 100644
--- a/skills/openmotion-production/references/context.md
+++ b/skills/openmotion-production/references/context.md
@@ -31,6 +31,7 @@ If OpenMotion tools are unavailable or fail, disclose the connection status and
| 本次范围 | 必需参考(可复用已读正文) |
| --- | --- |
+| 需要选择、获取或替换素材,含原创、模板适配、复刻与局部修改 | [素材选择与来源优先级](materials.md);沿用所选路线的能力和保持项;仅查看、预览或导出既有内容不触发 |
| 原创新片/大幅重编 | [动作脚本](../../openmotion-director/references/action-script.md)、[动态表现](../../openmotion-director/references/motion-craft.md)、[动作短句](../../openmotion-director/references/motion-phrases.md)、[审片](../../openmotion-director/references/motion-review.md) |
| 新设计声音叙事或工程音轨调整,含画面锁定 | [声音叙事](../../openmotion-director/references/sound-narrative.md)、[动作脚本的声画锚点](../../openmotion-director/references/action-script.md)、审片;只应用声音相关内容,不启动原创流程 |
| 原样使用模板、不做修改 | Follow openmotion-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. |
diff --git a/skills/openmotion-production/references/intake.md b/skills/openmotion-production/references/intake.md
index f1ea5852..837f987d 100644
--- a/skills/openmotion-production/references/intake.md
+++ b/skills/openmotion-production/references/intake.md
@@ -7,16 +7,16 @@ Start from the conversation and current project. If an existing production folde
| Input | Ask or inspect | Decision rule |
| --- | --- | --- |
| Goal | Product/topic, audience, one thing to remember, CTA | Do not invent a feature, claim, metric, testimonial or offer. |
-| Material | Supplied images/video, logo, approved copy, local paths or accessible URLs | Reuse usable assets with provenance. If the user has no assets or declines to provide them, use [asset decisions](../../openmotion-director/references/production-decisions.md) to obtain or create the missing material within scope. Reference footage is not automatically final material. |
+| Material | Supplied images/video, logo, approved copy, local paths or accessible URLs | When selecting, obtaining or replacing material, apply the [shared material policy](materials.md), including the intended role of supplied references. |
| Delivery | Destination, dimensions/aspect ratio, fps, duration, sound requirement, language | Record the native composition specification. A silent result cannot fulfill an unresolved voiceover request; identify the actual sound source. |
| Direction | Reference, brand rules, examples to avoid, template preference | Follow the chosen route. Recommend a creative direction when needed; template choice applies only to a template task and may already be resolved or delegated. |
| Constraints | Must-show details, protected copy, deadline or generation budget when relevant | Preserve explicit choices. Do not ask about paid APIs when this local workflow needs none. |
Example first message in the user's language:
-> 我会沿用已有资料,补齐本次需要的信息,再确定创作方向。还缺:视频要让谁记住哪一句话;准确文案;现有素材直接复用,缺少的素材由我按本次范围生成或检索;希望多长、发在哪里、是否需要配音或音乐;喜欢的参考风格。如果你没有风格偏好,我会给出几个适合现有素材的方案。
+> 我会沿用已有资料,补齐本次需要的信息,再确定创作方向。还缺:视频要让谁记住哪一句话;准确文案;素材按已确认用途和共享规范选用、补齐;希望多长、发在哪里、是否需要配音或音乐;喜欢的参考风格。如果你没有风格偏好,我会给出几个适合现有素材的方案。
-Shorten this to the actual gaps. Offer sensible choices for preferences; ask factual questions without inventing answers. Missing product assets trigger scoped acquisition/creation first; only an unresolved identity, permission or unavailable capability blocks the affected shot. Do not repeatedly request uploads after the user has declined. An explicitly requested template starter can use its default text and graphics without optional asset questions; record that starter scope and distinguish it from a finished product film.
+Shorten this to the actual gaps. Offer sensible choices for preferences; ask factual questions without inventing answers. Use the shared material policy for material gaps; only an unresolved identity, permission or unavailable capability blocks the affected shot. An explicitly requested template starter can use its default text and graphics without optional asset questions; record that starter scope and distinguish it from a finished product film.
## Production folder
diff --git a/skills/openmotion-production/references/materials.md b/skills/openmotion-production/references/materials.md
new file mode 100644
index 00000000..25efb283
--- /dev/null
+++ b/skills/openmotion-production/references/materials.md
@@ -0,0 +1,25 @@
+# 共享素材选择与来源优先级
+
+需要选择、获取或替换视觉与声音素材时读取;仅查看、预览或导出既有内容不触发本页。各制作入口共用此规则,沿用当前工程与创作决定,不重新选路。
+
+## 按素材职责确定来源
+
+用户明确的必用素材、参考用途、来源限制与视觉要求优先于以下默认顺序。同一视频可组合不同来源,逐项判断当前素材承担的是身份呈现、事实证据、主体表演、图解还是氛围。
+
+1. **先复用合适的已有素材。** 检查用户上传、指定以及工程中已确认的材料,核对用途、相关性、身份、质量和使用依据。区分成片必用素材、风格参考与背景资料;上传不等于全部采用。用户要求必用的材料按指定用途保留,存在质量或内容冲突时说明具体影响。已有材料足够时直接复用,缺口再补齐。
+2. **既有对象的缺口,默认先检索对应原始素材。** 视频围绕有明确身份、原作或来源的既有对象时,无论真实还是虚构,主动上网检索,并优先将与该对象直接对应的原始素材用于成片,无需用户提醒。优先官方或原始发布来源,核对身份、版本、时期与镜头所需内容。例如哈利波特宣传片优先寻找对应角色、场景或影片素材,通用魔法题材画面不能替代其身份。具体商品还要核对型号、配色和结构。AIGC可补充氛围、转场与概念视觉;生成结果不能充当原作素材或事实证据。
+3. **原创与补充表达,按需要生成或程序化制作。** 自创对象、独特场景、氛围、图解以及用户指定的原创视觉,可优先使用AIGC或程序化材料,无需先穷尽网络检索。排印、图形与数据表达可直接使用HTML/SVG/3D等媒介;按观看效果选择。对应原始素材无法取得或不适用时,说明关键缺口及对表达的影响,再选择允许的替代表达,区分原始与生成内容。
+
+用户没有素材或明确不愿提供时,由Agent按上述规则自主补齐,不把上传作为默认前置步骤。沿用禁止联网/生成、限用现有素材等明确约束;仅方案或只读审片不因此自动启动生成、导入或工程修改。
+
+## 取得素材并核对可用性
+
+检索从内容与镜头需要出发,回到原始来源取得可用文件,记录来源页面及使用依据。搜索缩略图用于筛选;取得足够清晰的原文件后再用于成片。可下载不自动代表可商用。来源或使用依据不成立时换其他来源或允许的替代表达;仍保持主体身份与事实边界。
+
+生成时把片中职责写进输入:主体及所需状态、材质/光向/视角、构图、文字空间,以及抠图或拆层需要;需要连续动作时选择可支持该动作的素材形式。先选定合格主体,再用可用的参考编辑或派生能力维持跨镜头身份;各镜头可有不同姿态和状态。生成产品细节与功能仍须依据可靠来源核对。
+
+使用实际可用工具和既有授权,不虚构能力或默默增加付费依赖。查看真实完成的素材;排队成功不算取得文件。失败时按原因修正或切换允许的来源,不无依据地重复请求。
+
+在实际最大取景下检查主体轮廓、细节、结构与文字、光影材质、身份一致性,以及裁切、背景能否支撑构图和所需动作。不合格就更换或修正,再扩建影片。声音素材核对内容、可用时段和用途;实际听感另行试听,未审听如实记录。生成成功、标称分辨率高或文件已导入,都不能替代可用性检查。
+
+复用现有简报、动作脚本或素材记录,保留实际采用文件、来源、用途及重要限制,无需另建必填表。材料与具体动作、占时和跨段状态的配合,按需应用[制作决策与状态延续](../../openmotion-director/references/production-decisions.md)。
diff --git a/skills/openmotion-production/references/production.md b/skills/openmotion-production/references/production.md
index 7e9b1608..bc1a39ac 100644
--- a/skills/openmotion-production/references/production.md
+++ b/skills/openmotion-production/references/production.md
@@ -13,7 +13,7 @@ Use only the OpenMotion MCP Tools actually returned by tools/list. Read [Native
| Export | openmotion_export_request: immutable snapshot, background MP4, automatic lint and technical verification |
| Cancel | openmotion_export_cancel: explicit owned job, distinguish cancelling/cancelled/completed |
-For missing or inadequate media, use [asset decisions](../../openmotion-director/references/production-decisions.md) to choose generation, retrieval or a suitable graphic medium within the current task. Use available host tools or Studio and existing authorization; do not invent tool names or silently add paid dependencies. Inspect completed media at its actual largest framing before composing. A queued generation or imported file does not establish visual quality.
+When selecting, obtaining or replacing media, apply the [shared material policy](materials.md) within the selected workflow and existing authorization.
## Execution
diff --git a/skills/openmotion-production/references/templates.md b/skills/openmotion-production/references/templates.md
index 0e154041..3eeedd15 100644
--- a/skills/openmotion-production/references/templates.md
+++ b/skills/openmotion-production/references/templates.md
@@ -8,7 +8,7 @@ A copied gallery prompt deliberately contains only a guide link and template ID.
Only when a template choice remains unresolved, offer two or three relevant options, preferably with the user's actual material. Do not present all options when only one fits. Show ID/name, the concrete opening, shot sequence, duration, asset needs, visual difference and tradeoff. The recommendation is advisory until the user selects it or explicitly delegates the choice.
-For a requested starter draft, selected template defaults and graphics are usable without optional media. For an actual product film, adapt copy, sample brands and data to verified facts and use real assets wherever a scene makes a product-specific claim. Native HTML/SVG/CSS graphics are legitimate content when approved for the brief.
+For a requested starter draft, selected template defaults and graphics are usable without optional media. For an actual product film, adapt copy, sample brands and data to verified facts; apply the [shared material policy](materials.md) when selecting, obtaining or replacing assets.
## First-run experience defaults
diff --git a/skills/openmotion-recreate/SKILL.md b/skills/openmotion-recreate/SKILL.md
index cef78753..77c250ef 100644
--- a/skills/openmotion-recreate/SKILL.md
+++ b/skills/openmotion-recreate/SKILL.md
@@ -40,7 +40,7 @@ Parts the request does not cover keep the original. Requested changes are in sco
## 3. Ask at most once
-Ask only when the workspace and the request together still lack something only the user can supply (brand, product, claims, numbers, prices, logos, images), or when an ambiguity would materially change the result. With usable material in the workspace, do not ask who the film is for. Offer "you decide" where it fits. This package exposes no generation Tool: when a needed image, clip or sound is missing, use the user's material, ask for it, or offer a generation tool the host actually has; never generate a real logo, product photo or factual claim.
+Ask only when the workspace and the request together still lack something only the user can supply (brand, product, claims, numbers, prices, logos, images), or when an ambiguity would materially change the result. With usable material in the workspace, do not ask who the film is for. Offer "you decide" where it fits. When selecting, obtaining or replacing an image, clip or sound, apply the [shared material policy](../openmotion-production/references/materials.md) within this workflow's supported media scope. Ask for a material gap only when it cannot be resolved within the current scope, available sources and authorization. This package exposes no generation Tool; the policy does not add one or expand this Skill's media support.
Ask all of it in one batch through the host's question interface, in the user's language. If nothing is missing, do not ask. Do not ask about technical choices, intermediate approval or storyboards. After the answers, work through to the finished film without stopping.
diff --git a/skills/openmotion-reference-video/SKILL.md b/skills/openmotion-reference-video/SKILL.md
index c41f863c..81eb9512 100644
--- a/skills/openmotion-reference-video/SKILL.md
+++ b/skills/openmotion-reference-video/SKILL.md
@@ -9,4 +9,6 @@ description: OpenMotion 原生 Hyperframes 编写的兼容入口,供旧引用
直接读取 [共享上下文](../openmotion-production/references/context.md)、[运行规范](../openmotion-production/references/production.md) 和 [Native authoring](../openmotion-production/references/native.md),继续当前阶段,不返回总入口重做需求或选模板。托管工程通过 `openmotion_edit_project` 写入,须携带 projectId、requestId、expectedRevision 和 expectedVersionId;导出按 [验证](../openmotion-production/references/verification.md) 检查实际文件。
+需要选择、获取或替换素材时,按 [共享素材规范](../openmotion-production/references/materials.md) 执行;仅查看、预览或导出沿用既有素材。
+
MCP-only 使用 resources/read `openmotion://workflow/production/native` 获取全文。此兼容入口不是新的复刻专业能力。
diff --git a/skills/openmotion-template-to-video/SKILL.md b/skills/openmotion-template-to-video/SKILL.md
index 6dc965c1..77742755 100644
--- a/skills/openmotion-template-to-video/SKILL.md
+++ b/skills/openmotion-template-to-video/SKILL.md
@@ -13,6 +13,8 @@ Changes to existing content use the [shared edit workflow](../openmotion-product
The accepted installation experience follows [first-run defaults](../openmotion-production/references/templates.md#first-run-experience-defaults): use the exact template ID and unchanged sample content offered and accepted in this conversation, with that template's own duration. A single-template yes accepts it; a three-candidate yes needs clarification. Resume an existing experience project or create one independent copy once. Open its editable preview; export only if requested. Do not restart the template/assets questionnaire or substitute a fixed default. Initial installation reply rules and few-shots come from `docs/install.md`, section “Installation-success reply”; this Skill resumes creation after consent.
+When selecting, obtaining or replacing assets, read the [shared material policy](../openmotion-production/references/materials.md), preserving the template's agreed structure, motion and content constraints. An unchanged preview handoff does not trigger asset acquisition.
+
## 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. 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.
diff --git a/skills/openmotion-video-to-template/SKILL.md b/skills/openmotion-video-to-template/SKILL.md
index cdf7f9a3..47ca688a 100644
--- a/skills/openmotion-video-to-template/SKILL.md
+++ b/skills/openmotion-video-to-template/SKILL.md
@@ -13,6 +13,8 @@ Closely match the reference's pictures, composition, motion and pacing while pre
A reference plus change requests is not a phase-one workflow of this Skill. Deliver the faithful template first and report that requested changes belong to `openmotion-template-to-video` applied to the delivered template; do not mix changes into the rebuild.
+When selecting, obtaining or replacing source assets, read the [shared material policy](../openmotion-production/references/materials.md) within this workflow's supported media scope. Preserve the reference's identity and fidelity requirements; this does not authorize content substitutions or new generation services.
+
## Understand the requested result
Read the reference as a whole before choosing implementation. Inspect representative frames and continuous frames around important changes. Explain what persists, enters, changes, holds and exits; keep an object's identity across cuts when it is the same object. Learn from observable behavior rather than guessing the original author's code.
diff --git a/tests/public-names.test.ts b/tests/public-names.test.ts
index 0bb0dea8..eefb2e3e 100644
--- a/tests/public-names.test.ts
+++ b/tests/public-names.test.ts
@@ -12,7 +12,7 @@ test('default MCP discovery publishes only OpenMotion tool and resource names',
assert.equal(list.result.tools.length, 11);
assert.ok(list.result.tools.every((tool: any) => tool.name.startsWith('openmotion_')));
const resources: any = await rpc({ jsonrpc: '2.0', id: 2, method: 'resources/list' });
- assert.equal(resources.result.resources.length, 28);
+ assert.equal(resources.result.resources.length, 29);
assert.ok(resources.result.resources.every((resource: any) => resource.uri.startsWith('openmotion://')));
});
diff --git a/tests/workflow.test.ts b/tests/workflow.test.ts
index e9f7bcd0..4147e912 100644
--- a/tests/workflow.test.ts
+++ b/tests/workflow.test.ts
@@ -11,7 +11,7 @@ import { getWorkflow, workflowReferences, workflowRegistry, workflowSections } f
const root = fileURLToPath(new URL('../', import.meta.url));
const workflows = ['production', 'director', 'template', 'recreate', 'video-to-template'];
-const productionSections = ['start', 'intake', 'templates', 'production', 'verification', 'context', 'native', 'edit', 'portable'];
+const productionSections = ['start', 'intake', 'templates', 'production', 'verification', 'context', 'native', 'edit', 'portable', 'materials'];
const entries = Object.entries(workflowRegistry).filter(([name]) => workflows.includes(name)).flatMap(([workflow, definition]) =>
Object.entries(definition.sections).map(([section, documentId]) => ({ workflow, section, documentId, status: definition.status })));
@@ -34,15 +34,20 @@ function workflowCall(id: number, args?: any) {
test('MCP-only client discovers and reads the packaged workflow without starting a preview', async () => {
const directory = await mkdtemp(path.join(tmpdir(), 'motion-workflow-mcp-'));
try {
- const sections = productionSections.slice(0, 5);
+ const sections = [...productionSections.slice(0, 5), 'materials'];
const responses = stdio(directory, [
{ id: 1, method: 'initialize', params: { protocolVersion: '2025-11-25' } },
{ id: 2, method: 'tools/list' }, workflowCall(3),
+ { id: 20, method: 'resources/list' },
+ { id: 21, method: 'resources/read', params: { uri: 'motion://workflow/production/materials' } },
...sections.map((section, index) => workflowCall(index + 4, { section })),
]);
assert.match(responses.get(1).instructions, /resources\/read/);
assert.ok(!responses.get(2).tools.some((tool: any) => tool.name === 'openmotion_get_workflow'));
+ assert.ok(responses.get(20).resources.some((resource: { uri: string }) => resource.uri === 'openmotion://workflow/production/materials'));
assert.equal(responses.get(3).structuredContent.documentId, 'skills/openmotion-production/SKILL.md');
+ assert.equal(responses.get(21).structuredContent.documentId, 'skills/openmotion-production/references/materials.md');
+ assert.equal(responses.get(21).structuredContent.contentHash, (await getWorkflow('materials')).contentHash);
for (const [index, section] of sections.entries()) {
const result = responses.get(index + 4).structuredContent;
assert.equal(result.workflow, 'production');
@@ -100,6 +105,8 @@ test('every workflow document and linked reference is reachable over MCP with ca
for (const route of workflows) {
assert.ok(returned.get(workflowRegistry[route as keyof typeof workflowRegistry].sections.start).references.some((reference: { documentId: string }) =>
reference.documentId === 'skills/openmotion-production/references/edit.md'), `${route} must expose the shared edit workflow`);
+ assert.ok(returned.get(workflowRegistry[route as keyof typeof workflowRegistry].sections.start).references.some((reference: { documentId: string }) =>
+ reference.documentId === 'skills/openmotion-production/references/materials.md'), `${route} must expose the shared material policy`);
}
assert.deepEqual(await store.get(), before);
assert.deepEqual(await readdir(directory, { recursive: true }), filesBefore);