Phaser 4 Spine 生成式换皮
本 Skill 只在已授权的 Phaser Work Item 内使用。它保留原 Skeleton、Attachment、锚点、Atlas Region 几何和 Mesh UV 语义;候选资源始终在独立诊断目录中验证,未通过运行态门前不得接入主游戏。
入口
node <skill-dir>/scripts/spine_reskin_progress.mjs --help
正式原版目录可用 inspect --asset-dir <原版资源目录> 或 init --asset-dir <原版资源目录>;独立 Skeleton/Atlas/Page 会直接审计,Cocos sp.SkeletonData 的 _atlasText/_skeletonJson 会先导出到独立规范化候选目录,绝不改写源目录。init 必须同时传入控制面 manifest,绑定 Work Item、production contract 和适用的 V2 方案证据。
进度清单必须是 schema v3。所有会修改清单的命令使用跨进程锁和原子写入;禁止手动编辑状态伪造完成。详细规则见:
- Skeleton 审计与升级
- 批次计划与人工锁定
- 运行态验证与最终交付
- 状态、恢复与锁
- Atlas 重建
固定流程
inspect读取 Skeleton JSON 与 Atlas,输出版本、Bone、Slot、Skin、Attachment、Mesh、Animation、Page、Region 统计、attachment path 映射和 Mesh 顶点/三角形/UV 稳定哈希。init建立 schema v3 清单,记录所有源文件 SHA-256。低于目标 Runtime 时只接受外部官方工具生成的候选,使用upgrade-check比较结构投影;未通过目标 Runtime 解析证据前,任何批次命令都会阻断。freeze-contract冻结角色名、目标 Runtime、暗黑视觉方向、六项色板、材质语言、光向和默认strict_alpha=true。首批前不得使用临时色板。plan-batches导入精确 Region 顺序、mode、alpha lock 和可选连续特效序列,机器校验全集覆盖、无重复/遗漏、Mesh 使用mesh-safe且锁 Alpha。- 按
batch prepare → mark generated → batch review → 停止 → batch accept执行。batch accept必须绑定当前审阅图 SHA、候选 SHA/fingerprint 和当前批次 revision;在刚展示且由--batch与--review-sha精确绑定的审阅上下文中,简短“确认”即可通过,也可使用当前批次对应的完整确认句(初始批次“确认第N批”、返工“确认重启版第N批”)。空白、无关或否定文本仍拒绝。回执是 V4 局部spine_batch_acceptance,不是全局第二次视觉审批。返工使用batch reopen增加 revision,只影响当前批。 - 所有批次
ACCEPTED+locked后执行pack。默认且正式固定padding=0、extrusion=0,Page 名必须保持原名并且实际为 PNG;Atlas Page/Region 间空行格式由序列化器固定。 - 使用
runtime-validate提交结构化 Phaser SpineGameObject 报告,覆盖目标 Runtime 解析、动态动画全集、Idle 循环、纹理/锚点/Mesh/闪烁/裁剪检查、摘要、URL、桌面和约 390px 移动截图及 SHA。通过后才能finalize,最后用report生成 11 项最终交付报告。
状态硬门
Cell 状态固定为:
pending → generating → generated → validating → packing → packed → runtime_validating → completed
正式 Cell 必须是实际 PNG、含 Alpha、尺寸等于正向 Atlas Region;alpha_lock=true 时 Alpha 掩码像素级一致,Mesh 永远锁 Alpha。constrained-redraw 只有显式 alpha_lock=false 才允许使用。
全局视觉与批次确认边界
全局视觉阶段、状态和确认规则以 phaser4-game-workflow-control 的控制模型、状态与门及 Schema 为准。Spine 换皮中的方案提议、审查或审阅、批次锁定都必须在当前用户任务的既有 Work Item 范围内完成;本 Skill 只修改自身候选工件,不自行扩展任务范围或创建全局审批。任务内范围、方案或路径变化同步更新计划并重验受影响部分;需要改变产品方向、视觉方向或接入主游戏时,回到控制面重新审查。Spine 批次确认属于 V4 局部生产锁定回执,不进入 Approval Ledger,也不改变场景 V2 的拆解与布局确认。