Skip to content
Back to search

motion-video

SkillWorks with Claude CodeGitHub

显式调用 Motion Skill / Motion video 时,优先继承已选影片的实际镜头与素材,制作连续品牌短片或原声解释视频;按需检查,不自动调用模型、上传或发布。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/derek-zhuolin--motion-skill/badge.svg)](/listings/derek-zhuolin--motion-skill)

HTML

<a href="/listings/derek-zhuolin--motion-skill"><img src="/api/listings/derek-zhuolin--motion-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

首次安装可使用官方 Skills CLI(Node.js 22.20+),按提示选择你的 Agent:

npx skills add derek-zhuolin/motion-skill --skill motion-video -g

通过上述方式安装、且没有在 Skill 文件夹内放自定义改动或私人文件时,之后只更新 Motion Skill:

npx skills update motion-video -g

这是已有 Skills CLI 的命令,不是本仓库新增的自动更新器。更新跟随安装来源;上面安装方式跟随仓库默认分支。**改过 Skill、手动复制或使用 Fork 的用户,先看[安装与更新](docs/UPDATING.md)**,不要直接覆盖。项目内安装使用 `-p` 更新;不要省略 `motion-video` 去更新所有 Skill。

**不会操作命令?** 把下面这句话直接发给你的 Agent:

> 请把我的 Motion Skill 更新到 https://github.com/derek-zhuolin/motion-skill 的最新版。先确认实际安装位置和来源,备份并保留我的修改、私人素材和已有视频;有冲突先告诉我。按原安装方式更新,不顺带更新其他 Skill,不上传文件。完成后核对版本与基本检查。

更新后让 Agent 核对实际安装目录里的 `package.json` 和 `CHANGELOG.md`;如果当前会话仍使用旧规则,新开会话后再调用。想接收后续发布消息,可在 GitHub 选择 `Watch → Custom → Releases`;下载过的副本仍需主动更新。

也可以保留原来的完整仓库安装方式,保持文件结构,显式调用 `/motion-video` 或 `$motion-video`。Skills CLI 的 Codex 安装通常在 `~/.agents/skills/motion-video`;手动安装也可能在 `~/.codex/skills/motion-video`。先确认实际使用的目录,避免重复安装;两种方式不会自动互相同步。

python3 scripts/motion.py doctor --deps "$PWD/node_modules"
python3 scripts/motion.py new --dest /tmp/my-motion-film --deps "$PWD/node_modules"

