Sprite Forge — 角色动态素材生产线

出生：F229 xianxian-codex 9 态 atlas 的实际生产管线（2026-06-22~24，video-to-spritesheet-pipeline.md）。 Skill 化诱因：F258 素材首跑两连翻车（2026-07-08）——猫不知道家里有这条验证过的路，临场发明了两条被淘汰的路线（32px 手搓 + imagegen 逐帧直出），operator 连续两次 identity veto 后拉闸："未来做动态的东西，你们要能想到用这个 skill。"

第一性原理（本 skill 的灵魂判断）

动画的帧间一致性问题，靠换介质解决，不靠更好的 prompt。 imagegen 逐帧独立生图 = 体型漂移、风格跳变、帧间无时序关系（Spike R2 实证，59×64 显示尺寸下可感知劣于视频截帧）。视频模型天然时序连贯——所以生成层必须是视频，图像模型只出首帧。

管线五步（人猫协作产线，人工环节是设计的一部分）

截帧加工命令（Step 4 速查）

ffmpeg -i video.mp4 -vf "fps=4" frame_%02d.png          # 2-3s → 8-12 帧
magick frame_01.png -fuzz 10% -transparent white f1.png  # 白底转透明（脏边则重跑 despill）
magick f1.png -resize 192x208 -gravity center -extent 192x208 cell_01.png
magick cell_*.png +append state_row.png                  # 拼 row strip
magick cell_01.png -resize 59x64 preview.png             # 必做：缩到实际显示尺寸目检

工艺红线（每条都是真翻车）

1. 2D 风格锚是保命符：视频 prompt 首行必须 2D hand-drawn anime illustration style, flat cel-shaded coloring, clean visible outlines + negative 排除 3D/CGI/photorealistic/plastic/Pixar——不加锚视频秒变塑料 3D（R1 实录）
2. 16:9 横屏：9:16 会把尾巴甩出画框（R1 实录）
3. 运动强度调低：大幅运动=角色变形
4. 约束宜简（五爪判例）：一页解剖学约束反而让模型逐条画出每个被提到的爪→五爪；operator 一句"不要生成五只猫爪了"完美通过。简单意图 + 一句负面 > 详细规格书
5. 主审第一问是"这是不是我们家那只猫"，不是特征锚清单——checklist 全过 + operator"不像"= false pass（F229 r3-alpha 与 F258 两次翻车同型）
6. 实战提示词必须回流：Step 3 人工环节实际用的提示词（含中途修正版）才是被验证的版本——生产完成后回流 prompt-pack/provenance。理论版翻车靠人工修正救活却不回流 = 下一只猫在同一个坑再摔一遍

Common Mistakes

与其他 skill 的区别

• anime-forge：产短片成片（分镜/EDL/节奏）——sprite-forge 产可循环状态行素材；共享"图锁确定性→视频给活气"哲学
• image-generation：单张静态图——不解决帧间一致性
• GOTCHA：本 skill 含人工环节（拍视频），不是全自动管线；发任务书时必须显式安排"谁拍视频"（operator 或云端 Gemini），不可默认猫能自己完成

真相源（重材料按需读，不复制进上下文）

• 完整提示词模板库 + Spike 数据 + 9 态任务表：docs/features/assets/F229/desktop-pet-sprite/video-to-spritesheet-pipeline.md
• 近例 prompt pack（首尾帧句式 + 渲染分层决策范例）：docs/features/assets/F258/prompt-pack-v1.md
• cell 规格与三道闸（合规层）：docs/features/F229-petskin-contract.md
• pet.json atlas 格式实例：packages/web/public/concierge/skins/xianxian-codex/pet.json

下一步

素材过全部闸门 → 接 pet.json / 渲染层（代码改动走 worktree + tdd）→ 新猫皮肤开整套 = 回 Step 1 换母图。