games-development-ai/.agents/skills/recipes/settlement.md

recipe: 结算演出（爽感反馈 + 结算页驻留）

要做：成单/暴击/大额那一下有「打击感」，一局结束进结算页并停住不动。

两个病根：

1. 结算态不驻留（自动重开） → 瞬时终态被漏读 → 宿主 500ms 轮询 phase 代发 game_end 时已经不在 over 态 → 结算闭环静默断裂。phase 进 over/gameover 后必须恒驻留（禁自动重开，等玩家点「再来」才回 menu）。
2. juice.render(g) 忘了每帧手调 → 粒子/屏震/闪白全不显示（juice 的 render 不是自动的，要在你的 render 里每帧调）。

抄这段形态（结算时刻的爽感）：

// 成单/暴击那一下：一次 hitStop + 轻 shake + 音效（单行调用，不是系统，好手感标配）
onServeSuccess(x, y, isCrit) {
  juice.spawnEmitter('burst', x, y);          // 粒子迸发
  juice.hitStop(isCrit ? 90 : 40);            // 顿帧（毫秒）
  juice.shakeScreen(isCrit ? 6 : 3);          // 轻震屏
  audioMusic.playSfx(isCrit ? 'win' : 'coin'); // 语义音效名，自动映射
  sessionScore.addScore(isCrit ? 8 : 5);
}

render(g) {
  sceneFsm.render(g);
  juice.render(g);   // ★每帧手调，否则粒子/打击感看不见
}

抄这段形态（结算页 latch 驻留）：

.define('over', {
  onEnter() {
    if (!sessionScore.isOver()) sessionScore.lose();  // 终态一次性落定
    this.overRestartRect = overRestartRect(viewport); // 「再来」命中区在 onEnter 建
    audioMusic.playSfx('fail');
  },
  render(g) {
    hudUi.drawText(g, `本局 ${sessionScore.getScore()} 分`, { x: viewport.w/2, y: 300 });
    hudUi.drawButton(g, this.overRestartRect, { label: '再来' });
  },
  // ★没有 update 里的自动 transition('menu')——驻留，等 handleTap 命中「再来」才回 menu
})

别踩：

• 音效名用语义名（coin/win/hit/jump/fail/click）或预设（blip/thud/chime），未知名自动兜底 blip；audioMusic.play(intensity) 入参是情绪强度 0..1、不是曲目名。
• juice.spawnEmitter('burst', x, y) 也可写 juice.burst(x, y)（母语别名）；hitStop/shakeScreen 收毫秒/像素。
• 结算屏必须驻留(latch):到终态后停在结算不自动重开——玩家要看清战绩,测试员与调试观测也才能确认终态可达。