adu-motion-video：给 Claude / Codex 的 AI 动效剪辑 Skill
adu-motion-video（阿杜的 AI 剪辑 Skill）把代码级动效模板做成可复用的 Agent Skill / MotionGit `.motion` 包：导入旁白（或 AI TTS）与素材，导出可编辑工程与 60fps MP4——不是「一键大片」。
还在为一条短视频抠时间轴吗？字幕对齐、转场节拍、作品墙九宫格、录屏窗进退场——手工做一轮往往比写稿还累。
阿杜实验室的 adu-motion-video（阿杜的 AI 剪辑 Skill）换了个切入口：
不是再塞一堆「生成视频」提示词，而是把 代码级动画工程 打包成助手能读的 Skill / MotionGit
.motion模板。
你提供旁白（真人口播或 AI TTS）、文案和素材；助手按模板编排镜头，导出 可编辑工程 + 60fps MP4。
本稿基于本机已装的 Skill 与一条约 52 秒「作品墙」样片，按 HuanHQ 技术栈习惯：先给地址，再讲它是什么、模板怎么分、怎么开始，以及诚实边界。
项目地址（可直接复制）
- 官方模板主页（MotionGit）：https://motiongit.com/@adunext
- GitHub 仓库：https://github.com/adunext/adu-motion-video
- Demo / 风格预览：https://adunext.github.io/adu-motion-video/
- MotionGit 使用指南：https://motiongit.com/use
- 许可证：MIT
一、速览：它解决什么痛点？
用 Claude Code / Codex / Cursor 这类「能读写文件、能跑命令」的助手时，很多人已经能让 AI 写脚本、切素材，但缺的是：
- 一套 可复用的镜头语言（不是每次从零描述转场）
- 旁白时钟对齐的字幕、音效、砸字与窗体进退
- 知识讲解常见的 作品墙 / 九宫格 / 录屏窗 / 对比卡
- 导出后还能继续改的 工程，而不是一次性黑盒 MP4
adu-motion-video 把这些编舞冻进模板包。README 的原话很清楚：
.motion是给 AI 使用的完整动画模板包，不是提示词，也不是参考视频。
它把代码级动画、画面布局、时间轴、转场、音效编排，以及可替换内容、使用引导和运行说明放在一个文件里。
适合：口播、知识讲解、方法分享、工具演示——横竖屏按模板标记选择。
不适合预期：丢一句「帮我做条爆款」就自动出成片、且无需任何素材验收。
二、是什么：Skill + MotionGit，两条入口
| 项 | 说明 |
|---|---|
| 形态 | Agent Skill 包（本机目录 + SKILL.md + scripts/pipeline.py）与 MotionGit .motion 模板（新版推荐下载入口） |
| Skill id | adu-motion-video |
| 本机版本 | 3.14.1-rc.1（角标更新候选；以 SKILL.md / release tag 为准） |
| 核心能力 | 导入旁白/文案/素材 → 选风格与完整镜头组 → 预览 → 导出 MP4 + 可编辑工程 |
| 平台 | Windows · macOS · Linux |
| 助手 | Codex · Claude Code · Cursor · GitHub Copilot；以及具备文件读写与命令执行能力的豆包 / DeepSeek / WorkBuddy 等 |
| 许可证 | MIT |
| 不是什么 | 不是云端「一键成片」SaaS；不是替你写爆款脚本的营销外挂；不是必须真人出镜 |
可以记两句分工：
- MotionGit：看效果、下最新
.motion（横竖屏版本与后续更新以主页为准） - GitHub / 旧版 Skill：仓库保留历史风格示例、文档、pipeline 工具链；已有工程可继续用 release zip 维护
本机实测路径：
跨平台入口（README / tooling）：
pipeline.py --help 可见命令包括：doctor, setup, packs, new, import, demo, render, preview, macro-plan, macro-build…——这是「工程化剪辑」，不是对话框里甩一段 prompt。
三、模板库怎么读（别被数字吓到）
README 按 6 类主要风格 展示历史示例（完整新版效果以 MotionGit 为准）：
| 编号 | 风格 | 适合 |
|---|---|---|
| 01 | 现代图文口播（01-A…E） | 知识讲解、工具演示、观点拆解 |
| 02 | 纸面透视讲解（02-A/B） | 选择对比、流程说明 |
| 03 | 深色 3D（03-A 多屏展陈） | 产品演示、作品集、软件评测 |
| 04 | 深色科技控制台（04-A） | 技术讲解、自动化流程 |
| 05 | 鲜色角色叙事（05-A） | 教程交接、方法分享 |
| 06 | 活力色彩（06-A） | 观点表达、步骤总结；MotionGit 新版强调竖屏 |
catalog 里风格号合计 11 个（01-A…06-A）。SKILL 还提到竖屏选型覆盖十一种风格、54 个完整组——那是「可参与选型的组」，不等于「每一组都对任意文案稳定验收」。
能力矩阵（docs/capability-matrix.md）更老实：早期稳定口径大约 17 个已验收组，且写明在 macOS、横屏 1080p60 等语境下确认；稳定组不自动保证任意相邻组可连接。本机 pipeline packs 也能看到 anim3 / anim4 等包标记为 experimental（例如 anim4 作品墙九场路线）。
所以对外引用建议：
- 说「6 类风格 / 多套横竖屏模板」——跟 README 对齐
- 说「五十多组镜头」——要同时说清：很多是候选 / experimental，制作要显式选
id@version并做本期素材声画检查 - 不要写成「五十多套都开箱即用爆款」
四、怎么开始（推荐 MotionGit 三步）
README 推荐的新路径很短：
- 打开 https://motiongit.com/@adunext ，看预览，选风格与横竖屏，下载
.motion - 把文件发给助手（或给本地路径），再发旁白视频 / 文案 / 音频；有字幕、录屏、图片、配乐一并给
- 助手读包内引导 → 预览 → 调整 → 导出 MP4 与可编辑工程
引导话术可以直接用仓库示例：
首次可能要配浏览器 / FFmpeg / Node 等运行环境；配好后可复用。字体缺失时模板有中英文字体回退，不要求你先装齐推荐字体才能开做。
若要继续旧版 Skill 工程，可从 GitHub Releases 下载 adu-motion-video_3.14.1-rc.1.zip，装到助手的 skills 目录（本机即 Claude Code 的 ~/.claude/skills/adu-motion-video），再走 pipeline。
五、本机样片：AI 旁白 + 作品墙（无出镜）
我们按用户偏好——不做真人出镜口播——用 AI 配音 + 深色多屏/作品墙路线做了一条约 52 秒 样片（成片与封面已落盘，封面选用 polished 作品墙静帧）。
旁白大意（完整稿见工程 script.txt）：把完整动效工程变成可复用 Skill；作品墙、九宫格、录屏窗、对比砸字对齐旁白时钟；没有真人出镜也可以靠 AI 配音 + 图文编舞做出科技感踩点。
能从成片帧里直接看到的东西：
- 开场钩子与节拍字效
- 作品墙 / 多屏展陈
- 九宫格式对比与素材条
- 中后段图文收束
这验证的是：模板编舞 + 旁白时钟 + 本机导出 这条链路可以跑通。它不证明：任意文案、任意素材、任意助手客户端都能一次过片——仍要预览、仍要核对授权素材、仍要接受部分包是 experimental。
六、局限与使用注意
- 素材与版权：作品墙、录屏、Logo、配乐都要「本期有权使用」；模板不会替你洗白素材来源。
- 助手能力不一：同名「Claude / Codex」在不同客户端上，文件与命令权限可能不同；要用能跑本地命令的模式。
- experimental ≠ 稳定：
anim3/anim4等包在 packs 元数据里就是 experimental；竖屏大量是 candidate。 - 验收语境：文档里的稳定组确认常绑定具体平台与画幅，不能把 macOS 1080p60 的验收直接外推成「全平台任意稿件」。
- 不是自动导演：选哪一组镜头、要不要竖屏、旁白要不要重录，还是人（或你对助手的明确指令）说了算。
- 热度数字：本稿不引用编造的 Star/下载量；以仓库与 MotionGit 页面实时显示为准。
七、结语
值得放进「本地 Agent 工具箱」的理由很具体：
- 动效被文件化成 Skill /
.motion，而不是一次性聊天记录 - 官方主页把预览和下载收拢到 MotionGit，仓库负责文档与旧工程工具链
- 可以走 AI 旁白、不出镜 的路线，做出知识向科技感短片
若你期待「一句话生成百万播放成片」，预期请下调一档——然后它仍然值得一试：打开 https://motiongit.com/@adunext 看风格，或把本机 Skill 装到 Claude / Codex，先做一条 30–60 秒样片验收链路。
再次附上地址：
https://motiongit.com/@adunext · https://github.com/adunext/adu-motion-video · https://adunext.github.io/adu-motion-video/ · https://motiongit.com/use
本文与项目作者 / MotionGit 无商业合作；安装与使用后果自负。博客同步：www.huanhq.com
