用途:为 Open Design 生成游戏 UI 与 VFX/技能/武器/敌人/Boss/RIG 的交接包,核心是“先打包游戏已有行为,再要求改动”,把独立版本中缺失的运行时内容视为未指定,而非可简化。
主要能力:按界面类型分支。UI 界面(home/mapselect/talent/masks/fusion/victory/steam-title/HUD)走完整保留契约流程;VFX/技能/武器/RIG 等走内容标准流程,即先用 claude-design-handoff-generate 生成包,再叠加 Open Design 增量文件(DESIGN.md、darkbone-visual-language.md、exemplar-craft.html、占位交付物、source-manifest.json)。交互式 VFX 实验室需提供可脚本化评审 API(window.DARKBONE_VFX_LAB)。
使用方式:先阅读 docs/hard-rules/ui-adaptation-upgrade-only-contract.md 与 preservation-contract.md;记录可搜索的源锚点;在每个目标视口与语言下捕获运行时,至少两个状态;运动关键界面需真实视频与带时间戳关键帧;编写 preservation-contract.json,为每个组件指定 preserve/upgrade/redesign/untouched 及 layout、identity、motion、interaction、copy、data 权限,changeScope 必须与权限一致,data 始终归运行时。校验命令:node .agents/skills/open-design-game-ui-handoff/scripts/validate_preservation_contract.mjs --contract=.handoff/<timestamp>-<feature>/preservation-contract.json。VFX 包校验用:make claude-design-check ARGS="validate-handoff .handoff/<id>.zip --kind=skill_vfx"。
限制:证据须来自真实运行应用,截图用压缩 WebP,运动用 WebM/MP4;dev 捕获前需放置 apps/game-runtime/public/sw.js 空桩并从 data/artifact-manifest.json 填充 public/masks/。缺少视觉语言文档、重设计界面少于两张运行时截图、运动关键界面无视频或少于三个关键帧、changeScope 缺失或越权、运行时运动未标记为占位等均会被拒绝。交付物是校验后的保留契约与自包含交接包,不是运行时代码。