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.

docs: align public tool contract and CI publication boundaries

罗高5d1bc50c9649
diff --git a/docs/motion-extension-scope.md b/docs/motion-extension-scope.md
index fa909225..2abee738 100644
--- a/docs/motion-extension-scope.md
+++ b/docs/motion-extension-scope.md
@@ -5,8 +5,8 @@
## 当前分发与接口
- 五个正式入口均随一期插件和四宿主适配器分发。`motion-template-to-video` 使用 `motion://workflow/template/start`,`motion-video-to-template` 使用 `motion://workflow/video-to-template/start`;短 workflow ID 保持兼容,读取不会启动服务或创建工程。
-- 一期仅公开 [9 个 Tool](mcp-phase1-tools.md)。工程读取/文件读取/任务状态统一用 motion_get_project,托管源码保存用 motion_edit_project,批量导入用 motion_import_assets,导出和技术验证由 motion_export_request 负责。
-- 旧版独立比较、工作流读取、模板查询/管理等 handler 仅供内部兼容,不能在一期 Skill 中要求调用。模板目录和指引仍可通过 Studio 或宿主读取;既有私有模板文件不删除、不重写。
+- Phase one exposes [11 public Tools](mcp-phase1-tools.md): nine project Tools plus `motion_list_templates` and `motion_get_template`. Use `motion_get_project` for project/file/job reads, `motion_edit_project` for managed source changes, `motion_import_assets` for batch imports and `motion_export_request` for export and technical verification.
+- The two public catalog Tools provide the local template index and individual template details/instructions. Older standalone comparison, workflow-reading and template-management handlers remain internal compatibility only; Skills must not require those hidden calls. Existing private template files are preserved.
- 下载/分析参考、CLI 检查、原片对照视频与 ZIP 打包由宿主可用能力完成;工具不足须记录缺口。技术检查不代表人类视觉验收。
## 不改底座
diff --git a/docs/repository-migration.md b/docs/repository-migration.md
index f2125fe9..48d2feac 100644
--- a/docs/repository-migration.md
+++ b/docs/repository-migration.md
@@ -43,6 +43,6 @@ Upstream Studio/template attribution and font notices remain intact. Motion remo
## CI and acceptance
-`.github/workflows/ci.yml` installs locked dependencies, checks/builds Studio, runs focused packaging/workflow/recreation tests and Studio regression, and exercises the phase-one ZIP through all nine public Tools. npm is the default manual artifact format; complete Mac/Windows ZIP assembly remains available. Both formats reject publication. There are no artifact uploads, npm releases, storage publication or automatic merges.
+`.github/workflows/ci.yml` installs locked dependencies, checks/builds Studio, runs focused packaging/workflow/recreation tests and Studio regression, and exercises the phase-one ZIP through all eleven public Tools (nine project Tools and two catalog Tools). npm is the default manual artifact format; complete Mac/Windows ZIP assembly remains available. This CI workflow rejects publication and retains a candidate installation-guide preview for review; it does not publish npm/R2/Release artifacts or merge PRs. Separate manual [candidate and test publication controls](release-workflows.md) retain complete candidates and publish only after explicit authorization and their documented default-branch, environment and npm-trust prerequisites are configured.
Build success does not prove target-machine installation, loaded host Skills/MCP, model creation or visual acceptance. Validate exact artifacts independently, using isolated profiles. Current platform limits and instructions are in [test packages](test-packages.md).
diff --git a/docs/skills.md b/docs/skills.md
index cda4679d..29abbdbe 100644
--- a/docs/skills.md
+++ b/docs/skills.md
@@ -45,7 +45,7 @@ MCP 工具说明和领域执行位于 `mcp-tools.ts`;`mcp.ts` 保留初始化
共享 context 维护按任务范围的依赖清单。Agent 计算本次必需正文与仍可用的已读正文之差,只补缺口;完整正文返回后记录文档标识和版本,复用会话或已有 STATE,不在活动工程内存放阅读记录。声音专项明确需要 actions,模板明确需要 templates,多段模板也需要 decisions。阶段或轮次切换本身不触发重新加载;只在正文丢失、截断或版本变化时补读并记录原因。不遍历全部 references,也不因加载新文档重复工程操作。MCP 不维护模型的阅读状态,不新增读前写硬门禁;记录与文字约束不能强制宿主执行。
-画廊短指令携带指引 URL 和精确 ID;宿主读取该指引取得来源与路线,直接进入对应专业入口,不再统一回 production/start。一期没有模板查询 Tool,内部目录 handler 的 workflowGuide 字段不代表公开 MCP 可调用。仅 starter 默认不导出,用户明确要求成片时包含导出。
+Gallery prompts carry the guide URL and exact template ID; the host reads the guide and enters the corresponding specialist without returning to production/start. Phase one exposes `motion_list_templates` for the local catalog index and `motion_get_template` for a selected template's details and instructions. Legacy catalog handlers remain internal; use only the public contract. The starter does not export by default; a user request for a video file includes export.
## 共享质量与工具边界
diff --git a/skills/motion-video-to-template/SKILL.md b/skills/motion-video-to-template/SKILL.md
index 9f636a38..567fd11d 100644
--- a/skills/motion-video-to-template/SKILL.md
+++ b/skills/motion-video-to-template/SKILL.md
@@ -39,7 +39,7 @@ Do not pass off playback of the entire reference, a full-frame image sequence, t
Read the pinned native authoring guide and [runtime adapter](../motion-production/references/production.md). For a portable folder, create a separate working directory and use the pinned native CLI; this requires host filesystem/shell capabilities. For a managed project, reuse its projectId or create a carrier with `motion_create_project`: use projectType=reference_video with an actual HTTP(S) referenceUrl or known referenceVideoId; for a local video use projectType=natural_language and record the local reference/checksum in requirements. Include requestId, title and requirements. Creation records the source but does not analyze or recreate the video. Read sources/current versions with `motion_get_project`, import supported image/audio/video files with `motion_import_assets`, and save native text through `motion_edit_project` with projectId, requestId, expectedRevision and expectedVersionId. Read the new version after imports or GUI changes. Do not assume a catalog ID exists, write reserved metadata, or bypass managed-project version protection with direct filesystem writes.
-Read the guide via resources/read `motion://engine/SKILL.md`; managed project details return authoringGuide/hyperframesCli paths. Do not call `motion_open_preview` just to obtain paths: it runs lint and selects an existing project in Studio. Initial template packaging can run in the background; follow-up content edits apply the shared [continuing-edit preview rules](../motion-production/references/native.md#continuing-edits), with explicit background requests taking precedence. The nine public Tools do not download/analyze video, compare videos or package ZIPs. Use available host capabilities for those steps, and report a concrete capability gap instead of inventing a Tool or claiming a portable package was delivered.
+Read the guide via resources/read `motion://engine/SKILL.md`; managed project details return authoringGuide/hyperframesCli paths. Do not call `motion_open_preview` just to obtain paths: it runs lint and selects an existing project in Studio. Initial template packaging can run in the background; follow-up content edits apply the shared [continuing-edit preview rules](../motion-production/references/native.md#continuing-edits), with explicit background requests taking precedence. The eleven public Tools do not download/analyze video, compare videos or package ZIPs. Use available host capabilities for those steps, and report a concrete capability gap instead of inventing a Tool or claiming a portable package was delivered.
Use [reference measurement](references/measure.md) for questions that need exact timing, dimensions or layout. Use [rebuild guidance](references/rebuild.md) for grouping, media and edit dependencies. For an unfamiliar or difficult visual system, a short representative segment can establish a useful approach before expanding the film; this is advice, not a mandatory extra stage.