这是什么
RuiC-motion-reel 是一个 Agent Skill，让编码 Agent（如 Claude Code）能够用代码生成 15 秒的动态图形（Motion Graphics）成片，默认交付 1920×1080 / 30fps（450 帧）。画面和音乐全部由代码产出，不依赖任何外部美术素材，也不需要打开 After Effects。它自研了渲染引擎，支持超采样矢量/文字、真 3D 点云渲染、丝网印四色分色、代码合成配乐等高级功能。
这个 Skill 由作者用 DeepSeek Flash 跑通，从建模、排版、分色到配乐与出片，整条链路都是 AI 自己完成的。它不绑定特定模型，支持各大主流多模态模型，任何能读写文件、执行命令的编码 Agent 都能使用。
适合谁
这个 Skill 适合以下人群：
- 自媒体创作者：需要快速生成高质量动态图形视频，用于社交媒体、宣传片或作品集。
- 创意编程爱好者：对代码生成艺术感兴趣，希望探索程序化视觉与音乐合成的可能性。
- 品牌与营销人员：需要为品牌制作定制化的动态图形，且希望保持视觉风格的一致性。
- 开发者与 AI 使用者：希望利用 Agent 自动化视频制作流程，减少手动操作。
能做什么
- 15 秒成片：1920×1080 / 30fps，450 帧，锁在音乐网格上（128 BPM × 8 小节 = 15.000 秒整），每个场景正好一小节，剪辑点落在强拍上。
- 字体排版：2× 超采样矢量/文字通道、字距排版、字号按目标宽度反解。
- 真 3D 渲染：参数曲面建模 + 点云渲染（排序散射做精确遮挡）+ 隐藏线线刻。
- 印刷管线：分色成四块油墨版、旋转网线做网点、乘法定律叠印、套印偏移、纸纹、裁切线、套准规。
- 配乐合成：打击乐 / 贝斯 / FM 电钢 / 钟 / 铺底 / riser / impact，加磁带抖晃与混响，无采样。
- 颜色计算：根据物理量生成颜色（黑体温度、谱线波长、薄膜干涉等）。
- 16 张风格牌：默认随机抽取，包括暗色科技、riso 印刷、纸艺、银盐暗房、恒星普朗克配色、氰版蓝图、紫外光刻等，抽签结果写入 STYLE.md。
- 出片链：多进程逐场并行渲染 → H.264 编码 → 混音，1080p30 的 15 秒约 3~8 分钟。
使用前准备
需要安装 Python 3，并安装依赖：numpy 和 Pillow。同时需要 ffmpeg 用于视频编码。字体随包提供（OFL 1.1 协议）。
安装方法
将仓库克隆到 Agent 的 skills 目录：
git clone https://github.com/HRuiCcc/RuiC-motion-reel.git ~/.agents/skills/ruic-motion-reel安装 Python 依赖：
pip install numpy pillow使用示例
给 Agent 用（推荐）：把 skill 装到 ~/.agents/skills/ 下，Agent 会在你说「用代码做个动效视频 / 生成一条 15 秒作品集样片 / 给某个品牌做一条片子」时自动使用它。
手动用：
# 起一支新片
python3 ~/.agents/skills/ruic-motion-reel/scripts/new_reel.py ~/my-reel --name my_reel
# 默认抽一张风格牌（写进 STYLE.md）；--style 指定，--style none 关掉
cd ~/my-reel
# 改 my_reel/theme.py：品牌、时间网格、色板、文案
# 改 my_reel/scenes.py：八个场景
python3 -m my_reel.build --stills 0 # 抽一场的 7 帧审阅
python3 -m my_reel.build --at 3:1.20 # 某一拍的单帧全分辨率
python3 -m my_reel.build # 出全片产物在 out/ 目录。
风险与注意事项
- 依赖本地环境：需要 Python 和 ffmpeg，且渲染过程消耗 CPU/GPU 资源，建议在性能较好的机器上运行。
- 渲染时间：1080p30 的 15 秒视频约需 3~8 分钟，排版重的风格可能更久。
- 品牌素材使用：如果为品牌制作，需确保使用官方素材（如 SVG、PNG）并遵守商标法规，本 Skill 不承担相关责任。
- 已知坑：项目提供了
references/gotchas.md，记录了 40 多条踩坑经验，建议使用前阅读，避免常见错误。 - 协议：代码为 MIT 协议，字体为 SIL Open Font License 1.1，使用前请确认合规。