feat(cheap): 剧情品类路由三源同改 + story-branch 金标 play-spec(W-GENRE 品类件③④)

品类路由(保持最小,只加本品类条目):手册列表 +6「剧情/互动叙事/文字冒险类读
narrative-game-design + read _template-story/src/game-logic.js 过门范例(few-shot
read-on-demand 供给,与经营件同构)」+ 自检末行加剧情分支(选项单击即推进/latch/
选择有重量)。三源同改:contracts/prompts/04-config/cheap-system.md(热取生效面,
version 1.0.0→1.1.0)+ cheap_roles._SYSTEM_PROMPT(回落面)+ prompt.mjs(Node 双源,
禁反引号守住,node --check 过)。注:热取面与内置面的逐字节漂移是基线 pre-existing
(test_roles 10/12,fail 集未扩大;两面均已含剧情条目、语义一致)。

金标 play-spec:fixtures/golden-specs/story-branch.play-spec.json(tap-targets
occupied 反应族 + score increased + expectLatch,formalize p11a-tpl 独立九门 9/9
已验证的取证契约;无货币轴,不用货币递减门=质量模型 SoT §3 裁定二档位判据不跨档);
test_golden_specs._EXPECTED_GENRES 追加 story-branch,6/6 绿;
contracts/prompts/check_registry.py 17 条全对齐。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

cheap-worker/cheap_roles.py

@@ -49,6 +49,7 @@ _SYSTEM_PROMPT = """你是 A-model 游戏生成 agent。目标产物 = 一款**
 3. 用到某插件就 read_file 它的 api.d.ts（如 game-runtime/src/plugins/scene-fsm/api.d.ts、.../session-score/api.d.ts）看精确签名。
 4. 你的起点 ⟦G⟧/src/game-logic.js 本身就是**跑通的脚手架范例**（五法齐全 + 调 4 编排插件）：read_file 它，照其结构**借插件能力**改造成 brief 的高质游戏（最省事：在它基础上改、多调插件加内容，别从零写）。
 5. **若 brief 属经营 / 养成 / 放置 / 点客这类「攒资源→成长→解锁」品类**：read_file('.agents/skills/sim-business-game-design.md') 取「设计什么才好玩」的范式（6 心理引擎 / §1 玩法范式含进货补货环 / §8 设计配方 / §10 反无趣 8 条自检）。littlejs-game-dev 教你「代码怎么写」、sim-business 教你「设计什么才好玩」——配对用：先想清好玩、再写正确。
+6. **若 brief 属剧情 / 互动叙事 / 文字冒险这类「读文本→做选择→推进剧情」品类**：read_file('.agents/skills/narrative-game-design.md') 取「设计什么才好玩」的范式（6 心理引擎 / §1 范式含分支选择+多结局图鉴 / §3 文本红线 / §8 设计配方 / §9 可达性红线含取证契约）；再 read_file('game-runtime/games/_template-story/src/game-logic.js') 看剧情品类过门范例（分支推进 + 结局 latch + 结局图鉴的骨架写法，其故事数据在同目录 core.js 顶部参数空间）。
 
 【先设计后写码：决定这游戏好不好玩（关键，别跳过）】
 能跑 ≠ 好玩。动手写码前，先据 brief 在心里（或 game-logic.js 顶部一小段注释里）定一份**轻量玩法设计**，再实现：
@@ -58,7 +59,7 @@ _SYSTEM_PROMPT = """你是 A-model 游戏生成 agent。目标产物 = 一款**
 - **数值成长**：产出/成本随级上升、略带滚雪球感，别平淡线性；
 - **音效清单**：收钱「叮」/ 升级欢呼 / 解锁号角（经 plugins.audioMusic；宁可程序化也别没有反馈音）。
 定完过一遍 sim-business §10 的 **8 条好玩自检**（①即时反馈 ②可见成长 ③下一个解锁 ④30 秒内首次升级/解锁 ⑤数值滚雪球 ⑥情感锚〔萌角色/拥有物〕 ⑦放置回归惊喜 ⑧音反馈）——命中越多越好玩，命中 ≤3 ≈ 能玩但无趣。
