games-development-ai/docs/agent-specs/_archive/2026-06-10-Mc模板波-批①收口报告.md
zizi 7f24a344d0 docs(agent-specs): B2 归档——64 个闭线工作记录移入 _archive/,热目录顶层 90→26
承接目录治理:上轮只压缩内容未减文件数,闭线工作记录仍平铺致目录看着仍一堆(创始人指出)。本次执行 B2 归档。

64 个 ≤06-15 闭线档(25 压缩桩 + 闭线 review/report/纪要/edit-plan)git mv 入 docs/agent-specs/_archive/(文件名不变、仍 git 跟踪可查)。热目录 ≤06-15 仅留 13 活档(决策/纲领/SoT/活spike)+13 个 06-16 在飞。

活资产 20 处旧路径引用(.agents/docs/memory/_index)同步改 _archive/,引用断裂复测=0;_index 活地图 + 治理档状态收口。约束:0 个 06-16 被移、orchestrator 等未跟踪在飞档零误纳。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-16 13:26:19 +00:00

5.8 KiB
Raw Blame History

M-c 模板波批①(merge 全链)· 收口报告

  • 文档编号: HJ-MC-TPL-CLOSE-001
  • 日期: 2026-06-10(单日闭环:execution v2 核验 → 建设 → 构建门 → 五级验收门 → 收口落账)
  • 执行依据: 2026-06-10-Mc模板波-execution.md(HJ-MC-TPL-EXEC-001 v2,12e0c8f)
  • 提交链: b1fa30d(契约) → da9d109(后端) → cdf4d82(runtime) → a9c5368(编排器) → 831c9cb(守卫修) → d389294/f8c6bd1(Golden harness+产物) → 55bcdf6(verify_package 修) → 8bd3ebf(校准批产物)
  • 结论: 批① merge 全链收口,五级验收门全过;merge 成为第二个可生成、可玩、可进 feed 的模板。

1. 五级验收门终判(spec §9)

级 判据 终判 关键证据
1 schema 入册 judge array 补丁+三测试重写全绿+merge 资源 classpath+构建绿+三处同源 ✅ mini-desktop mvn -pl aigc-server test 63/63 绿;fat jar 内嵌 grep 3 命中(AigcTemplateConstants.class/merge-designer.md/merge.schema.json);83 py 单测主 agent 亲跑 OK
2 runtime 真玩 构建+体积/契约门+真实落包+merge 五 AND+clicker 回归+截图 ✅ staging 构建 885ms 绿;startRuntime(min) raw=4,828B(<15,360 硬线/<8,192 软门,merge 增量 +3,155B);真实 LLM 生成 28s 落包 93053(多肉合成记,targetLevel≤chainLength 等约束 LLM 首跑全中);merge 五条 AND 全绿(score=7=2^(4-1)-1 理论值,布局契约双侧公式运行时逐格命中实证);clicker 真包 93029 回归五绿+demo 9001 自检 PASS;预览/玩家面双截图留档
3 QA 闭环 Golden 回归 merge 守卫全中+查重覆盖 ✅ runs/golden-regression-v1.1.2/ PASS:3 merge 守卫全中(kill 题文不符/kill 越模板机制/accept 不误杀)+ k-0cfbc296 不回归(首采抖动 3/3 重采判过,不动口径)+ g9019/g9011 零新增误报;dedup title/theme 模板无关(校准批活验 10 条零冲突)
4 校准批 10 条全自动流完零 infra(不设硬门) ✅ 超额 runs/merge-cal-10/:accept 10/10=1.0(结构/可运行/可接受三层漏斗全 1.0),infra=0,fix 闭环 1/1,495s/31 次 LLM
5 金丝雀入 feed feed 可见+实玩截图 ✅ 金丝雀 10 条 published=true ∧ feedVisible=true(postcheck 机器验证×10);玩家面 /play/9076/93055「多肉盆栽」零门槛实玩截图(evidence/mc-play-93055.png 等三张)

2. 实战逮修缺陷(本波真金)

  1. 鉴权 requiresAuth 守卫 × player 取证 UI 导航(831c9cb):鉴权波 /create/preview 守卫只认 localStorage 真 token,「批跑不经 UI 守卫」注释假设对取证导航不成立——本波首次部署含守卫的新前端 dist 即拦取证(登录页截图+console/network 全空实锤)。修法=导航前 addScriptToEvaluateOnNewDocument 注 wanxiang_token=test1(mock 与真 token 并存为鉴权波已拍口径,全链 Authorization 值不变=行为等价)。
  2. run_batch._verify_package merge 取参 KeyError 整批熔断(55bcdf6):expected_target=design["config"]["target"] 系 clicker 专属直取——与 spec 点名修掉的 :772 同款,但 :732 这处 spec 枚举漏列、实现 lane 同漏;校准批首跑 1 设计 infra→占比熔断逮获。修法 .get("target")(None 期望自动跳过比对,clicker 零变化)。
  3. pom 资源静默漏复制(spec §6.2 预判,建设期落地):原 includes 仅 clicker 两单文件,merge 不进 classpath 即自禁用;改通配后新模板两资源自动进包(批② 零 pom 改动)。

3. 关键裁决落账(spec §14 推断项)

  • #1 白名单来源=AigcTemplateConstants 编译期常量(避 @ConditionalOnProperty 装配缺席,两消费点同源);#4 体积软门=8,192B(实测 4,828B 余量 41%);#6 merge score=合成次数;布局契约补钉 topPad=round(H*0.18)(spec §5.3.1 散文漏钉的承重参数,runtime/player 双侧字面同一)。
  • §4.5 doctrine 双标签括注箭头方向系笔误(与 §4.3 矛盾),以 §4.3 为准=v1.1.2 期望 kill,eval README 已按正确方向记+errata 注记,spec 已勘误回正。

4. 观察项与遗留(非阻断)

  1. 对抗稳定性复测 2/3(0.667):校准批 run_batch 自带稳定性抽检小样本(retested=3),低于 golden 轮 80% 口径——校准批不设门如实记录,20 条正式批须关注(样本量更大后再判)。
  2. _read_iframe_canvas_size 退化路径为常态:iframe sandbox 跨边界 canvas W/H 常不可读,退化 rect 等分映射(canvas 充满 iframe 且 dpr 均匀时数学精确)——本轮全部命中实证可用;若未来宿主布局加边距须重审。
  3. 校准批首跑废账:runs/merge-cal-10 含 run1 的 1 条 infra 判定(38d884b7 verify KeyError),resume 后重走收口(93055 published);ledger 旧 task 留档属设计内。
  4. 批② idle/tycoon:前置已清(配方 .agents/skills/add-game-template.md + spec §13 占位);idle 涉 GamePlayer.vue storage 挂点(本波未动)。
  5. 正式批 20 条(accept ≥80% 量级)待开;W4 单位经济埋点待排期(与本波无依赖)。

5. 证据指针

  • 批报告:docs/agent-specs/2026-06-09-agent-loop-v1/runs/merge-cal-10/report.{md,json} + ledger.jsonl + evidence/(含 feed/实玩三截图)
  • Golden 回归:docs/agent-specs/2026-06-09-agent-loop-v1/runs/golden-regression-v1.1.2/(results.json/report.md §四 终裁/raw 含抖动重采四轮)
  • 取证:orchestrator/qa-evidence/mc-merge-93053/(merge 真包五 AND 报告+截图)、self-test-93029-*/self-test-9001-*(clicker 回归)
  • 生产启动实证:staging app.log [executor-selfcheck] 双模板装载 banner(clicker 1.1.0+merge 1.0.0,validator templates=[clicker, merge])