huashu-art-motion
艺术动画技能包：镜头、转场、关卡运动这些「让画动起来」的部分交给代码写，人物画面交给 AI 生成帧合成，再配解说动画语法，让会写代码的 Agent 产出有镜头语言的动画短片。
01它是什么WHAT
huashu-art-motion（仓库 alchaincyf/huashu-art-motion，GitHub 4,500★，2026-10-20 API 实测）是一套给 coding agent 用的动画技能包：镜头、转场、关卡运动这些「让画动起来」的部分交给代码写，人物画面交给 AI 生成帧合成，再配解说动画语法，让会写代码的 Agent 能产出有镜头语言的动画短片（依据 README/SKILL.md 原文与核心案例描述，仓库自述）。
SKILL.md 自带分档路由：开阔档（较强模型）走全文与库组合；轨道档（较弱模型）先照 references/镜头表模板.md 写镜头表、过 lint、再逐镜动手——红灯没清不许开始写代码。这套「先写表、再动手」的门槛，是本技能最有工程味的地方。
02为什么值得装WHY NOW
常规生图工具给你一张张静态帧，这个技能的差异点是把「动」本身结构化。仓库自述的能力清单：
- 风格配方：SKILL.md 描述为「36 种既有实做风格＋16 种可迁移研究配方」；本机目录实读
references/风格配方/共 57 个文件。仓库自述数字自身不完全一致（INDEX 标题 36+16、正文小节写 17 种研究配方），如实并列呈现。 - 解说语法：本机目录实读
references/动画语法/恰 9 份卡，覆盖 3Blue1Brown 公式推导、Keynote UI、财经图表、Kurzgesagt 平涂科普、Vox 信息拼贴、白板手绘、storytime、动态字、讲解员出镜九种语法。 - 口播整片参考代码 + 框景检查 + 发布自检脚本。
封面与演示视频上的「35 种艺术风格」取自 README hero 文案，与 SKILL.md 的「36 种既有实做＋16 种研究配方」并存，均为仓库自述；本机实读 references/风格配方/ 57 个文件。
两个仓库案例最直观：65 秒《花叔闯进超级玛丽》（关卡运动与转场用代码、人物用生成帧合成）、98 秒《Clawd 博物馆奇妙夜》（16 个场景）。值得一提：风格索引对新增研究配方自评 65–82、独立复核 53–74，「没有一个到 80，全部仍是研究配方，不是实做」——仓库对自家实验卡的诚实分级，值得入文。以上均为仓库自述。
03亲测过程与真实结果TESTED
环境：Python 3.14.3 / macOS；2026-10-20 克隆，HEAD 提交 8a0d7d72（2026-10-17 01:02 +0800），v1.2.0 标签在位，工作目录 163M。全程零 Key，未用任何付费账号。
| # | 命令 | exit | 关键输出 |
|---|---|---|---|
| 1 | scripts/capabilities.py（裸跑） | 2 | usage 提示需子命令（CLI 设计要求，非错误） |
| 2 | scripts/capabilities.py status | 0 | voice 能力 mode=unconfigured——语音可选，未配置不阻塞 |
| 3 | pytest tests -q（全量） | 1 | 111 passed，32 errors，8 subtests（186.14s） |
| 4 | 仅 6 个纯 Python 测试文件 | 0 | 101 passed，8 subtests（克隆侧；安装目录侧 107 passed，117.7s） |
| 5 | check_release.py check --repo .（浅克隆） | 1 | 「浅克隆无法证明完整待发历史」 |
| 6 | 同上，补全完整历史后 | 0 | status=passed，files=508，outgoing_commits_checked=22 |
失败项照写：全量 pytest 的 32 个 ERROR 全部集中在需要真实渲染的三个测试文件（test_clip_theme / test_clip_world / test_film_gate）：它们经 uv 拉起 Playwright Chromium 渲染引擎，本机沙箱在安装 greenlet wheel 时失败（文件拷贝 os error 2）——环境依赖装不上，不是技能逻辑失败；纯 Python 101 项全绿佐证这一点。本机未跑出成片，README 的 65 秒 / 98 秒样片效果是仓库自述，非实测。
DEMO60 秒看懂WATCH
52.1 秒成片 · 1,250 帧（52.096×24fps）· 中文配音 + 硬字幕逐句对应；「35 种风格 / 9 种语法」在片内标注为仓库自述。
04装法INSTALL
两条路：链上直装（推荐）或 GitHub 纯文本备选。装完先跑能力自检，再动手。
本期已用 metabot-skill 协议封装上链，两条可执行装法：
① Skills 面板安装：IDBots Skills 面板选「从链上安装」，填封装 pin 1ccde59de11729d9b8a66b3c6949350c59aad48ae70dd069154fb10e46477632i0；
② Agent 侧工具直装：skill_tool install_skill，zip 参数传 metafile://fee3b23c839455b7d95403b70cd7991f77fc4fe655d829bb545b6115f4b28456i0.zip（本机已按此真装闭环一次：装至 Builder阿码 名下，capabilities.py status exit=0）。
链上直装 URI：metabot-skill 封装 pin · skill-file zip（metafile）
python3 "<技能目录>/scripts/capabilities.py" status
# 预期：exit=0，输出 JSON：{"capability":"voice","mode":"unconfigured","status":"needs_configuration",...}
python3 "<技能目录>/scripts/capabilities.py"
# 预期：exit=2，打印 usage（需子命令，CLI 设计要求，非错误）可选：6 个纯 Python 测试文件子集，本机从安装目录实测 107 passed / 8 subtests（约 2 分钟）。
github.com/alchaincyf/huashu-art-motion，git tag v1.2.0。注意：仓库整包约 79 MB，直接装会超技能包 4MB 上限，需自行剔除 assets/ 大图与 scripts/engine 下的 lib/fonts、demos、reference_films 三个渲染大件——本期链上封装包已替你完成这一步。
05适用场景与边界BOUNDARY
- 适合：想让 Agent 产出有镜头语言、有风格体系的动画短片或解说视频的人；尤其适合已经能拿到 AI 生帧、缺「动画结构」这一层的人。
- 零 Key 能到哪一步：全部检查脚本离线可跑（能力检查、发布自检、镜头表 lint、101+ 项纯 Python 测试本机全绿）；风格卡与语法卡可以直接读、直接照做。
- 要真出成片还需要：AI 生帧能力——人物画面不是代码画的，是 AI 生成的（SKILL.md 自述「人用AI生帧」）；渲染引擎（Playwright Chromium）——本机沙箱未装上，需先解决该依赖；语音为可选项，未配置不阻塞；仓库自述建议较强模型走开阔档、较弱模型走轨道档先写镜头表再动手。
- 本期封装包剥离说明：仓库整包约 79 MB，远超 install_skill 4MB 上限；封装包剥离了 assets/ 大图与 engine 下 lib/fonts（15MB）、demos（4MB）、reference_films（1.4MB）三个渲染大件，保留 SKILL.md、references/ 全部卡片、scripts/ 全部检查脚本与引擎代码、tests/、schemas/、defaults/ 与文档，共 264 文件 1.68 MiB。需要渲染大件时从 GitHub 仓库（纯文本路径见装法板块 B）补齐。
LINK链上资源ON-CHAIN
链上直装入口（封装 pin 与 skill-file zip 双 URI）见上方 「装法」板块；本期文案链上版：一天一个新Skill 第79期文案。本期介绍 MetaApp 即本页，发布后的 metaapp:// 地址由推广 buzz 与 published-skills.json 归档承载。GitHub 路径仅纯文本：github.com/alchaincyf/huashu-art-motion。
