# Anime Forge

> AI 生成动画短片生产线：图（关键帧锁确定性）→ 视频（i2v 给活气）→ 后期（剪辑做节奏）。 Use when: 做动画短剧/角色 IP 短片、猫咖日记系列新集、图生视频管线、剧情类 AI 视频。 Not for: 录屏/教程/showcase 视频（用 video-forge）、单张图生成（用 image-generation）、PPT（用 ppt-forge）。 Output: charter+分镜+prompt book+素材账本+EDL 驱动的成片，全程可复现可重渲。

- Skill: `zts212653/anime-forge` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zts212653/anime-forge`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zts212653/anime-forge/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: zts212653 (https://skillmd.com/u/zts212653)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zts212653/anime-forge

---


# Anime Forge — AI 动画短片生产线

> 出生：EP01「醋醋喵诞生记」（2026-06-10~12，docs/videos/cucu-pr-flow/）。本 skill 的每条规则都对应一次真实翻车或一次实测验证，n=1 边界诚实标注——竖屏重制就是第一次 dogfood，踩到新坑回来补 Common Mistakes。

## 为什么是 skill（价值门禁）

不教"什么是 i2v"。只沉淀：实测分工路由（中文乱码）、prompt 配方（四次翻车打磨）、工程纪律（防 operational cost 跑偏重演）、六个真金白银的坑。

## 第一性架构：确定性分层

**视频模型不能同时当导演、UI 设计、演员和剪辑师。** 把确定性按层分配：

| 层 | 负责 | 绝不交给它的 |
|---|---|---|
| 图（关键帧） | 画风、角色一致性、屏幕文字、构图 | — |
| 视频（i2v） | 活气：表情微动、小动作 | 精确文字、节奏、画风决定权 |
| 后期（剪辑） | 节奏卡点、字幕、SFX、时间字卡 | — |

推论：**状态卡/信息卡镜头根本不需要 i2v**——静帧+剪辑切=零抽卡。EP01 11 镜头只抽了 8 个视频。

## 流程（每步指向真相源，不复制）

1. **立项 charter**（operator signoff 的 scope/路线/预算护栏/Non-goals）→ 范例 `docs/videos/cucu-pr-flow/episode-brief.md`；轻量立项规则见 shared-rules §21（LL-071：先对齐再批量产出）
2. **分镜表**：每镜头唯一验收点（一镜一梗）+ 类型 + 方法 + FM 标签 + 3 连败降级预案 → 范例 `shot-plan-v0.1.md`
3. **Prompt book**：图 prompt + i2v prompt 全部写成可复制块，含 per-shot 翻车修法 → 范例+配方 `prompt-book-v0.1.md`（§0.5 附图铁则 / §0.6 i2v 五段配方——**从实测成功原文最小修改，禁止凭理解重写**）
4. **生产 roll**：每 prompt ≤3 roll；roll 判定/FM taxonomy 用 `review-protocol-v0.1.md`；30 秒人工验收四问（画风像锚图吗/人物比例/文字可读/构图漂没漂）
5. **素材账本**：入库即登记 md5/时长/状态；视频 gitignored 账本作存在证明 → 范例 `assets/README.md`
6. **Animatic 检查点（行为刹车）**：烧贵素材前先用静帧+占位拼粗剪验证节奏；剧本结构问题（见下）必须在这层抓
7. **EDL 渲染**：`animatic/edl-v1.mjs`（时长/字幕/段序真相源）+ `build-animatic.mjs`（零 npm 依赖：Chrome 当字幕/字卡渲染器 + ffmpeg）——改数字重渲，画幅参数化
8. **交付/预览**：最终成片必须在 Console 里内联可看，不要只丢工作区路径。外部直链可直接发 rich block；本地 mp4 先变成 `/uploads/...` 再发 `kind:"file"` + `mimeType:"video/mp4"`。只有你明确需要 `autoplay muted` 且拿到的是外部直链时，才退回 `html_widget` + `<video>`

## 实测分工路由（硬约束，不是偏好）

| 任务 | 路由 | 实测依据 |
|---|---|---|
| 含中文文字的图/卡 | GPT 系生图 | Google 系图/视频中文乱码（2026-06-12 实测） |
| i2v 生视频 | Gemini 系 | 时长遵守 prompt 的 N-second 指令（非固定 10s） |
| 字幕/字卡/注解 | 本地 Chrome 渲染 + ffmpeg overlay | 中文完美、零成本、绕开无 libass |

## 剧本结构（导演层 checklist）

- **喜剧 = 预期 vs 现实，预期端必须拍**（任务多小/时间多久）——EP01 初剪"观众看不懂"就是只拍了现实端
- **动机闭环**：种子（S00 宣布）→ 潜意识曝光（用自己的头像）→ OS 自白 → 定罪 → true end（爱）
- 真实素材 payoff：片头承诺（"呈堂证供"）片尾兑现（聊天截图证据卷轴）
- 内心 OS 用独立字幕样式（os 参数）；时间跳跃用默片字卡（intertitle.html）

## Common Mistakes（全部实测，持续补）

| 错误 | 后果 | 修复 |
|---|---|---|
| 异源/异锚图片段硬拼成伪一镜到底 | 三段像三个世界，`xfade` 遮 cut 遮不住画风漂移 | 连续性合约 SOT 在 `video-forge/SKILL.md` → "多段拼接连续性合约"；AI 域的额外约束：共享锚图、同路由、同调色 |
| i2v prompt 写风格描述词 | 邀请重采样→第二帧跳变 | 风格 100% 来自首帧，prompt 零风格词（配方 §0.6） |
| 正面段写 "the man/adult human" | 往写实拉 | 角色用名字；反幼态只进末尾负面清单 |
| 动作太稀（10s 只给 2 动作） | 模型自己编戏 | 3-4 个 Then 串联填满时间线 |
| 图 prompt 不附参考图 | 画风每次重新采样 | 附图铁则：参考图+reference 第一行（§0.5） |
| 猫角色只靠首帧锁 | "cat" 写实先验拉跑 | Keep cartoon 句 + Do not realistic 双保险 |
| 库里有实测成功配方却凭理解重写 | 四个新自由度同时引入，连环翻车 | 从原文最小修改，一次只动一个变量 |
| 先生产后对齐 | operational cost 跑偏（LL-071） | charter 先行；批量产出前一句话确认路线 |
| 不先问素材画幅就定输出画幅 | 横竖分裂，pad 兜底但割裂 | 开抽前统一画幅；混了用 blur-pad 过渡，终态重抽 |
| 静态 PNG overlay 长片尾段 | ~66s 后 framesync 失效字幕全挂 | PNG 输入加 `-loop 1`（builder 已内置） |
| 字幕长句贴 max-width | 折行被渲染窗裁掉 | 字号留安全区；改完必抽帧亲眼验 |
| 最终只产出工作区 mp4，不把成片挂回对话 | operator 看不到片，只能点文件路径，验收断层 | 终稿交付时把视频变成可访问 URL；`/uploads/...` 用 `file` rich block，外部直链才考虑 `html_widget` |

## 和其他 skill 的区别（GOTCHA）

- **video-forge**：录屏/教程/showcase 范式（素材是录的）——anime-forge 素材是**生成**的，核心难题是控制生成模型。做"产品演示视频"→ video-forge；做"有角色有剧情的动画"→ 本 skill
- **image-generation**：单图生成能力——本 skill 消费它（关键帧步骤），但管的是全片生产
- **ppt-forge**：静态页面交付——无时间轴

## 下一步

新集立项 → feat-lifecycle（轻量 charter）；写分镜/prompt 直接抄 EP01 范例改内容；渲染问题先查 `build-animatic.mjs` 注释里的坑。