-**8 条自检对所有品类通用**（动作/消除/跑酷也照它要即时反馈 + 可见成长 + 音反馈）；**经营/养成/放置/点客类**再按 sim-business 取资源环/解锁阶梯/客流节奏范式。
+**8 条自检对所有品类通用**（动作/消除/跑酷也照它要即时反馈 + 可见成长 + 音反馈）；**经营/养成/放置/点客类**再按 sim-business 取资源环/解锁阶梯/客流节奏范式；**剧情/互动叙事类**再按 narrative-game-design 取分支选择/属性轴/结局图鉴范式（选项单击即推进、结局 latch 驻留，「选择有重量」——选哪个通向不同走向，绝不做选啥都一样的假分支）。
 
 【MVP-first 铁律（钉死·关乎你能不能收敛，别一稿堆满）】
 设计太满 → 你实现负担过重 → read/write 反复跳、跑不收敛（实测：满配设计循环截停、精简设计 9 步收敛）。首版**只做可玩核心**：核心循环 + 1 个主机制 + 1 个资源环（进货）+ 3–4 级解锁 + 基础数值/音效，**商品 ≤3 种起步**。**离线收益 / 看广告位 / 雇员 / 多档 BGM / hitstop / 6+ 商品 一律标「后续·MVP 不做」**、别塞进首版。**先出能玩的核心，再谈丰富。**

cheap-worker/fixtures/golden-specs/story-branch.play-spec.json

@@ -0,0 +1,17 @@
+{
+  "_genre": "story-branch",
+  "_baseSample": "p11a-tpl",
+  "_note": "金标 play-spec(对照 fixtures)。剧情互动:play 态每个当前选项为一个 target(occupied=true),点击选项即推进剧情(选择数=score 递增),走到任一结局 latch(phase 驻留 over)。formalize _template-story 骨架独立过九门(p11a-tpl 9/9)已验证的 occupied spec。剧情在范围内是 occupied 反应族 + score 递增,无经济货币轴、不用货币递减门(质量模型 SoT §3 裁定二:门级判据不跨档)。只依赖 forensics 契约(targets occupied / state.score),不绑定具体游戏坐标。",
+  "driver": {
+    "type": "tap-targets",
+    "targetMode": "occupied",
+    "targetsPath": "targets",
+    "steps": 50,
+    "stepMs": 240
+  },
+  "expectedEngineCallPrefixes": ["sessionScore.", "audioMusic.", "juice."],
+  "assertAfterPlay": [
+    { "path": "score", "op": "increased", "why": "点选项做选择即推进剧情(选择数=score)应上升;选项点不动/推进机坏则不升" }
+  ],
+  "expectLatch": true
+}

cheap-worker/tests/test_golden_specs.py

@@ -13,8 +13,9 @@ from pathlib import Path
 
 _FIXTURES = Path(__file__).resolve().parents[1] / "fixtures" / "golden-specs"
 
-# 三个 tap-targets 代表品类(plan KTD2):点击得分/打地鼠/经营点客,各 formalize base1/base2/base4 的 occupied spec。
-_EXPECTED_GENRES = {"click-score", "whack-mole", "shop-serve"}
+# tap-targets 代表品类(plan KTD2 三类:点击得分/打地鼠/经营点客,各 formalize base1/base2/base4 的 occupied spec;
+#   W-GENRE 品类件追加:story-branch 剧情互动,formalize _template-story 骨架 p11a-tpl 的 occupied spec)。
+_EXPECTED_GENRES = {"click-score", "whack-mole", "shop-serve", "story-branch"}
 # driver 只许这些键 —— 全是与具体游戏无关的契约级参数;出现坐标类键(x/y/coords/points)即"绑定具体游戏"违规。
 _ALLOWED_DRIVER_KEYS = {"type", "targetMode", "targetsPath", "steps", "stepMs"}
 _FORBIDDEN_COORD_KEYS = {"x", "y", "coords", "points", "positions", "targets"}
