| name | anime-forge |
| tips_exempt | delivery error row only — no new user-facing capability; continuity commit will reference video-forge SOT |
| description | AI 生成动画短片生产线：图（关键帧锁确定性）→ 视频（i2v 给活气）→ 后期（剪辑做节奏）。 Use when: 做动画短剧/角色 IP 短片、猫咖日记系列新集、图生视频管线、剧情类 AI 视频。 Not for: 录屏/教程/showcase 视频（用 video-forge）、单张图生成（用 image-generation）、PPT（用 ppt-forge）。 Output: charter+分镜+prompt book+素材账本+EDL 驱动的成片，全程可复现可重渲。
|
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 个视频。
流程（每步指向真相源，不复制）
- 立项 charter（operator signoff 的 scope/路线/预算护栏/Non-goals）→ 范例
docs/videos/cucu-pr-flow/episode-brief.md；轻量立项规则见 shared-rules §21（LL-071：先对齐再批量产出）
- 分镜表：每镜头唯一验收点（一镜一梗）+ 类型 + 方法 + FM 标签 + 3 连败降级预案 → 范例
shot-plan-v0.1.md
- Prompt book：图 prompt + i2v prompt 全部写成可复制块，含 per-shot 翻车修法 → 范例+配方
prompt-book-v0.1.md（§0.5 附图铁则 / §0.6 i2v 五段配方——从实测成功原文最小修改，禁止凭理解重写）
- 生产 roll：每 prompt ≤3 roll；roll 判定/FM taxonomy 用
review-protocol-v0.1.md；30 秒人工验收四问（画风像锚图吗/人物比例/文字可读/构图漂没漂）
- 素材账本：入库即登记 md5/时长/状态；视频 gitignored 账本作存在证明 → 范例
assets/README.md
- Animatic 检查点（行为刹车）：烧贵素材前先用静帧+占位拼粗剪验证节奏；剧本结构问题（见下）必须在这层抓
- EDL 渲染：
animatic/edl-v1.mjs（时长/字幕/段序真相源）+ build-animatic.mjs（零 npm 依赖：Chrome 当字幕/字卡渲染器 + ffmpeg）——改数字重渲，画幅参数化
- 交付/预览：最终成片必须在 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 注释里的坑。
