# script-to-doodle-animation — 文稿 → 简笔画讲解动画 Skill

把一段中文文稿一键变成「多角色简笔小人 + 场景道具 + 运镜 + 弹字 + 字幕」的讲解视频。
旁白由 edge-tts 合成，全部动作对齐词级时间戳；HTML（Playwright 截帧 + ffmpeg）与
After Effects 双渲染后端。内置防退化质量闸（原创度规范 + 长片密度自检 + 强制视检清单）。

## 一键安装

**双击 `install.cmd`** —— 自动把 skill 装到 `%USERPROFILE%\.claude\skills\`（用户级，
所有项目可用），旧版本自动备份，并对依赖做体检提示。

装到某个项目专用：

```powershell
pwsh -File install.ps1 -Target <项目路径>\.claude\skills
```

手动安装：把 `script-to-doodle-animation` 文件夹整个复制进上述任一 skills 目录即可。

## 安装后怎么用

重启 Claude Code（或新开会话），把文稿发给 agent：

> 把这段文稿做成简笔画讲解动画：……

Agent 会自动走完整管线：配音对时 → 导演编分镜 → resolve 校验 → 密度自检 →
渲染 → 抽帧视检 → 交付 mp4。

## 依赖

| 依赖 | 用途 | 安装 |
|---|---|---|
| Python 3.10+ | 全部构建脚本 | python.org |
| `edge-tts` | 旁白配音 + 词级时间戳 | `pip install edge-tts` |
| `fonttools` `brotli` | 字体子集化内嵌 | `pip install fonttools brotli` |
| Node 18+ | HTML 渲 mp4 | nodejs.org |
| `playwright` + Chromium | 截帧 | skill 根目录 `npm i playwright && npx playwright install chromium` |
| ffmpeg（PATH） | 合成视频 | ffmpeg.org |
| After Effects 2024+ | 仅 AE 后端（可选） | Adobe |

## 包内结构

```
script-to-doodle-animation/
├── SKILL.md                 # 技能主文档（含硬性规范+工作流+视检清单）
├── examples.md              # 端到端教程（4 句样例从零跑通）
├── docs/storyboard-spec.md  # 分镜 schema/动词表/时间引用/渲染公式（写分镜必读）
├── scripts/                 # tts/plan/resolve/density_check/build_html2/build_ae4/render_mp4
├── assets/                  # 小人骨骼、道具库、GSAP 插件、霞鹜文楷字体、AE runner 模板
└── examples/                # 样例文稿 ×2 + 样例分镜（econ 5角色8幕，照着学）
```

## 质量闸（本 skill 的核心纪律）

1. **原创度 ≥50%**：每个新题材必须新建专属道具与视觉母题，禁止换皮复用旧题材创意。
2. **长片防退化**：≥60s 必跑 `density_check.py`——密度 ≥1.2 动词/秒、运动叙事 ≥15%、
   说教 ≤35%、角色 ≥3、贯穿物连续流动，报警不清零不准渲染。
3. **强制视检**：渲染后抽帧亲眼检查地面线/小人完整/实体在场/弹字卡点/字幕同步。