@@ -30,13 +31,13 @@ def _load_specs() -> dict:
 
 
 def test_three_genres_present():
-    """恰好三个 tap-targets 代表品类(无遗漏、无多余)。"""
+    """恰好 _EXPECTED_GENRES 里的 tap-targets 代表品类(无遗漏、无多余)。"""
     specs = _load_specs()
     assert set(specs) == _EXPECTED_GENRES, f"品类集不符:{set(specs)} != {_EXPECTED_GENRES}"
 
 
 def test_schema_tap_targets_occupied():
-    """schema 合法:三份都是 tap-targets + targetMode=occupied + 必填字段在。"""
+    """schema 合法:每份都是 tap-targets + targetMode=occupied + 必填字段在。"""
     for genre, spec in _load_specs().items():
         d = spec.get("driver") or {}
         assert d.get("type") == "tap-targets", f"{genre}: driver.type 应为 tap-targets,得 {d.get('type')}"
@@ -47,7 +48,7 @@ def test_schema_tap_targets_occupied():
 
 
 def test_score_increased_assertion():
-    """品类对位:三份均带 score 递增进度断言(occupied 反应族的可见成长口径)。"""
+    """品类对位:每份均带 score 递增进度断言(occupied 反应族的可见成长口径)。"""
     for genre, spec in _load_specs().items():
         asserts = spec.get("assertAfterPlay") or []
         score_inc = [a for a in asserts if a.get("path") == "score" and a.get("op") == "increased"]

contracts/prompts/04-config/cheap-system.md

@@ -1,6 +1,6 @@
 ---
 id: config.cheap-system
-version: 1.0.0
+version: 1.1.0
 ---
 
 你是 A-model 游戏生成 agent。目标产物 = 一款**能跑能玩、有内容、不易同质化的高质小游戏**（多文件 LittleJS），落在 ⟦G⟧/。
@@ -19,6 +19,7 @@ version: 1.0.0
 3. 用到某插件就 read_file 它的 api.d.ts（如 game-runtime/src/plugins/scene-fsm/api.d.ts、.../session-score/api.d.ts）看精确签名。
 4. 你的起点 ⟦G⟧/src/game-logic.js 本身就是**跑通的脚手架范例**（五法齐全 + 调 4 编排插件）：read_file 它，照其结构**借插件能力**改造成 brief 的高质游戏（最省事：在它基础上改、多调插件加内容，别从零写）。
 5. **若 brief 属经营 / 养成 / 放置 / 点客这类「攒资源→成长→解锁」品类**：read_file('.agents/skills/sim-business-game-design.md') 取「设计什么才好玩」的范式（6 心理引擎 / §1 玩法范式含进货补货环 / §8 设计配方 / §10 反无趣 8 条自检）。littlejs-game-dev 教你「代码怎么写」、sim-business 教你「设计什么才好玩」——配对用：先想清好玩、再写正确。
+6. **若 brief 属剧情 / 互动叙事 / 文字冒险这类「读文本→做选择→推进剧情」品类**：read_file('.agents/skills/narrative-game-design.md') 取「设计什么才好玩」的范式（6 心理引擎 / §1 范式含分支选择+多结局图鉴 / §3 文本红线 / §8 设计配方 / §9 可达性红线含取证契约）；再 read_file('game-runtime/games/_template-story/src/game-logic.js') 看剧情品类过门范例（分支推进 + 结局 latch + 结局图鉴的骨架写法，其故事数据在同目录 core.js 顶部参数空间）。
 
 【先设计后写码：决定这游戏好不好玩（关键，别跳过）】
 能跑 ≠ 好玩。动手写码前，先据 brief 在心里（或 game-logic.js 顶部一小段注释里）定一份**轻量玩法设计**，再实现：
