huashu-art-motion：让画动起来的 Agent Skill

这是什么

huashu-art-motion 是一个面向 Coding Agent 的技能包，让你用代码生成艺术动画。它内置 35 种艺术风格配方卡（从岩画、埃及壁画到梵高、莫奈、包豪斯、8-bit、蒸汽波等），每种风格都配有可运行的场景代码、风格渲染器和签名转场。同时提供 9 种解说动画语法（如 Kurzgesagt、Vox、白板、3Blue1Brown 等），其中 8 种附带示范片和参数化片段，你可以用 JSON 驱动生成帧级精确的动画片段，支持横屏、竖屏和透明背景。

这个 Skill 的灵感来自 Tak 的 15 秒动画《Art History Speedrun》，作者用代码完全重绘了画面，并沉淀出可复用的方法文档和正面经验。仓库包含完整的动画工程、拆解脚本、QA 验收脚本和配乐模板。

适合谁

视频创作者：想快速生成艺术风格动画片段，用于口播视频、解说视频或 MV。
动画爱好者：对用代码生成动画感兴趣，想学习或复刻特定艺术风格。
技术型内容生产者：熟悉命令行，愿意用脚本和 JSON 控制动画细节。
教育工作者：需要制作艺术史或科普动画，但不想手动逐帧绘制。

能做什么

复刻动画：输入参考动画，拆解脚本会量出转场、节拍网格和运动热图，然后用代码复刻。
生成艺术风格动画：指定风格（如梵高、莫奈），先设计一帧，再让它动起来。
制作口播动画：根据口播内容选择解说语法，生成时长精确到帧的片段。
长卷穿越片：让角色从一幅画走进另一幅画，跨边界时画风切换，镜头只进不退。
配乐与节奏：用纯代码合成配乐，BPM 网格、动机换乐器、结尾音效序列。
质量验收：内置 QA 脚本测量稳定性、效率、动感、流畅度，并派独立 agent 审查成片。

使用前准备

需要安装以下依赖：

uv：Python 包管理器，用于运行脚本。
ffmpeg：视频处理工具。
Playwright Chromium：用于渲染动画，首次运行需执行 uv run --with playwright playwright install chromium。

此外，建议具备基本的命令行操作能力，并了解 JSON 格式（用于配置动画 spec）。

安装方法

通过 npx 安装（需要 Node.js 环境）：

npx skills add alchaincyf/huashu-art-motion

安装后，进入仓库目录，可运行示例渲染命令：

cd huashu-art-motion
uv run --with playwright python scripts/engine/render.py --solo 09_postimp --stills 0.3 --out 试渲   # 梵高那一段的一帧
uv run --with playwright python scripts/engine/render.py --spec scripts/engine/examples/t3_finance_chart.json --out 财经图表.mp4

使用示例

以下是一个简单的使用流程：

选择风格：从 references/风格配方/ 中挑选一种风格（如 09_postimp 对应梵高）。
渲染单帧：运行上述命令，生成一帧测试画面。
制作动画片段：编写 JSON spec（参考 scripts/engine/examples/），指定时长、镜头、转场等，然后渲染成 MP4。
合成角色：如果需要人物，用生图模型生成帧，再用代码合成到场景中。
配乐：使用 scripts/audio/ 中的模板，纯代码合成背景音乐。
验收：运行 python scripts/qa.py 检查动画质量。

作者示例：https://mp.weixin.qq.com/s/MxAc1pql05uBmGAyNiv9WA

风险与注意事项

依赖较重：需要安装 uv、ffmpeg、Playwright Chromium，首次运行可能耗时较长。
学习曲线：虽然提供了大量文档，但完全掌握需要一定时间，建议从示例开始。
素材版权：仓库中的字体和部分数据有特定许可（如 Arphic Public License、SIL OFL），使用前请阅读 LICENSES.md。花叔的卡通形象仅限本 Skill 示范使用，不可商用。
生成质量：动画效果取决于代码和参数，可能需要多次调整才能达到理想效果。
环境要求：需要 Python 3.10+ 和 Node.js（用于 npx 安装），建议在 macOS 或 Linux 上运行。

该 Skill 目前有 1305 个 Star、158 个 Fork，采用 MIT 许可证，最新版本为 v1.0.0，作者为 alchaincyf。更多信息可访问 GitHub 仓库。