From 74c3ef51f82d5a94ea1caa244657ec3b3d010036 Mon Sep 17 00:00:00 2001 From: lili Date: Fri, 3 Jul 2026 14:20:45 -0700 Subject: [PATCH] =?UTF-8?q?docs(skills):=20puzzle=20skill=20=C2=A79=20?= =?UTF-8?q?=E8=B5=B7=E5=B1=80=E5=91=BD=E4=B8=AD=E5=8C=BA=E6=95=99=E8=AE=AD?= =?UTF-8?q?=E6=9D=A1=E7=9B=AE=E5=AF=B9=E9=BD=90=20v1.6.1=20=E6=96=B0?= =?UTF-8?q?=E7=BA=A6=E5=AE=9A(onEnter=20=E7=BA=AF=E5=87=A0=E4=BD=95?= =?UTF-8?q?=E5=BB=BA=E7=AB=8B=E3=80=81render=20=E5=8F=AA=E7=94=BB;?= =?UTF-8?q?=E4=BF=9D=E7=95=99=E5=8E=9F=E6=95=99=E8=AE=AD=E4=B8=8E=E5=AE=9E?= =?UTF-8?q?=E6=B5=8B=E8=AF=81=E6=8D=AE)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- .agents/skills/puzzle-game-design.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.agents/skills/puzzle-game-design.md b/.agents/skills/puzzle-game-design.md index 26a90bed..5144482b 100644 --- a/.agents/skills/puzzle-game-design.md +++ b/.agents/skills/puzzle-game-design.md @@ -140,7 +140,7 @@ - ❌ 超过 2 个主机制(谜盘+消除+记忆混一款)→ 聚焦 1 主范式 + 1 成长点缀。 - ❌ **「解」不在取证面上**——这是解谜品类的头号验收翻车点:**`_forensicsView().state().targets` 必须兼职"求解器"——当前**该点的正确目标**标 `occupied:true`、其余(干扰项/已清/锁定中)标 `false`**;自动验收只点 `occupied:true` 的格子,解谜逻辑再对、occupied 标错 = 九门 H 验不到进展 = 好游戏被误判。多步范式(翻牌配对:先翻 A 再翻 B)必须**随状态把"下一步该点的"跟标 occupied**(翻开 A 后,把 A 的配对牌标 occupied);做不到就改单步范式。 - ❌ **重写盘面生成器而丢「可解性质」**——解谜品类第二号翻车点(批产实测:自写符文生成器产出 0 解盘面 → 第一关就无解 → 永无 occupied 目标 → 九门 H 挂):脚手架的 `generateBoard` 保证**每关恰好 N 个解、至少 1 个解、干扰项绝不撞规则**;换主题/换规则维度**优先只改 THEME/LEVELS 表**、别动生成器;确要自写规则系统,必须保住同一性质(生成后自检一遍「符合规则的格数 == 预期解数、≥1」,0 解=不可解关=废稿)。 -- ❌ **在场景 render 回调里引用未定义变量**——解谜档的按钮命中区(开始/再来)靠 render 返回值回写(`menuStartBtn = renderMenu(...)`),render 回调抛错会被 scene-fsm **隔离成告警不崩**,后果是命中区永远拿不到 → 点不进游戏、卡菜单(批产实测:renderMenu 里一个未定义的 `cy` 让整局 E/G/H 三门连锁挂)。改完 render 先顺一遍所有变量来源。 +- ❌ **在场景 render 回调里引用未定义变量**——render 回调抛错会被 scene-fsm **隔离成告警不崩**,画面异常但局不死(批产实测:renderMenu 里一个未定义的 `cy` 曾让整局 E/G/H 三门连锁挂——当时按钮命中区还靠 render 返回值回写 `menuStartBtn = renderMenu(...)`,render 一抛错命中区永远拿不到、卡死菜单)。2026-07-03 起模板已改约定:**命中矩形在场景 onEnter 用纯几何函数确定性建立,render 只画不赋值**(cheap-system v1.6.1 硬约束),旧连锁已断;但 render 抛错仍会黑屏丢反馈,改完 render 先顺一遍所有变量来源。 - ❌ 点错即死 / 三错清零重开 → 错点轻惩罚(§3),乱点不该赢、但点错不该死。 - ✅ 留下的:规则匹配谜盘、找目标、顺序推理、点选消除、记忆配对(守 occupied 纪律)、星级收集、关卡阶梯、连击计分 —— 全在 11 注入插件 + 单屏 + 便宜模型可生成范围内。