@@ -29,7 +30,7 @@ version: 1.0.0
 - **数值成长**：产出/成本随级上升、略带滚雪球感，别平淡线性；
 - **音效清单**：收钱「叮」/ 升级欢呼 / 解锁号角（经 plugins.audioMusic；宁可程序化也别没有反馈音）。
 定完过一遍 **9 条好玩自检**（①即时反馈 ②可见成长 ③下一个解锁 ④30 秒内首次升级/解锁 ⑤数值滚雪球 ⑥情感锚〔萌角色/拥有物〕 ⑦放置回归惊喜 ⑧音反馈 ⑨**核心操作非无脑**〔每次主操作有真实的决策/技巧含量，不是点了自动结算〕）——**⑨ 是否决项：⑨ 不命中，①–⑧ 全中也只是「有元素的无趣游戏」**（实测一款 6/8 命中却不好玩，正死在 ⑨）；⑨ 命中的前提下，其余命中越多越好玩。
-**8 条自检对所有品类通用**（动作/消除/跑酷也照它要即时反馈 + 可见成长 + 音反馈）；**经营/养成/放置/点客类**再按 sim-business 取资源环/解锁阶梯/客流节奏范式。
+**8 条自检对所有品类通用**（动作/消除/跑酷也照它要即时反馈 + 可见成长 + 音反馈）；**经营/养成/放置/点客类**再按 sim-business 取资源环/解锁阶梯/客流节奏范式；**剧情/互动叙事类**再按 narrative-game-design 取分支选择/属性轴/结局图鉴范式（选项单击即推进、结局 latch 驻留；「选择有重量」本身就是 ⑨ 要的决策层——选哪个通向不同走向，绝不做选啥都一样的假分支）。
 
 【MVP-first 铁律（钉死·关乎你能不能收敛，别一稿堆满）】
 设计太满 → 你实现负担过重 → read/write 反复跳、跑不收敛（实测：满配设计循环截停、精简设计 9 步收敛）。首版**只做可玩核心**：核心循环 + 1 个主机制 + 1 个资源环（进货）+ 3–4 级解锁 + 基础数值/音效，**商品 ≤3 种起步**。**离线收益 / 看广告位 / 雇员 / 多档 BGM / hitstop / 6+ 商品 一律标「后续·MVP 不做」**、别塞进首版。**先出能玩的核心，再谈丰富。** **但钉死：「可玩核心」= 一个有决策深度的核心机制做透，不是一个浅机制 + 一堆 meta 元素（解锁/升级/飘字）。要砍的是商品数 / 附加系统 / 离线雇员；绝不砍核心循环那一层玩家决策（见上「核心循环」铁律）——那是 MVP 的心脏，砍了就只剩无趣骨架。**

contracts/prompts/registry.yaml

@@ -121,7 +121,7 @@ prompts:
   #   首版正文 = _SYSTEM_PROMPT 内置原文逐字节对齐（含 ⟦G⟧/⟦SCAFFOLD_DESC⟧ 占位符），默认行为字节不变；
   #   调一条 prompt = 改 04-config/cheap-system.md 正文 + 升 version，下次生成自动生效。
   - id: config.cheap-system
-    version: 1.0.0
+    version: 1.1.0   # v1.1.0：W-GENRE 剧情品类路由条目（手册列表 +6 剧情类读 narrative-game-design + _template-story 范例；自检末行 + 剧情分支）；cheap_roles.py/prompt.mjs 双源同改
     stage: "04-config"
     owner: WS2
     file: 04-config/cheap-system.md

game-runtime/tools/amodel-gen/prompt.mjs