第二条先生成明确标注的**静音结构示例**。默认 `build` / `verify:frames` 只处理本片;新工程要浏览研究库时另运行 `npm run build:studies`,修改研究库时运行 `npm run verify:studies`。真实口播需要已核对的 transcript、story 和字幕数据,再带 `--media`、`--story`、`--transcript`、可选 `--captions` 创建新工程。见 [GETTING_STARTED](docs/GETTING_STARTED.md)。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 121 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: motion-video
  3. description: 显式调用 Motion Skill / Motion video 时,优先继承已选影片的实际镜头与素材,制作连续品牌短片或原声解释视频;按需检查,不自动调用模型、上传或发布。
  4. ---
  5. # Motion Skill · Motion video
  6. 公开测试版 **1.2.0-beta.1**。增加可选重点运镜、编排证据与音乐驱动律动;旧公开示范片、10个稳定 adapter 和既有工程保留。
  7. ## 默认入口:规范 → 编排清单 → 实现
  8. 只要本次要写或改 Remotion,先运行 `python3 scripts/motion.py preflight-remotion --project /absolute/project`,读取它定位的 **remotion-best-practices/SKILL.md**,再按任务读取具体分支。无需用户重复点名。只是找到文件不等于已读;记录实际读取路径、版本与 hash。缺失时按 `references/remotion-integration.md` 处理,不假称已调用、不静默联网安装。保留已可运行工程与内容准备工作。
  9. 动手前按 `references/semantic-orchestration.md` 给用户一张**简短镜头编排清单**:时间/本段意思、主焦点、主效果编号与名字、辅助效果、进出场和交接对象、选择原因、可读窗口。先说再做;这份清单不是新增逐镜审批。数字快照、数字变化、关键词层级、证据截图、主体运动的视频要分别判断。每镜一个主表达;效果数量随内容,不规定10或15组。
  10. 由当前 Agent 读内容和核对素材。对已覆盖的数字、关键词、真实素材等关系,填写 `assets/semantic-plan.example.json` 的结构,再运行 `select-motion plan.json --out selection.json --explain shot-plan.md`。这一步按语义与近期使用记录给适配候选,不能把同一套 AME 镜头顺序套到所有内容;相关性优先,变化不靠随机或硬凑。返回 planned 不代表已调用。实际导入 `production-registry.json` 中的组件后,记录 actual-used 清单并审查源代码与画面;没实现的研究保持 study_only。仅修改某一镜时只重选受影响镜头。新关系不必硬塞进这几类:可按 catalog 选研究并定制实现,在同一编排表中标 custom、来源编号和代码位置;用相关源码与实际画面验证,不冒称选择器或生产接线审计已通过。
  11. ## 先走最短的正确路径
  12. 读取项目 AGENTS、当前任务及用户选定的视觉基准。新 run 保留原件。本机已登记授权基准时运行 `python3 scripts/motion.py baselines`,有已选原片就使用 `reuse` 继承实际影片代码、字体和授权素材;**不要先用五类默认卡片模板重建它**。
  13. - **连续 Launch**:沿用用户选定影片的视觉语言。让一个载体贯穿发现、选中、展开、协作;按语义选少量转折,保留阅读停顿。
  14. - **原声解释**:沿用用户选定影片的字体、材质与节奏。同一视觉跨多句话,真实影像与示意关系分工;原声保持 1×,无视频不生成说话人脸。
  15. - **修改/复盘**:直接读目标工程的相关镜头和时间表,不重跑转写、信源研究、模板生成或全研究库。
  16. - **没有可用基准**:才用 `new` 建标注清楚的结构草稿,并按实际内容写镜头。默认五类 renderer 不是电影感模板,也不会自动调用研究适配器。
  17. `reuse` 只复制本机已登记源,不执行源脚本,不联网、不转写、不渲染。新工程初始是 reference_copy,旧时间和旧口播属于旧片;换内容时更新语义事件、字幕和资产映射后才能称为新片。没有登记源时准确报缺失,不静默降级为卡片片。
  18. ```sh
  19. python3 scripts/motion.py baselines
  20. python3 scripts/motion.py reuse --baseline my-reference --dest /absolute/new-run --deps /absolute/existing-node_modules
  21. # 基准需登记自己的授权工程;公开包不含作者私人基准。见 references/local-fastpatch.md。
  22. ```
  23. ## 语音:同一段只转写一次
  24. 先查已核对的项目 transcript 和 source hash;没有就查询缓存:
  25. ```sh
  26. python3 scripts/transcript_cache.py get --media /absolute/audio
  27. python3 scripts/transcript_cache.py put --media /absolute/audio --transcript /absolute/transcript.json --engine existing-local-engine
  28. ```
  29. 缓存默认位于本 Skill 的 `.local/transcript-cache`,不进入分享包。命中只证明源与转写文件匹配,仍需检查语言、词时标、覆盖范围和专名;不自动把 verified 改为 true。只做短样片时优先处理选段及少量上下文,不默认整段转写两遍。复用现有可用本地引擎;启动前记录输入 hash、范围、引擎、预计时长和超时。已有转写任务仍在运行时不要并行开第二种实现;确需切换时先确认旧任务已退出,再只补缺失范围。不因尾部卡住重复跑完全部内容。本 Skill 不内置 ASR 模型或自动切换服务。
  30. ## 已选视觉保持,编排按内容调整
  31. 用户要求延续已选效果时,先锁定字体、字号角色、配色、布局密度、材质、阴影、素材裁切与组件外观。调整的是当前内容的机制选择、对象交接与运动路径,不把换风格当作工作流升级。抽取通用组件不能丢掉原片的细节(如数字滚轮边缘渐隐、运动模糊、分隔符尺度);用参数继承这些视觉属性。无法对应时先报告差异,不静默换成默认皮肤。
  32. 合并或替换组件时,优先用同内容、同原声、同帧对照确认视觉变化。该检查只证明本次接入的范围,不能宣称所有片子自动保持同样审美。新内容仍需重新选择有意义的动效,不固定照搬已选片的镜头序列。
  33. ## 镜头与时间
  34. 先一个主焦点,再安排对象交接。保护正在读的对象,不冻结整幅画面;允许配角提前准备。转场必须解释深入、选择、联系、对比等语义,不能每句重开“标题+中央卡片”。音频、文字、遮罩与机位共用命名事件;需要新的组合时才读 `references/motion-combinations.md`。继承好片的字体、材质、运动习惯与连续性;镜头结构按当前语义重选。复用轨道原件,不固定使用旧片的镜头顺序。先写两种简短构思及取舍,再实现更适合当前意思的一种;不同关系不要总用同一组合。
  35. 真实素材和原 Logo 保留身份与来源;Interflow 默认蓝 #0070DB、黑 #141414、白和灰,不自动改米白。粘土适度,禁止为了动效加无意义漂移。音乐和效果音按已有授权复用;没有音源就明确静音,不编造节拍识别或效果数据。
  36. ## 可选:重点词运镜(可选 beta)
  37. 只有用户需要突出某个重点,或当前语义确实需要局部证据时,才按 [重点词运镜扩展](references/focus-camera.md) 显式启用。保留 Motion 材质与动作,只补两类景别:局部停留后拉远揭示;全貌推近关键词对应对象、停稳短注解,再退回全貌。不要逐句缩放,不默认开启整片机位变化。关键词绑定具体对象,必要字幕留在屏幕层;不默认给整片加品牌角标或页脚,品牌按本片目的出现。注解补充结构或边界,避免复述口播。未绑定或无安全阅读位置时不强行添加。
  38. 扩展模块:`production/focus-camera.ts`、`production/FocusCamera.tsx`;新工程随 runtime 提供但默认关闭,既有工程可运行 `scripts/install_focus_camera.py --project /absolute/project`,冲突即停止,不自动改片。先做同帧开/关 Playground 与前中后检查,同帧审片后再用于正式影片。本版是 custom experimental extension,不增加稳定 registry 的 10 个 adapter,不声称 selector 已执行或自动识别重点词。
  39. ## 混合媒体与任务交接:先检查耦合
  40. 局部交接或真实视频卡顿返修,按 [交接编排与检查](references/handoff-orchestration.md) 明确过程/结果证据、单一事件图、可读覆盖、媒体预热与几何归属;再运行 `scripts/validate_handoffs.py plan.json --out report.json`。输入/切换等过程不能用成功对号代替;完成标识须有真实结果证据。复用组件时核对内部时钟,不让焦点框、光标和相机各自重新缓动。真实视频只预热媒体节点,保留原入点与速度。
  41. 合同检查只核声明关系;还要看实际接线和原速播放的 waiting/resume 事件。局部返修保留其他镜头、声音和来源基准;不为通过检查重做整片,不把合同通过当作流畅或审美验收。
  42. ## 可选:工程编排与音乐律动
  43. 局部修复先回答“画面承担什么动作”,再调机位;播放图标不能代替任务过程,成功标识必须有结果证据。语义、组件来源、对象职责与几何 owner 可用现有 semantic-plan 的 `orchestration` v1 扩展记录,运行 `scripts/orchestration.py` 生成 SHOTBOOK 和风险窗口。详见 [编排合同](references/orchestration-contract.md)。
  44. 发布预览前,对显式源码、音轨、素材、配置和构建产物建立指纹;任一依赖改变,旧报告标 stale。五层状态分开:计划、接线、画面、播放、用户接受;哈希一致不自动升级视觉状态。按 [三步工程化升级](docs/ORCHESTRATION_UPGRADE.md) 做范围明确的回归,不强制全项目重做。
  45. 用户要跟音乐调整画面时,先选定/试听已有授权音乐,或在明确授权后使用外部生成服务;再挑真实起音候选、口播锚点和语义停顿。使用 [音乐驱动编排](references/music-driven-motion.md) 的可选 helper,以 composition 时间控制分组、停留和机位,真实视频和配音不随音乐全局变速。不要每拍都缩放,不把频谱峰值说成可靠强拍识别。没有音乐时可静音制作。
  46. [律动 Playground](examples/rhythm-playground/README.md) 提供同一时间与测试音的对照;合成测试音不是 ACE-Step 作品。Motion 不内置音乐模型、音效库或自动混音服务。使用 ACE-Step 前须说明 [首次模型下载、等待与效果边界](docs/ACE_STEP.md),不在未告知时自动下载数 GB 模型。新音源产生后重新检查锚点与混音,保留已经授权的配音。
  47. 需要 ACE-Step 时先检查已有安装与模型缓存;缺失则提供 [官方 GitHub](https://github.com/ace-step/ACE-Step-1.5) 与 [中文安装指南](https://github.com/ace-step/ACE-Step-1.5/blob/main/docs/zh/INSTALL.md),按用户硬件选择安装方式,明确首次下载较大、可能等待很久。程序和模型由使用者从官方来源安装,不随 Motion Skill 分发;下载源码不等于安装完成。已有授权音乐可跳过此步骤。
  48. ## 只检查本次改动,不绕回整座研究库
  49. 默认先交 15–20 秒、包含完整意思的真实内容样片。用户验收通过后才扩整片;明确要求其他片长或直接整片时,以该次用户要求为准,不额外设确认。验收按 `references/pilot-acceptance.md`,技术检查通过不自动将用户验收改成 accepted。
  50. 继承工程运行 `npm run check && npm run build && npm run verify:assets`;默认结构工程运行 `npm run check && npm run build && npm run verify:frames`;涉及命名事件再运行 `verify:score`。`build:studies` / `verify:studies` 仅在修改研究库或用户要看研究库时执行。96 项是灵感研究,不是每片配额。当前 adapter 数量以 production-registry.json 为准,需真实导入才算接入。只改文案不重复渲染无关帧;只看 Playground 不默认导出整片。
  51. 关键交接检查前、中、后画面;原速连看一次,再确认文字与声音。真实 MP4 用于区分浏览器预览性能和影片编排,不把数学连续或测试通过说成审美通过。
  52. 导出使用独立 public 素材目录和每次新建的 bundle 目录;不要把历史 MP4、下载链接、研究页面一起打包。缺依赖准确报错,不自动下载。导出之后检查音轨、时长和解码;不顺带更新浏览器或系统配置。
  53. 本地素材优先。先查现有来源与实际图像/视频内容,按“证据、解释、情境”决定用途。缺关键素材再在当前授权范围内检索公开源并核对许可、裁切与语义;不以关键词搜索命中当作适配证据。此过程由当前 Agent 编排,不宣称本包内置全自动素材识别模型。
  54. ## 字幕与真实素材(公开内测版)
  55. voice 模式默认补底部同步字幕,不用主标题代替字幕。Agent核对文字与断句,把帧级cues写入story.captions,或以new --captions传入。默认缺字幕会被plan拦截;只有用户明确不要字幕才写captions.enabled=false。字幕不抢主视觉,实际复看深色画面、实拍和片尾。字段见[入门](docs/GETTING_STARTED.md)。
  56. 用户要求混剪时,具体场景用有来源的实拍,抽象关系用动效。用户明确授权联网获取素材、但未提供实拍时,可由Codex使用可用搜索与下载工具,按口播场景自行寻找有明确使用许可的公开照片和短视频,不逐张索取确认;记录作者、原始页面和许可证。搜索/下载受限时报告缺口,不自动购买,不把示意图或生成画面标成实拍。真实素材获取与镜头编排由Agent按已授权能力完成,不把源码中的示意图当实拍;示范工程见examples/voice-to-video。下载来源与作者保留,原件不自动打包。
  57. ## 画幅与文案模式
  58. 文案可用 script 模式,无音源就静音,不要求转写。默认为 16:9;用户要求其他比例时重排 Composition、Player、字幕和安全区并实际检查,不能只改尺寸。保留 `new --captions` 与 voice 默认字幕校验,详见 [入门](docs/GETTING_STARTED.md) 和 [画幅](docs/CUSTOMIZATION.md)。
  59. ## 按需资料,不要求全部通读
  60. - 前置选型、镜头编号与内容适配:`references/semantic-orchestration.md`。
  61. - Remotion 依赖安装、定位及 GitHub 说明:`references/remotion-integration.md`。
  62. - 新音频:`references/audio-contract.md`。
  63. - 新语义计划 / 阅读预算:`references/direction.md`、`references/story-contract.md`。
  64. - 需要新机制:`catalog --relation ... --limit 4`,再读具体 adapter;不要整读 catalog。
  65. - 实际接入新 adapter:`references/production-pipeline.md`。
  66. - 再次出现停走或读不完:`references/continuity-review-20261027.md`。
  67. - 完整命令和旧兼容流程:`references/workflow-detailed.md`,仅查相关段落;旧文档与当前入口冲突时以本入口为准。
  68. - 本补丁来源和测量边界:`references/local-fastpatch.md`。
  69. 不修改原声速度、不编造内容、未知写未知;个人音视频和 `.local` 本机索引不得进入分享包。默认只做已授权本地修改;推送或发布需用户明确授权。交付说明基准、实际改动、准备/转写/编排/渲染用时和未确认的观感;不要把已有原片副本当新完成片。
  70. ## 许可
  71. 遵守 [LICENSE_SCOPE.md](LICENSE_SCOPE.md) 与 [ATTRIBUTION.md](ATTRIBUTION.md) 的分目录边界;96 项历史研究不新授 MIT,生产 adapter 是独立的通用实现,不授予第三方作品、素材或商标权。
README.md · README · 274 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Motion Skill — 不出镜,也能把想法做成视频
  2. **给有想法、想表达,但不想出镜的人:用文案或录音,让观点通过画面与动效被看见。**
  3. Motion Skill 是给 Codex / Agent 使用的 **voice-to-video Skill 与可编辑 Remotion 工程**,支持按文稿编排无口播动效,也支持将已有录音编排成视频。默认 **16:9**,当前为**公开测试版**。具体版本与变更保留在[更新日志](CHANGELOG.md)。
  4. [本次 Release](https://github.com/derek-zhuolin/motion-skill/releases/tag/v1.2.0-beta.1) · [安装与更新](docs/UPDATING.md) · [更新日志](CHANGELOG.md) · [English overview](README.en.md) · [快速开始](docs/GETTING_STARTED.md) · [提示词](docs/PROMPTS.md) · [常见问题](docs/FAQ.md) · [内测反馈 / 参与贡献](CONTRIBUTING.md)
  5. ## 本次更新:工程化编排与音乐律动
  6. **先让画面表达清楚,再让动作跟音乐呼吸。** 新增能力都是可选扩展,不重写旧工程或替换已选风格。
  7. 1. **工程断点**:重点运镜与交接检查;显式文件指纹检测旧产物/旧音轨报告;计划、接线、画面、播放、用户认可分开记录。
  8. 2. **编排与保真**:同一命名事件表生成镜头表与风险窗口;过程不冒充完成;新增人工选音乐起音的律动 helper,支持分组、停顿和镜头变化。
  9. 3. **公开案例与迁移**:无私人内容的发票/库存两变体 Playground,保留旧 reference 和10个稳定 adapter;新扩展按项目选择启用。
  10. [三步升级与实际边界](docs/ORCHESTRATION_UPGRADE.md) · [律动 Playground 源码与启动](examples/rhythm-playground/README.md) · [下载预构建试验包(约0.9 MB)](https://github.com/derek-zhuolin/motion-skill/releases/download/v1.2.0-beta.1/motion-rhythm-playground.zip) · [编排合同](references/orchestration-contract.md) · [本版验证](verification/1.2.0-beta.1.md)
  11. ```sh
  12. # 在仓库根目录;复用已安装且版本匹配的依赖则跳过 npm ci
  13. npm ci
  14. npm run build:rhythm
  15. npm run preview:rhythm
  16. # 浏览器打开 http://127.0.0.1:4343
  17. ```
  18. 示例含可播放、可拖动的同时间轴对照;音源为源码生成的 **116 BPM 测试节奏,并非 ACE-Step 作品**。它验证可复现的编排与时间,不承诺用户成片品质。
  19. ### 想自己生成配乐?可选安装 ACE-Step
  20. [ACE-Step 官方 GitHub](https://github.com/ace-step/ACE-Step-1.5) · [官方中文安装指南](https://github.com/ace-step/ACE-Step-1.5/blob/main/docs/zh/INSTALL.md) · [配合 Motion 使用 / 复制给 Agent 的提示词](docs/ACE_STEP.md)
  21. ACE-Step 用于本地生成音乐,Motion Skill 负责画面与动作编排。**程序与模型由使用者从官方来源自行安装;安装或更新 Motion Skill 不会同时安装 ACE-Step。** 已装好可复用,有现成授权音乐可跳过安装。
  22. > **第一次模型下载较大,可能等很久,请提前留出时间与磁盘空间。** 官方指南列出核心模型约 **10GB 磁盘需求**,另有依赖和缓存;这不是固定下载量。首次下载可能需要几十分钟或更久,取决于网络和所选模型。下载、首次加载、生成音乐是不同的等待,后续通常可复用模型缓存。先看下载进度或日志,不要把仍在下载误判为卡死。
  23. 装好后先生成短样本试听,再安排画面和独立动作音效。具体步骤、等待说明与效果边界见 [ACE-Step 使用说明](docs/ACE_STEP.md)。
  24. ## 先看 reference 效果
  25. [![48秒reference动图预览:实拍+MG动效+同步字幕](demo/motion-skill-preview.gif)](https://github.com/derek-zhuolin/motion-skill/releases/download/v1.1.0-beta.1/motion-skill-reference.mp4)
  26. **上方是48秒循环动图预览(静音)。**
  27. ### ▶ [下载完整有声视频 · 1080p / 48秒 / 中文字幕](https://github.com/derek-zhuolin/motion-skill/releases/download/v1.1.0-beta.1/motion-skill-reference.mp4)
  28. [视频发布页](https://github.com/derek-zhuolin/motion-skill/releases/tag/v1.1.0-beta.1) · [仓库内的MP4原文件](demo/motion-skill-reference.mp4) · [可编辑reference工程](examples/voice-to-video/README.md)
  29. **96 项动效机制研究 · 19 个分类 · 10 个生产组件 · 5 类语义结构 · 48 秒有声 reference**
  30. 这是一套给 Codex / Agent 使用的 Skill 和 Remotion 工程。它组织原声、实拍素材、字幕与 Motion Graphics;由 Agent 理解内容并编排镜头,Python 负责时间与约束检查,Remotion 负责预览和导出。
  31. 本 reference 在 **Codex + GPT-6.1 Sol** 中完成(模型名称按作者提供的标注),本地 Whisper 负责转写,Remotion 负责画面渲染。作者参与了视觉方向、实拍补充、ending 与字幕的反馈。它是一个真实迭代案例,不是“一条 prompt 保证任意音频全自动成片”的能力承诺。
  32. ## Motion Skill 更新|更连贯的动效编排
  33. **默认读取 Remotion Best Practices → 提前展示编号镜头表 → 按内容选动效 → 先看 15–20 秒样片。**
  34. - **规范默认读取**:涉及 Remotion 实现时,Agent 先定位并阅读官方 `remotion-best-practices` 入口,再读与本次任务有关的分支,无需重复提醒。定位器只报告文件、版本与 hash;找到文件不等于已读或已遵循。缺失会说明,不静默联网安装。
  35. - **编排提前可见**:实现前展示每镜的时间、意思、主焦点、主效果研究编号与组件名、辅助转场、交接对象、选择原因和阅读窗口。它是开工说明,不新增逐镜审批。
  36. - **内容决定效果**:数字快照可滚动落定或固定揭露;两期变化须有两份可比证据;关键词建立阅读层级;真实素材在原图内部取景与圈注;原视频已有动作时保持外框稳定。记录近期实际用过的机制,减少机械重复,不随机抽效果、不固定重放 AME 镜头。
  37. - **保留已选视觉**:字体、字号角色、配色、材质、阴影和素材表现沿用已选基准;按当前内容调整动效选择与衔接路径。数字组件保留边缘渐隐、轻微模糊与分隔符外观,通用组件不能以“升级”为由换掉原片质感。
  38. - **先样片**:默认 15–20 秒,用户确认表达、可读性与连续性后再扩展;明确要求其他时长或直接整片时按本次要求。技术通过不代替用户验收。
  39. **96 项研究 ≠ 96 套生产模板。** 当前有 **10 个可导入基础组件**([实际清单](references/production-registry.json)),包括数字滚动、固定数值揭露、数值对照、逐行揭露、素材内部取景、圈注、焦点交接,以及原有关键词窗口、词组节奏、粘土汇合。复杂关系仍需 Agent 定制。
  40. | 镜头与时间(说明性示例) | 内容与焦点 | 主效果 | 辅助 / 交接 | 为什么用 / 阅读窗口 |
  41. |---|---|---|---|---|
  42. | S01 · 0–4s | 已核验的当前数字 | #35 NumberReel | #36 圈注来源;#38 交给证据区域 | 强调这个快照;不是增长曲线。完整显露后保留 1.6–3.5s 供读数 |
  43. | S02 · 4–9s | 截图中的对应证据 | #27 MediaFocus | 同一注视框留在来源上 | 找到原文位置;读字时画面稳定,5–8.5s 阅读 |
  44. | S03 · 9–16s | 一个短结论 | #31 LineReveal | 有关联才承接,无关联直接切镜 | 先结论后细节;10–15s 阅读与落定 |
  45. 这些时间仅演示记录方法,不是通用镜头模板,也不是读者实测标准。脚本输入示例 [semantic-plan.example.json](assets/semantic-plan.example.json) 使用显式测试数据;实际来源、阅读时间和转场由本片内容决定。
  46. ### 两套 Skill 与一个运行时
  47. | 层 | 负责什么 |
  48. |---|---|
  49. | Motion Skill | 内容判断、镜头选型、阅读时间、对象交接、验收记录 |
  50. | 官方 Remotion Agent Skills | React 视频、时间轴、素材与 Studio 的实现规范 |
  51. | Remotion npm 依赖 | 实际预览与渲染;版本继续固定为 4.0.538 |
  52. 首次使用,先按下文安装本仓库,再通过官方命令安装 Remotion Agent Skills:
  53. ```sh
  54. npx skills add remotion-dev/skills
  55. ```
  56. 这条命令会联网安装到所选 Agent 环境,由使用者主动运行;Motion Skill 不自动替你安装。官方 Skill 正文不随本仓库分发。参考 [官方说明](https://www.remotion.dev/docs/ai/skills) 和 [接入边界](references/remotion-integration.md)。不同 Agent 的安装目录可能不同,可用 `--skills-root` 指定。
  57. ```sh
  58. # 以下在 motion-skill 仓库根目录运行,输出使用新路径
  59. python3 scripts/motion.py preflight-remotion --project /absolute/project
  60. python3 scripts/motion.py select-motion assets/semantic-plan.example.json \
  61. --out /tmp/motion-selection.json --explain /tmp/motion-shots.md
  62. ```
  63. `select-motion` 接收 **Agent 已核对的语义、来源、素材用途和阅读窗口**,不是原始音视频识别模型,也不会自动改写影片。输出是 `planned_not_wired`;实际导入与调用后另存使用清单、做源码检查和画面复看。未覆盖的关系可以按目录做 custom 实现,不为通过选择器而扭曲内容。详见 [内容到镜头](references/semantic-orchestration.md) 和 [接入组件](references/production-pipeline.md)。
  64. [本地复用与转写缓存](references/local-fastpatch.md) 只保存于使用者本机;公开包没有作者的私人基准、录音或缓存。没有自己的基准时,从新工程或已有公开 reference 开始,不能宣称已复刻私人 AME 原片。
  65. ## 适合谁
  66. 你可能有很多想法,也愿意分享自己的观察,却总卡在“要不要露脸、怎么拍、怎么剪”这一步。可以先拿手机把话说出来,再让 Codex 配合 Motion Skill 把声音组织成画面。
  67. - **不想出镜的创作者**:用自己的声音分享观点、知识或生活观察。
  68. - **有产品想法的设计师、开发者与独立创作者**:用流程动效、真实截图或实拍解释一个问题与解决方式。
  69. - **习惯先说再写的人**:把一段核对过的语音整理成可观看、可继续修改的视频。
  70. 你负责内容、判断与最终确认,Agent 协助编排和实现。无需拍摄自己的脸;已有录音是最直接的起点。**不出镜不等于匿名**,声音及讲述内容仍可能识别身份;公开前请确认发布范围。
  71. 只看效果可以直接下载视频;制作自己的片子需要 Codex 或其他能读写工程、运行命令的 Agent,以及下方列出的本地环境。
  72. ## 不录音也能做;声音按需要选择
  73. 录音不是必填项。已有 `script` 文稿模式可按文案、目标时长与阅读预算编排文字、图形、流程和片尾;没有音源时输出静音画面。`example` 是另一个模式,用于明确标注的结构演示,不代表完成了你的内容。
  74. | 内容选择 | 当前工程的实际状态 |
  75. |---|---|
  76. | 只有文案,不录音 | 支持 `script` 模式,需 Agent 编排镜头与布局 |
  77. | 录音+动效 | 支持 `voice` 模式,原声1×,默认要求同步字幕 |
  78. | 动效音效(点击、滑动、落定等) | 可作为制作要求;新工程支持显式 `--audio-kind sfx` 输入;无内置音效库、独立开关或自动配音效,落点与混音需另做 |
  79. | 背景音乐 | 可作为制作要求;新工程支持显式 `--audio-kind music` 输入;需另行选曲、确认许可并混音,不自动添加 |
  80. **不录口播 ≠ 必须无声,录了口播 ≠ 不能加音效。** 口播、动效音效、背景音乐是三个可分别选择的声音层。当前默认不自动添加音效或音乐;有需要请在提示词中明确,实际工程仍需实现与听检。
  81. 本次48秒reference只接入口播,实拍视频静音,没有额外添加音效或背景音乐。播放器的“原声开/关”只控制口播,不是音效选择器;首页GIF本身也不含声音。详见[声音说明](docs/AUDIO.md)。
  82. ## 效果与工程索引
  83. - [25 条同步字幕 SRT](examples/voice-to-video/captions.srt)
  84. - [96 项机制目录、分类与缩略图](docs/EFFECTS.md)
  85. - [来源与参考者署名](ATTRIBUTION.md) · [许可范围](LICENSE_SCOPE.md)
  86. ![16项动效研究预览:文字、卡片、流程与相机效果](docs/study-contact-sheet.png)
  87. 上图是机制的单帧示意;在本地打开 `studies.html` 可逐项播放 96 项研究。它们是二维/SVG/CSS 研究和近似效果,不是 96 项全新发明,也不是本片用了 96 个效果。
  88. ## 可直接复制的提示词
  89. > /motion-video 我不想出镜,但想分享这段录音里的观点。把这段音频做成“实拍素材混剪+MG 动效”:具体场景用实拍,抽象关系用动效。保留原声 1×,补上同步底部字幕。没有实拍素材时,请 Codex 按口播场景联网寻找并下载有明确使用许可的公开素材,保留作者与来源。片尾放大 **[名称]**,配 **[收尾文案]**,稳定停留至少三秒。完成后导出有声 MP4 和可编辑工程。
  90. 更完整的输入、素材与 ending 模板见 [PROMPTS](docs/PROMPTS.md)。尽量给出受众、唯一带走的结论、画幅和想要的片尾。没有仓库链接就不编造链接。
  91. ## 画幅:默认16:9,需要时在提示词里指定
  92. **不写比例时,默认横屏16:9。** 需要其他画幅时,在提示词中明确写出目标比例;也可以同时给出成片像素尺寸。
  93. | 提示词中的要求 | 示例成片尺寸 | 排版方向 |
  94. |---|---|---|
  95. | 未指定比例,或“使用16:9横屏” | 1920×1080 | 横向展开 |
  96. | “改成9:16竖屏” | 1080×1920 | 标题、画面与字幕上下重排 |
  97. | “改成3:4竖版” | 1080×1440 | 收紧纵向留白,保留独立字幕区 |
  98. 可直接追加:
  99. > 这条改成 **9:16竖屏,1080×1920**。请按竖屏重新排标题、实拍、动效、字幕和ending,保留原声1×。
  100. 或:
  101. > 这条改成 **3:4竖版,1080×1440**,按这个比例重新组织构图与字幕安全区。
  102. 当前通用运行模板仍固定为16:9;9:16、3:4等是交给Codex的目标画幅要求,需要相应调整工程与布局后验证,不是只改比例数字就自动适配的现成开关。其他比例也请写清宽:高,必要时给出像素尺寸。详见[画幅与版式](docs/CUSTOMIZATION.md#字幕与画幅)。
  103. ## 没有实拍素材,也可以让 Codex 找
  104. 可以在提示词里直接说:
  105. > 我没有现成的实拍素材。请你根据口播里的具体场景,联网搜索并下载有明确使用许可的真实照片和短视频,优先使用可用的公开素材库。自行选取合适片段并静音,记录作者、原始页面和许可证,再接入工程。不需要我逐张挑选。
  106. Codex需要有可用的联网搜索/下载能力;Skill本身没有内置素材搜索API。来源不清、付费或下载受限时,说明缺口,不把示意图或AI生成画面标成实拍,也不自动购买。本reference就采用了从公开来源获取的工作台照片和手机实拍视频,详见[制作记录](docs/REFERENCE.md)。
  107. ## 工程里有什么
  108. | 内容 | 核对后的数量 / 状态 |
  109. |---|---|
  110. | 机制研究 | **96 项,19 类**,目录按 ID 对应源码 |
  111. | 可导入生产组件 | **10 个**;逐个记录实现与研究编号,不自动装配成影片 |
  112. | 通用语义 renderer | **5 类**:collect / connect / compare / evidence / conclusion |
  113. | 导演与工程能力 | [12 项能力矩阵](docs/FEATURES.md),逐项标明通用模板 / reference / 限制 |
  114. | 本 reference | **7 段语义镜头、25 条字幕、1 张实拍照片、5.4 秒实拍视频** |
  115. | 原声与输出 | 原声 48.064s、1×;1920×1080、30fps、H.264/AAC |
  116. | 历史组合 | 目录保留历史组合记录;当前研究 UI 不开放它们,不计入可用模板数 |
  117. ## 运行 reference
  118. 准备 Node.js 22+、Python 3、FFmpeg 与已有 Chrome/Chromium。没有内置 ASR、模型、密钥或浏览器下载器。
  119. ```sh
  120. npm ci --ignore-scripts
  121. python3 scripts/prepare-reference.py --fetch-stock
  122. npm run check
  123. npm run build
  124. npm run verify:frames
  125. npm run preview
  126. ```
  127. 打开 `http://127.0.0.1:4341/` 查看可编辑时间轴;`/studies.html` 浏览机制。`--fetch-stock` 会从已署名的 Unsplash / Pixabay 来源下载素材,并准备静音 B-roll。下载文件只留在本机,不进 Git。原始录音未分发;参考工程从已公开、已获发布授权的示范片提取配音副本。
  128. 导出:
  129. ```sh
  130. npm run render
  131. ```
  132. 输出在 `examples/voice-to-video/outputs/`。如浏览器未找到,设置 `REMOTION_BROWSER_EXECUTABLE` 为本机 Chrome/Chromium 的路径。首次浏览器渲染仍受平台、字体和资源可用性影响。
  133. ## 安装 Skill,制作自己的片子
  134. 首次安装可使用官方 Skills CLI(Node.js 22.20+),按提示选择你的 Agent:
  135. ```sh
  136. npx skills add derek-zhuolin/motion-skill --skill motion-video -g
  137. ```
  138. 通过上述方式安装、且没有在 Skill 文件夹内放自定义改动或私人文件时,之后只更新 Motion Skill:
  139. ```sh
  140. npx skills update motion-video -g
  141. ```
  142. 这是已有 Skills CLI 的命令,不是本仓库新增的自动更新器。更新跟随安装来源;上面安装方式跟随仓库默认分支。**改过 Skill、手动复制或使用 Fork 的用户,先看[安装与更新](docs/UPDATING.md)**,不要直接覆盖。项目内安装使用 `-p` 更新;不要省略 `motion-video` 去更新所有 Skill。
  143. **不会操作命令?** 把下面这句话直接发给你的 Agent:
  144. > 请把我的 Motion Skill 更新到 https://github.com/derek-zhuolin/motion-skill 的最新版。先确认实际安装位置和来源,备份并保留我的修改、私人素材和已有视频;有冲突先告诉我。按原安装方式更新,不顺带更新其他 Skill,不上传文件。完成后核对版本与基本检查。
  145. 更新后让 Agent 核对实际安装目录里的 `package.json` 和 `CHANGELOG.md`;如果当前会话仍使用旧规则,新开会话后再调用。想接收后续发布消息,可在 GitHub 选择 `Watch → Custom → Releases`;下载过的副本仍需主动更新。
  146. 也可以保留原来的完整仓库安装方式,保持文件结构,显式调用 `/motion-video` 或 `$motion-video`。Skills CLI 的 Codex 安装通常在 `~/.agents/skills/motion-video`;手动安装也可能在 `~/.codex/skills/motion-video`。先确认实际使用的目录,避免重复安装;两种方式不会自动互相同步。
  147. ```sh
  148. python3 scripts/motion.py doctor --deps "$PWD/node_modules"
  149. python3 scripts/motion.py new --dest /tmp/my-motion-film --deps "$PWD/node_modules"
  150. ```
  151. 第二条先生成明确标注的**静音结构示例**。默认 `build` / `verify:frames` 只处理本片;新工程要浏览研究库时另运行 `npm run build:studies`,修改研究库时运行 `npm run verify:studies`。真实口播需要已核对的 transcript、story 和字幕数据,再带 `--media`、`--story`、`--transcript`、可选 `--captions` 创建新工程。见 [GETTING_STARTED](docs/GETTING_STARTED.md)。
  152. ## 检查本次合并
  153. 可运行 `npm run verify:production` 检查选型、字幕与隐私边界;`npm run verify:template` 验证新工程。已有 Chrome 时,`npm run verify:components` 用合成数据渲染七个新组件的代表帧,结果仅存本机 `.cache/`。完整命令和已核验范围见 [验证记录](verification/1.1.1-beta.1.md)。
  154. ## 换成你喜欢的配色
  155. 欢迎改成自己的视觉语言:
  156. - reference:`examples/voice-to-video/src/theme.json`
  157. - 新片模板:`story.json → brand.blue / brand.ink / brand.paper`
  158. - 96 项研究的主要配色:`assets/runtime/src/studies/palette.json`
  159. 仓库附蓝、紫、珊瑚三组起点;材质高光、灰阶和第三方实拍不会被一键自动重着色。配置示例、适用范围和对比度检查见 [CUSTOMIZATION](docs/CUSTOMIZATION.md)。
  160. ## 使用时注意
  161. 1. **先核对转写。** 专有名词、口误、字幕断句和时标仍需检查;没有绑定 ASR 服务。
  162. 2. **保持原声。** 不为凑时长偷偷加速、延后或截断人声。读不完先减屏幕信息。
  163. 3. **字幕与大字各司其职。** 底部字幕跟原话走;主文案讲结论。voice 模式默认要求字幕,明确不要时才关闭。
  164. 4. **实拍有出处。** 不把素材示意当成用户本人、实际产品 UI、真实业绩或本人经历。
  165. 5. **动效为意思服务。** 研究库不自动做语义导演;复杂机位、素材与版式仍要按本片改源码。
  166. 6. **检查实际视频。** 规则、构建和 DOM 检查通过不等于观众看懂;要复看声画、字幕与 ending。
  167. 7. **发布前脱敏。** 原始音视频、ASR 原件、设备/位置元数据、本机绝对路径、密钥和无关历史不进公开包。
  168. 本案例还有两处轻量 ASR 文字修正,未隐藏为“机器逐字零误差”;见 [reference 制作记录](docs/REFERENCE.md)。
  169. ## 署名、许可与贡献
  170. **不主张所有技法原创。** 已记录的参考包括 Oreo UI、Paper Shaders、Juan Mora Romero、Jérémie Nallet / Atelier UI、Noor Mtir / Paperlab、Codrops、Kimi 视频参考集、Camera Controls、Theatre.js。逐项对应见 [ATTRIBUTION](ATTRIBUTION.md)。
  171. 工具、模板编排层和 reference 工程中由本仓库贡献者持有版权的代码采用 [MIT](LICENSE),**历史研究档案、字体、依赖、实拍素材与示范片有明确排除范围**,见 [LICENSE_SCOPE](LICENSE_SCOPE.md)。早期 1–64 项逐项出处记录不完整,因此不把研究档案重新授予 MIT,也不把相关技法说成本仓库发明。
  172. 欢迎按许可范围 Fork、改配色、优化字幕、改进机位、补来源记录和提交 PR。提交新效果时请附来源、使用范围和实际预览;计数按有独立 ID 的可运行机制记录,不用配色变化凑数。
  173. 内测遇到问题或想贡献配色、竖屏版式、来源记录,请先看 [贡献与反馈指南](CONTRIBUTING.md)。关于搜索可发现性、AI 引用信息及本轮检查范围,见 [文档维护记录](docs/DISCOVERABILITY.md)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.