docs(.agents): 蒸馏批B 坑#9(shell-out validate 须尊重子工具 ok)+ §8 production 进展

坑#9=批B Fix A 通用红线:gen.mjs done-gate stage→smoke,smoke 失败留陈旧坏 bundle,validate 只查存在会误过→须读 harness ok 标记 + failCount 由 validate 统一计。§8=集成方式C/批B 收口(3fbb3197)+ 真阻塞 M3 生成质量 reading 'w'(非集成)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

.agents/skills/agentic-amodel-generation.md

@@ -62,6 +62,7 @@ ssh -o ProxyCommand=none root@100.64.0.7 'cd /root/game-staging/repo/game-runtim
 6. **boot envelope(沿用 `_template`)**:全局名 `TemplateGame` + `buildTemplateHostConfig`(host-config 导出名固定,别改)+ 标记 `__gameBooted/__gameHost/__gameForensics`;play 用 `?engine=real`;build `--global-name=TemplateGame`。
 7. **路径深度**:游戏落 `games/<id>/`(直接在 games/ 下,与 catch-fruit 同深度)→ `src/*.js` import 插件用 `../../../src/`(3-up)。嵌更深一层会变 4-up,esbuild 解析失败。
 8. **固定 plumbing 不让 agent 碰**:`index.html`/`entry.js`/`src/main.js`(scaffold 自带);agent 只写 `src/{game,core,render,host-config,assets}.js`。
+9. **shell-out 集成:调用方 validate 必须尊重子工具的 ok 判定,不能只查产物存在**(批B Fix A 实证)。`gen.mjs --mode saa` 的 done-gate 顺序是 **stage→smoke**:smoke 失败 done 被拒,但 stage 已把**陈旧坏 bundle 落盘**(harness 返 `ok:false/stagedDir:null` 却留了文件)。SAA validate 节点若只断言 `_wg1-gen/<id>/bundle.iife.js` 存在 → 误过坏件 → 路由 play → 九门必崩 + 白耗一次 ~10min 真玩。修法:generate 把 harness ok 写进 state(`K_AMODEL_GEN_OK`),validate **先尊重该标记**(false→直接救场、不读陈旧产物);且 generate **不自增 failCount**(留 validate 统一计一次,与 factory/gamedef「generate产出/validate计数」同口径,否则双重计数提前 escalate/giveup)。
 
 ## 6. M3 实证(2026-06-21,HJ-AGI-003)
 
@@ -77,6 +78,8 @@ ssh -o ProxyCommand=none root@100.64.0.7 'cd /root/game-staging/repo/game-runtim
 
 整体 = Anthropic taxonomy 的 **orchestrator workflow + 内嵌 agentic(ReAct)+ evaluator-optimizer(repair)**,属"受约束 agentic"——主流且被推荐用于可预测生产管线。已采纳"循环内便宜快反馈(check/build)+ 循环外昂贵权威验证(play)"分层。**按需补的缺口**:agent scratchpad、更强的长循环压缩、play 失败→repair 回环(spike 暂线性 done→play)。
 
-## 8. 下一步(production)
+## 8. production 进展(2026-06-22)
 
-spike 过 → 把本 agentic generate 端口进 `SaaStudioGraph` 的 generate 节点(Java 侧重写,调用同形态 M3 tool-loop),按设计 §0.5 删 gamedef/factory,validate/play 换 A-model 版。**须过 §6.8 Codex+Opus 双评审后才执行删除(D1=A 无退路)。**
+- **集成方式 = C(shell-out 混合,非 Java 重写 tool-loop)**:SAA generate 节点 shell-out `gen.mjs --mode saa`,保留 SAA play 九门/player/nreview/emit/checkpoint。Phase1(schema oneOf)+ 批A(harness SAA-mode)+ **批B(SAA Java amodel 路,commit `3fbb3197`)** 已收口。批B 严格验证:mini mvn test-compile + **83/83 SAA 确定性回归全绿**(零回归)+ 控制测试(pristine 模板 smoke PASS)+ 坑#9 Fix A。
+- **⚠️ 当前真阻塞 = M3 生成质量,非集成**:amodel e2e **0/1**——M3 代码 boot 崩 `Cannot read properties of undefined (reading 'w')`,跨 breakout+打地鼠两游戏复现(2/2);pristine `_template` boot 干净 → 证 M3 代码 bug。`reading 'w'` 疑似 M3 常犯 API 误用,值得**诊断后加 ❌→✅ footgun**(同 defineScenes/opts.ctx 那批);并查 M3 是否较 saae2e4(早前 PASS)退化。
+- **再后**:Phase3 硬门(amodel 过 SAA objective A–E)→ Phase4 cutover 删 gamedef/factory(数据门 ≥60% + §6.8 双评审 + 二次批准,D1=A 无退路)。**前置 = 先把生成质量攻到稳定产可玩游戏。**