技能介绍

要解决的问题

做网格/棋盘解谜游戏时最容易踩的坑，是把逻辑和视觉混在一起——动画跑得比状态快，连锁消除播一半新输入进来，棋盘状态就和渲染脱节，bug 由此而生。其次是规则只解析一次：连锁反应被漏掉、死局没有检测、撤销没有完整恢复分数和随机种子，导致关卡无法复现。

技能如何工作

Puzzle 把上述问题抽象成一套组合式（compositional）设计手册，核心是让棋盘模型成为唯一事实来源（single source of truth），逻辑层独立于视图层：

Board model：grid 网格存棋子，逻辑与视觉彻底分离
Move input：交换、推动、拖拽、旋转、放置，应用前先校验合法性
Rule resolution：按品类实现匹配/推动/逻辑判定，循环执行直到棋盘稳定
Cascades：一次解析改变棋盘后自动重新解析，直到不再变化
Objectives + scoring：胜负条件、步数与时间限制
Undo：完整回滚上一步移动及其全部解析结果——大棋盘推荐 command 模式（存储逆操作所需信息），小棋盘用快照即可
关卡推进与生成：手工设计或生成保证可解（solvable）的棋盘
Feedback（"juice"）：匹配、下落、连锁都有清晰的动画与音效反馈

核心循环：读取棋盘 → 规划走法 → 执行移动 → 规则解析 → 观察进度 → 重复，直到解出或失败。

适用边界

不适用于：带永久死亡的实时网格动作（→ roguelike）、卡牌区域/回合制玩法（→ card-game）、基于物理的解谜平台跳跃（→ platformer + 物理调参）。棋盘渲染请搭配 godot-tilemap 或 unity-tilemap-2d，本技能只负责解析循环与正确性规则。更多细节见 references/board-and-resolution.md。