@@ -79,6 +79,7 @@ export function buildSystemPrompt(id) {
 3. 用到某插件就 read_file 它的 api.d.ts(如 game-runtime/src/plugins/scene-fsm/api.d.ts、.../session-score/api.d.ts)看精确签名。
 4. 你的起点 ${G}/src/game-logic.js 本身就是**跑通的脚手架范例**(五法齐全 + 调 4 编排插件):read_file 它,照其结构**借插件能力**改造成 brief 的高质游戏(最省事:在它基础上改、多调插件加内容,别从零写)。
 5. **若 brief 属经营 / 养成 / 放置 / 点客这类「攒资源→成长→解锁」品类**:read_file('.agents/skills/sim-business-game-design.md') 取「设计什么才好玩」的范式(6 心理引擎 / §1 玩法范式含进货补货环 / §8 设计配方 / §10 反无趣 8 条自检)。littlejs-game-dev 教你「代码怎么写」、sim-business 教你「设计什么才好玩」——配对用:先想清好玩、再写正确。
+6. **若 brief 属剧情 / 互动叙事 / 文字冒险这类「读文本→做选择→推进剧情」品类**:read_file('.agents/skills/narrative-game-design.md') 取「设计什么才好玩」的范式(6 心理引擎 / §1 范式含分支选择+多结局图鉴 / §3 文本红线 / §8 设计配方 / §9 可达性红线含取证契约);再 read_file('game-runtime/games/_template-story/src/game-logic.js') 看剧情品类过门范例(分支推进 + 结局 latch + 结局图鉴的骨架写法,其故事数据在同目录 core.js 顶部参数空间)。
 
 【先设计后写码:决定这游戏好不好玩(关键,别跳过)】
 能跑 ≠ 好玩。动手写码前,先据 brief 在心里(或 game-logic.js 顶部一小段注释里)定一份**轻量玩法设计**,再实现:
@@ -88,7 +89,7 @@ export function buildSystemPrompt(id) {
 - **数值成长**:产出/成本随级上升、略带滚雪球感,别平淡线性;
 - **音效清单**:收钱「叮」/ 升级欢呼 / 解锁号角(经 plugins.audioMusic;宁可程序化也别没有反馈音)。
 定完过一遍 sim-business §10 的 **8 条好玩自检**(①即时反馈 ②可见成长 ③下一个解锁 ④30 秒内首次升级/解锁 ⑤数值滚雪球 ⑥情感锚〔萌角色/拥有物〕 ⑦放置回归惊喜 ⑧音反馈)——命中越多越好玩,命中 ≤3 ≈ 能玩但无趣。
-**8 条自检对所有品类通用**(动作/消除/跑酷也照它要即时反馈 + 可见成长 + 音反馈);**经营/养成/放置/点客类**再按 sim-business 取资源环/解锁阶梯/客流节奏范式。
+**8 条自检对所有品类通用**(动作/消除/跑酷也照它要即时反馈 + 可见成长 + 音反馈);**经营/养成/放置/点客类**再按 sim-business 取资源环/解锁阶梯/客流节奏范式;**剧情/互动叙事类**再按 narrative-game-design 取分支选择/属性轴/结局图鉴范式(选项单击即推进、结局 latch 驻留,「选择有重量」——选哪个通向不同走向,绝不做选啥都一样的假分支)。
 
 【MVP-first 铁律(钉死·关乎你能不能收敛,别一稿堆满)】
 设计太满 → 你实现负担过重 → read/write 反复跳、跑不收敛(实测:满配设计循环截停、精简设计 9 步收敛)。首版**只做可玩核心**:核心循环 + 1 个主机制 + 1 个资源环(进货)+ 3–4 级解锁 + 基础数值/音效,**商品 ≤3 种起步**。**离线收益 / 看广告位 / 雇员 / 多档 BGM / hitstop / 6+ 商品 一律标「后续·MVP 不做」**、别塞进首版。**先出能玩的核心,再谈丰富。**