zizi-al/games-development-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
411 Commits 4 Branches 0 Tags
Commit Graph

256 Commits

Author SHA1 Message Date
zizi
39c16630ed merge(saa): 真结构化生成地基 feat→dev/2.0.0——U1-U4(运行时约定/build-from-source/真产gameDefinition/多模型回退)+6c6g评审整改(P1 K_STATUS清零/P2 fallback注释);flag默认factory灰度opt-in,生产零行为变更 2026-06-18 16:46:19 +00:00
zizi
8ccb5c7c7e docs: 内网凭据档(NEWAPI_KEY 等)+ AGENTS §6 条款9——内网阶段 keys/decisions 进文档、禁 env var(创始人定) 
创始人 2026-06-18:内网阶段所有决策+密钥进项目文档,不靠环境变量(内网 key 允许入仓)。新建 docs/内网凭据与端点.md 作密钥/端点单一事实源(NEWAPI_KEY=sk-84GA…/base http://100.64.0.8:3000/四机/Gitea);AGENTS §6 加条款9立为硬约束——需 key 查该档,别再反复找创始人要(已给几十次)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 16:33:22 +00:00
zizi
a5c453f7c4 docs: 根因分析改进落地——003-U1 补改进杠杆(c1命门/a2/a3 等) + 修 saa skill 过时'天花板'口径 
据 docs/brainstorms/2026-06-18-生成失败根因分析:① 003-U1 补可执行改进杠杆(序=c零成本先→a升档+b ReAct;c1换few-shot含_forensicsView=命门/c2 I_control判据/c3 F_wiring接线/c4 H终局语义/a2 failCount重置/a3回喂源码),先单验c1;② saa skill 把'难门=生成质量天花板'(已被根因分析+Codex证伪)改为'主因=喂不全+救场不足+门判据偏'。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 15:16:06 +00:00
zizi
a0af0f658c docs(brainstorm): 生成 60% 失败根因分析——喂不全为主(命门=few-shot 缺 _forensicsView)非天花板 + 改进清单 
创始人 2026-06-18 指派。Opus 取证 + Codex 验证(双视角):① 命门=注入的 few-shot 探针 _goldenpath-probe/factory.js 缺 _forensicsView/latch,而 prompt 硬要求它→模型抄没见过的东西(代码直证 SaaPrompts:63/108 vs probe:77);② I_control 平滑跟手 harness 查、prompt 零提及;③ 真模型硬天花板无样本实证、非主因(scale-20 无'人工介入后仍不过'的款,Codex 同此);④ 救场两弱点:failCount 跨档不重置(强档只剩3次)+ 普通 repair 不回喂源码。改进序=c(零成本 prompt/few-shot 先)→ a 升档+b ReAct 并行;首步=mini-desktop 重跑取真 dump(两机现无 per-game dump,占比是推断)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 14:42:33 +00:00
zizi
7d4a77c36b docs(plan): 003 落创始人拍板——质量门优先 + 达标主杠杆=升模型档+ReAct(待拍→已定) 
创始人 2026-06-18:① 质量门 ≥80% 优先于成本 ¥0.15/款(临时破价 Phase-3 压回);② 达标主杠杆 = 升默认模型档 + ReAct(两者都上,ReAct 从'备选退路'提为主路,001-U5);(ii)降判据/(iv)改门为备选。③ 配套:Claude 做生成失败根因分析(另出)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 14:20:42 +00:00
zizi
0b8b968292 docs(plan): P1 按并行/串行拆两档(创始人定)—— 002 并行线 + 003 串行线,过 Codex+Opus 双评审 
创始人定:P1 = 001(生成机制线,执行中不改)+ 002(并行线:广度后端 U1-U7 + 前端 U8-U10 + 引擎收尾 U11 + 2 孤儿 P-OPN-08/P-ACC-03)+ 003(串行线:质量收口→flip→M0→最终验收 003-U4 + 退路)。按'能否并行'拆,解掉命运耦合(合并版的 P0)。拟 plan 004(引擎)并入 002-U11。

双评审(AGENTS §6 条款8):Codex 揪 1 阻断(P-OPN-08 需后端公开聚合 API、原误当纯前端)+ 4 重要(U11 先差分勿重造〔runtime 已有 drawText/SpatialHash/MTV〕/ P-ACC-03 验收面拓 feed/play/主页 / 003-U4 补 M1-M3 明细 / 跨档引用 + compliance 标注)全修;Opus 收敛复核确认 001+002+003=P1 全集无真孤儿、轴切自洽、无 P0、可收口。留 2 待拍(质量门≥80% vs 成本¥0.15 优先级 / 80% 不可达退路)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 14:09:20 +00:00
lili
cb0a273d43 docs(plan): plan-001 加执行状态收口快照(U1-U4 交付/验证 + gamedef 实证 + U5 延期 + 待 6c6g) 
应创始人「update plan 001」：在 plan 2026-06-18-001 进展结论后加「执行状态」节(决策正文 U1-U5/KTD/HTD 不动)：
- U1-U4 已交付+本机验证+推送(引擎 node --test 60/60;后端 mvn test-compile + Topology 30/30+Regression 8/8;双评审 18 条整改)；U1 含正式化 runtime-api-2d.d.ts + clickable 基元。
- gamedef 路实证:路径两品类均过 harness 9/9、repair 真抬率;success rate=引擎生成能力(高方差,正式 cutover authoritative=mini-desktop)。
- U5 正式延期(pom Phase1.5 + 地基稳后门)。
- 待 6c6g:schema clickable 枚举(不动现8契约)/ assertAfterPlay 字段词汇(共享 DESIGN_SYSTEM)/ 评审。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 06:44:26 -07:00
zizi
16467157c1 docs(plan): 新建 003 Phase-1 生死门(质量达产线门+flip+M0验收)—— Codex+Opus 双评审整改 3 P0 
立项=双评审 P1-3(生死门无家)。新建后按 AGENTS.md §6 条款8 过 Codex+Opus 双评审,Opus 揪 3 P0 全整改:P0-1 60→80% 跨路径错配(60%=iife旧路/80%门所在 gameDefinition 路零行已建)→改'先实测真基线再收敛';P0-2 stage2救场已计入基线=空头退路→增'80%不可达退路分支'(升档/降判据/ReAct/改判门);P0-3 质量门 vs ¥0.15 成本门无优先级→列待拍(推荐质量优先)。+2 P1(M0机制归001本档只补验收gate/gating链显式追踪表)+2 P2(80%门测试加minSuccessRate硬断言/M0口径收窄不混M1/flip两步+回退/术语)。剩2项待创始人拍。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 08:28:04 +00:00
zizi
e6cd1a2cd0 docs(plan): 002 双评审整改(P0-2 创作页归属/P1-1 分批验收门/P0-1 命名空间/P2) 
按创始人新评审门(brainstorm/plan 必 Codex+Opus 双评审)对 b53d2152 增量补评审,Opus 对抗式揪 2 P0,本提交修在档内的:P0-2 U8↔U9 创作页前端归属切清(owner=U8、U9 不重复)/ P1-1 U9 验收门拆子门A(已可接 feed/钱包/账号)·子门B(gated 社区/素材/模板)防8页伪完成 / P0-1 加 002 编号命名空间声明(喂Mac带 002-Ux,与 001 U1-U5 两套)/ P2 校准 P-CRT-13(壳已在非替mock)·摘要七域注·U10三跨联合验·U9八页映射。跨档项(001 加80%flip+M0 unit·前端线残迹sweep·总账回填)列收口待办待创始人点头。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 07:43:33 +00:00
zizi
b53d215257 docs(plan): Tier-1 计划 002 并入前端接线+创作可用性骨架(U8-U10) 
按创始人拍板(a):不新建 plan 文件,就地把缺口当 units 补进现有 Tier-1 活计划(遵一题一活档·禁一 pivot 一文件)。新增 U8 创作可用性(P-CRT-10/11/13·Tier-0 优先)/ U9 studio 前端接线(8页去mock+素材/玩法模板两新页)/ U10 admin 运营台前端接线;骨架级=只定目标/范围/验收门,file 级实证细节留 Mac 在活代码树补。删过时的「前端接线=前端线」scope-out(新分工 Mac 全包前后端,域切已废)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 07:14:29 +00:00
zizi
5bff11dfaf docs(plan): plan-001 实现单元细化为 Mac 可直接执行版——读码实证 file 清单 + 命令级验收门 + 并入 build段设计 
U1-U5 逐单元补:精确 file 路径(接哪个现有类/方法)、关键决策步骤、可跑验收命令。
并入 build段双证的优化设计:
- U1 运行时约定 rt 面(getEntity/spawn/input/time-random 受控/score-win-lose latch/fx 真调引擎)落 game-runtime/src/host/gd-runtime.js,接 boot.ctx 受控面
- U2 build-from-source 装配六步(strip unknown-key+ajv/内联/createRuntime/声明式渲染器/取证派生/behavior沙箱),接 SaaGenNodes.scaffold/build,解锁 deterministic modify 路(现 guard fail-loud);复用 build.mjs+九门 harness 零改
- U3 generateNode 真产 gameDefinition 落 K_SOURCE_PROJECT,SaaPrompts 新 GAMEDEF_SYSTEM 与现 SYSTEM 物理隔离;难门优化(F门/latch/I_control/约定外helper/unknown-key strip)进 prompt+gatespec;cutover 量化门=过门率≥60%(iife 现基线)
- U4 多模型回退链接现 callWithTimeoutAndRetry+looseParse+救场阶梯;deepseek-v4-flash 打底
- U5 ReAct=ReactAgent.asNode,九门 verdict 强制终止,挂 ToolCallLimitHook

接线锚读码核证(SaaStudioGraph.assemble §6.2 / source-project.schema.json / AigcExecutorProperties);
file 两线分组(canonical §8):U1/U2 引擎线·U3-U5 后端线;验收门给精确 mvn -Dsaa.e2e=1 命令(mini-desktop)。
只改实现单元节,KTD/HTD/背景/进展结论不动。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 05:04:00 +00:00
zizi
771619c7da docs: 新角色分工(Mac开发/6c6g大脑)+ 收编他session loose-end + _index修漂移 
- 多session分工总账 §2/§5/§7 重定:域切→角色切(Mac全开发按计划执行 /
  6c6g设计·计划·评审·文档·优化);Mac工作清单(plan001 SAA产线化Tier0 +
  plan002 Tier-1剩4域 + 前端8页)+ 6c6g大脑角色 + 协调约束(git中介·够不到Mac)
- 收编他session未提交:orchestrator *_walk脚本×6 + v1对话生成修改素材/
  v2生命周期项目管理 review + prefix-cache preflight(保全)
- _index修漂移:v2=ACTIVE范式基座(改源不改包)、v1=留痕(前提被supersede);
  生成域canonical现归本session(6c6g)维护

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 04:56:15 +00:00
zizi
1101d01661 docs(saa): reconcile 生成域 canonical 到双证地基现状 + 并入诚实回退 
三档 canonical reconcile 到 2026-06-18 真相,并入另一 session 诚实回退:

- agentic编排-SAA.md(canonical SoT):§0 当前状态改"16 节点 studio 已建并合入
  dev/2.0.0"(裸图=接法A 七成躯干)+ 分清现产线 iife/GameConfig 路(e2e 60%)
  vs gameDefinition studio 已双证产线化中替换它;§2 图加目标态 gameDefinition
  studio 说明+产线化指针;§7 加双证地基 done(spike 92-100%/build 段 deepseek 3/4
  过九门)+ 16 节点 e2e 首证 done,"他 session 在飞"改"本 session 独家在飞产线化"
  +接法B ReAct 演进(九门兜底=自治在门内裁决在门外);143 行≤150 canonical 限。
- 固定架构-review:顶部加双证地基状态横幅;§4 加 16 节点已建现状注(指 §10.1
  权威)+接法A/B 演进+产线化 plan 指针;§1.5 agent 列表"深析中"改"深析→§10.1
  +全图已建"。并入回退(header 重指 v2 独立档/§4 表初版叙事)。
- 固定架构-execution:顶部加双证地基状态横幅(双证/16 节点/现 vs 目标产线/接法
  A-B/红线解除)。并入回退(§0-5+§12 header 退回"待解",源项目存储归属 studio
  vs project 保持真 open=未拍;缓存+classify spike 已绿解除)。

铁律未破(九门定 done/禁 LLM 自评/接法B 亦九门兜底)。仅编辑 3 档,不碰代码。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-18 04:33:42 +00:00
zizi
8db1414281 docs: 真结构化地基双证 + Tier-1 三域收口回填(plan 001/002 + 总账) 
- plan 001 重写为「SAA 真结构化生成主线—地基产线化+ReAct演进」:spike+build段双证
  地基成立(便宜模型 gameDefinition→build-from-source→真过九门 deepseek满分3/4款),
  创始人拍真结构化+SAA独家本session开发;产线化5单元(运行时约定2D适配器/
  build-from-source产线化/generate真产/模型可靠性/ReAct演进接法B);接法A七成已建是躯干
- plan 002 进展:Tier-1 feed/econ/account 合入 0db1d0da(codex揪3 P0全修,82测试绿),
  剩 social/admin/material/template
- 总账 M2:真结构化地基双证里程碑回填

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 04:20:53 +00:00
zizi
750fdce993 docs(plan): gameDefinition 迁移重构为 spike 先行 + Tier-1 广度拆独立计划 
双对抗评审(codex+opus)揪出初版根本前提问题(gameDefinition 包JS非替代/
赌注未验证/空验收门/基座与广度命运耦合),创始人裁定「前置 spike 先行」。重构:
- 2026-06-18-001 重写:gameDefinition 迁移=前置 spike(路A 模型产结构化 vs
  路B 模型产JS+后端抽取,端到端过门率 vs 现60%基线)+ 工程条件于 spike 通过 +
  引擎线 E1/E2;修正前提框架(源组织JS非替代);engineBundle 全保留冻结
- 2026-06-18-002 新建:Tier-1 七域广度拆出(独立 JIT,不受迁移卡)+ 补强验收级测试矩阵
- 评审7项风险(命门spike/引擎承重/dual-path双cutover/空门/worker split-brain/
  存储归属/历史游戏)全纳

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 02:17:09 +00:00
zizi
d51a6b5943 docs(plan): 后端 Tier0 生成主线收口——U1-U7 机制全收口 + status=completed 
创始人拍板「A 收口后端·defer 切换」。计划加收口结论:
- U1-U6 后端代码全合入(每单 codex 评审揪真 P0 后修绿)+ 契约冻结 8/8
- U7 SAA 真全图 e2e 首证(bf99662c):机制零 prod bug,成功率 60%<80% → 默认产线按门未切,现 worker 主链零回归
- defer 切换触发+配方:dispatcher flag 已存在,门交 W-G1 生成质量域(到 80% 一行 flip)
- status active→completed

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 01:04:19 +00:00
zizi
1bca84c91e docs(saa): SAA 真全图 e2e 首证回填——总账 M2 + saa 技能(成功率 60%/U7 cutover 未切) 
- 总账 M2 行:SAA 真全图 e2e 首证(SaaFullGraphE2eTest bf99662c)零 prod bug,
  成功率 3/5=60%<80% → U7 worker 转 SAA 默认产线按门未切,现 worker 主链零回归
- saa-graph-orchestration 技能新增「真全图 e2e 测成功率」节:零 DB 测法(stub callback+
  内存 checkpoint)/异步派发测试坑(共享 latch+traceId 归位,单款 3.5-16min)/首证 60% 基线
  (难门 I_control/F_wiring/H_progress=生成质量天花板,SAA 机制≠生成质量)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 00:42:33 +00:00
zizi
e7243ef855 docs(plan): 6c6g 后端线 P1 Tier-0 生成主线收尾实现计划(ce-plan) 
ce-plan「6c6g work list」产出(origin=6c6g 后端 P1 工作清单 requirements)。Deep 计划,7 单元:
U1 studio 编排 create/modify/extend · U2 源项目落库事务(status 机器态/孤儿) · U3 trace+cost 落值 ·
U4 缓存命中落账 · U5 giveup 完整 dump · U6 modify 不被卡部分(确定性 build-from-source guard-pending-E2) ·
U7 worker 转默认产线(feature-flag+隔离实例真验)。
范围=Tier 0 关键路径;Tier 1+ 广度 + 确定性 build-from-source(依赖引擎 E2)显式 deferred。
grounding:StudioServiceImpl / 回调内外层事务 / B2 节点实证 + execution §5/§6/§7.1。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 19:26:56 +00:00
zizi
6d21f3e434 docs(coord): 6c6g 后端线 P1 工作清单 requirements 档 + 总账 §7.1 指针 
ce-brainstorm「6c6g work list」产出(创始人选 1+2):
- 新增 docs/brainstorms/2026-06-17-6c6g-后端-P1-工作清单-requirements.md:后端线 P1 完整范围
  (全 13 模块;Tier0 生成可靠=SAA 收尾 B4-B9+worker 转产线 / Tier1+ 广度后端经济/feed/社区/账号/素材/玩法模板/admin;
  边界:compliance硬化→P2、runtime真编译=架构已解(build 在 worker)、渠道/pay→P3、护城河→P2/P3;依赖/成功标准/3 待确认)
  —— 作 ce-plan 的 origin。
- 总账 §7.1 加指针指向该权威详档(协调摘要 + 详档分层,避免重复漂移,一题一活档)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 19:16:55 +00:00
zizi
e70652c57a docs(coord): 多session总账 §6/§7 刷新为契约冻结后各线当前工作清单 
§7「即起 M0 contract-first」(已执行过半 stale)→「各线当前工作清单」:
- 顶部加当前进度横幅(契约冻结 8/8✅ + B2 16 节点合入 04f3bfee → 两线可开工)
- §7.1 后端线:B1-B3✅+trace/studio.yaml✅;Tier0 紧接 B6 studio 编排=下一件大头,B5/B8/B9/B4余/B7;广度 Tier1+;验证债 V18 Flyway/SAA e2e
- §7.2 前端+引擎线(Mac)全可开工:E1 2D适配器=最高价值首件 + E3/E4/E2/E5/E6;广度 8 页 Tier1+
- §7.3 支撑/集成/founder;关键路径=B6+E1/E3/E4 合流 M0
- §6 优先级对齐创始人重排序:玩法模板#3/素材中心#7=非最高优先级,旧「核心1-6先行」flat 口径作废

一题一活档:就地刷新协调活档,不另起新档。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 18:43:18 +00:00
zizi
15efff4dee docs(harness): 文档体系重构(止血最小集)——两层模型+机器可检蒸馏门 
全局 ~/.claude/CLAUDE.md(仓外)退役「每任务 dated review+execution 双档」→两层喂料(WHAT/HOW)+收口蒸馏,增量 deprecate(旧档兼容)。本仓:engineering-conventions §10.6(两层心法/判层/蒸馏门/留痕 frontmatter);wave-close 第5/8步机器可检蒸馏门;AGENTS §2 目标锚去双 roadmap 二义 + §3.3 两层前门索引(模块进度 SoT=总账§2 / 自动记忆界外 / memorys 判死)。

评审 CE 5 人格(coherence/feasibility/scope/product/design)压缩至止血最小集,砍两层新目录/新收口门/评审舰队正式替换。WHAT=docs/brainstorms/2026-06-17-文档体系重构-requirements.md;决策记忆 docs-system-hybrid-two-layer(仓外)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 16:33:21 +00:00
zizi
38729ffdaa fix(contracts): studio.yaml 契约评审跟进——收紧 modifyPatch + idempotency 语义(单轮 codex 评审) 
codex xhigh 契约评审 FREEZE-WITH-FIXES(零 P0 破坏)。逐条收口:
- P1 payload 必填 + mode×target.kind 锁定映射(后端可信边界校验,不用 oneOf 保 mock/codegen 简单)
- P1 target path/id anyOf 强制至少其一
- P1 payload value/intent 按 mode 必填(后端校验)
- P2 AssetContextItem 补 provider + 后端派生 assets[].id 说明
- P2 idempotency 语义(同 userId+op+key 命中返既有 taskChain/缺省不去重/TTL 24h)
- P2 execution §5.6 JSON 指针示例纠错 /gameDefinition/config/speed→/config/speed(config 顶层,对齐 keystone)

复验:YAML 绿、14 $ref 零悬空、六类对齐 keystone、现有端点/VO 零破坏。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 16:00:52 +00:00
zizi
be468b6b2c docs: 玩法模板优先级全局纠偏——非最高优先级(最高=Tier0生成可靠) 
创始人裁定:玩法模板(品类引导框架)非最高优先级待建。普查总账(bd93c35c)
已写对(高价值但非#1,排在Tier0生成可靠之后),但 HJ-DEMO-AUDIT-001 的
propagation 在 7 个 LIVE 档/工具里仍写"当前最高优先级待建",产生漂移。
本次全局对齐到总账已批口径。

改(LIVE,~11处/7文件):
- docs/architecture/系统概要设计-技术决策版(3处)
- docs/agent-specs/{引擎与运行时,战略与合规,文档整理-plan(3处)}
- .agents/knowledge/{tech-decisions,product-and-architecture}
- .agents/tools/doc-organizer-analyze.mjs(真相基线串,防再传播)
留:_archive 3 档历史记录不改正文(现行 canonical 纠正后即权威)。
memory 另在 ~/.claude 改(不入仓)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 14:51:40 +00:00
zizi
ee55a2db6a docs(merge): _index 合并——settled canonical(本session Phase A) + 生成域设计链(他session 固定架构) 
cherry-pick 本 session 4 提交(深度重构 Phase A + 增量整理)到 origin(他 session 生成域设计链已先落);
_index 合并双线:settled 7 域=canonical 活档 / 生成域=固定架构设计链;两线文件零冲突共存。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 14:06:22 +00:00
zizi
023a2630c3 docs(restructure): agent-specs 深度重构 Phase A——42流水档→7子系统canonical+总账瘦身 
深度重构(创始人批:settled 7域现在做/生成域待协调/FOLD源git rm/_archive只增/无日期主题名/canonical=子系统SoT)。
分析=10主题簇 opus fan-out(1.1M tok);计划经 opus 对抗评审 GO-带必修(prompt活档补回/总账§6取证搬归档不压删/git-status划波)。

7 子系统 canonical(子系统SoT·一域一档·≤150行·砍历史过程·留现行架构+目标+现状+指针):
- agentic编排-SAA / 引擎与运行时 / 开闸验收门-W-G1 / 渠道发行 / studio前端设计体系 / 变现与单位经济 / 战略与合规
- prompt治理体系-execution = KEEP(Prompt第8契约,已是canonical形态)

源档处置(Phase A settled,全committed):
- FOLD 15 + DELETE 1 → git rm(活内容已蒸进canonical,git历史留存)
- ARCHIVE 10 → _archive/(收口报告/取证账本)
- 顶层 dated 档 42→17(剩生成域Phase-B + 治理 + KEEP dossier)

总账(评审M2:不压删):§6波次史42行整段搬 _archive/总账-波次史归档.md(一字不丢)+正文留里程碑摘要+指针。
_index 重构为 canonical 导航;skills+mvp 6档断链→canonical;活档归档引用→_archive。

Phase B(待协调,本次不动):生成主线/固定架构/产品路线图——含他session 06-17在飞WIP,红线不擅动。
留痕:docs/agent-specs/2026-06-17-agent-specs深度重构-plan.md(计划+opus评审)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 14:03:27 +00:00
zizi
ebd615c93e docs(organizer): 06-16增量文档整理——压2归2+玩法模板术语17处对齐+总账除漂移 
doc-organizer 两阶段审批门·阶段二(创始人批:执行/全改17处/清PNG/动态日期)。
分析相=25 opus agent 三轴只读 fan-out;计划经 opus 对抗评审 GO-带必修。

轴①过期分类(20档):
- COMPRESS 2桩: round2-staging-e2e-verdict→round3(703e462c)、生成引擎-并行编排→多session总账
- ARCHIVE 2: 技术决策版重写-review(对齐已落)/视觉增强repair-review(NO-GO) 入 _archive/
- KEEP 16: W-G1开闸验收门/studio设计体系HJ-FE-DS-001/生成线 在飞 SoT 不动

轴②核心档措辞:
- 玩法模板术语17处跨4核心档+工具analyze.mjs TRUTH 对齐 HJ-DEMO-AUDIT-001
  (废=游戏模板/填参线;玩法模板=品类框架·引导生成·未废=最高优先级待建)
- Dify/OpenGame家族0真改(已标作废/future-state/决策史,证实06-16对齐可信)
- W-T1b-Runner历史档顶部加术语指针(正文不改)

轴③总账: M2现在时漂移修(四模板→W-CLEAN清+generic桥接接棒,demo审计C6)
  + 06-17工作回填(SAA trace真库收口/generic开闸首件/crypto.subtle整款加载修/census)

工具: doc-organizer.sh 硬编码06-16→动态 latest_date(免一天即过期)
清: 7证据PNG(留report.md) | _index 活地图维护(supersede链/补漏登/修断链)
留痕: docs/agent-specs/2026-06-17-文档整理-plan.md(计划+评审)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 14:03:27 +00:00
zizi
2751d98724 feat(contracts): 冻结 keystone 契约 source-project.schema.json + 收口 execution 待解 
- 新增 contracts/agent-loop/source-project.schema.json:游戏源项目工件 schema(两开发线交汇 keystone)——轻量声明式领域模型(entity/component/behavior/scene/rule)+ profile 三维(tick/input/progress)+ 六类 assetSpec + config;改源不改打包产物;draft-07 valid JSON。后端线产出/落库、引擎线 2D 适配器消费。
- 收口 execution §12 全部待解(创始人 2026-06-17「按推荐」):①源项目表=studio 模块 ②后端 RuntimeBuild 仅落包(构建留 worker/SAA build.mjs) ③缓存/classify spike 已绿 ④classify→archetype 映射表=引导非校验 ⑤narrative needsRepair=true 等价一次九门失败计入 failCount ⑥studio create=draft+generate 一步式封装。
- 校正:V18 SQL 入 game-cloud 模块迁移(后端线实现),非 stale 的 contracts/db-schemas(契约副本约定已停于 V9)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 12:37:45 +00:00
zizi
133182d803 docs(governance): 立「一题一活档」规则 + 收敛生成主线设计档(删 v1/归档 v2) 
起因:本会话同一设计(生成主线)随 4 次 reframe 产 4 份 review/execution、过期 v1 被连推上 origin = 文档 sprawl + 过期档误导(反模式)。

预防(规则,根治):
- engineering-conventions §10.4「一题一活档」:同一设计主题就地修订一份活档、禁「一 pivot 一文件」;review/execution 拆分仅当两者同时为活;终稿自洽;supersede 同提交删/归档(强化 §10.2);commit 设计档前自检。
- wave-close 第8步补:同一任务设计档收敛成最小自洽集(典型 1 review+1 execution)、被取代者同提交删/归档。
- (doc-organizer 轴①已检测 SUPERSEDED/DUP = 事后兜底;§10.4 = 事前根治)

收敛(应用):
- 删 v1(对话生成修改素材-review,D5「改打包产物」前提已被评审证伪=纯误导)。
- v2(生命周期项目管理-review)生命周期原则折入固定架构 review §1 使其自洽 → 归档 _archive/ + SUPERSEDED 墓碑。
- 固定架构 review §4 从 §10.1 收敛(消 opus 点的两份 agent 表分叉)。
- _index 活地图登记(固定架构 review+execution=ACTIVE、supersede 链记 v1/v2 收敛)。
留最小自洽集 = 固定架构 review(自洽)+ execution。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 12:16:57 +00:00
zizi
c98ec11d6f docs(spec): 生成主线设计链——固定游戏架构+SAA agentic studio(review+execution) 
本会话生成主线架构设计全链(4 spec):
- v1 对话生成/修改+素材 → v2 游戏生命周期项目管理(游戏=长生命周期源项目、改源不改打包产物)
- 固定游戏架构+SAA agentic studio review:Opus 设计固定架构、cheap 填槽、轻量声明式领域模型+tick/input/progress profile、2D 适配器(3D 后)、救场阶梯、缓存三段式、agent 列表深析并入、架构玩法解耦、narrative 子系统
- execution 版:锁 8 契约(源项目 schema/V18 DB/产物源分离/SAA state 全表/asset 产消/modifyPatch/唯一构建 API/trace+cost)+ 拓扑表(无孤儿)+ 两线切分
- 两 spike 全绿并入:new-api 网关前缀缓存透传(76-93%)、classify 准确率(tickModel 100%/archetype 93%)
- 经 codex+opus 双评审 + Opus 独立验证(impl 单轮)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 11:54:31 +00:00
zizi
723c2f7697 docs(coord): 协调总账重构——三阶段/两开发线/增量集成(创始人拍板) 
MVP 重定义=Phase 1(8页全运转+简单游戏生成/修改/玩+admin经济,非终点);
Phase2=Cocos复杂游戏+云内测+ops;Phase3=外部全集成+全维优化+agentic运维。
两开发线按浏览器轴切:后端线(6c6g编辑/mini-desktop构建)+前端引擎线(Mac本地+浏览器),
交汇只在三契约(API/dispatcher/manifest)。集成=风险驱动增量(M0核心纵切最先拉通→M1/M2/M3),
非大爆炸。去闸门(只卡集成不卡开发)+交叉评审保独立性。Phase1=11工作流映射两线。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 07:15:31 +00:00
zizi
2f1a797237 docs(audit): demo↔三文档套件缺口冲突审计 review + 创始人术语纠正 
HJ-DEMO-AUDIT-001。30 子代理 workflow 盘点 demo 9 视图实然功能、对照 Doc A/B/C
覆盖、检冲突(13 核实/3 伪冲突剔除)+主 agent 回源复核。创始人纠正中心论点:
W-CLEAN 废的是「游戏模板」(pre-built 整游戏代码/填参)，「玩法模板」(品类框架·
引导生成)未废、为当前最高优先级待建功能 → C1 作废、C2/C7 重定性。入 _index 活地图。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 06:14:24 +00:00
zizi
bd93c35c2d docs(census): 产品功能×技术模块完成度与优先级总账(2026-06-17)——155功能/13模块逐条读码实证+两套优先级 
两路 Opus forensic 逐条核实:产品 155 功能(P0 18✅/18🟡/19🔴,全155真端到端✅仅18且全属P0)、
技术 13 模块(✅5/🟡6/◻2/🔴0,地基稳无 split-brain)。功能优先级按产品目标四档
(Tier0 生成可靠→Tier1 闭环补洞含玩法模板非#1→Tier2 变现受日历闸门→Tier3 护城河),
模块优先级按整体架构(aigc 关键路径/compliance 地基门/runtime/feed/受闸门变现/后置)。
术语纠正贯穿:W-CLEAN 废的是游戏模板(整局填参),玩法模板为有效 P0 待建。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 06:01:43 +00:00
zizi
6f537ef67f docs(audit): demo审计 review 创始人纠正——玩法模板未废(游戏模板才废),中心论点重判 
- 术语错位纠正:W-CLEAN 废的是「游戏模板」(pre-built整游戏代码/旧4模板填参),非「玩法模板」
- 玩法模板(品类/玩法框架·引导AI生成)=有效产品功能·最高开发优先级·待建,非已废范式
- C1作废/C2·C7重定性(P-TPL是有效P0未建,limbo已由generic桥接7534bdf9解)
- 顶部⚠️纠正横幅+L29头结论+L199状态表行就地改;其余轴不受影响仍成立

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 05:04:37 +00:00
zizi
870bf56bfb docs(review): 开闸·一句话入口接线 review版——拆模板门走generic生成路(开闸首件) 
- 结论:后端生成引擎+feed已就绪真验,唯一工程堵点=创作页"迁移空窗"(Create.vue硬门控选模板,W-CLEAN废模板→template/list空→开始生成永禁用→一句话主链结构性断)
- 接线=模板驱动→一句话驱动(generic路):契约templateId可选默认generic+Create.vue去模板门+后端接无模板,改动小/向后兼容/风险低(generic路R3已真验)
- 现状已接地file:line;Mermaid全链;C1-C4待创始人拍(发布门admin-gated/templateId可选/可选品类提示/创作者白名单)
- 验收=种子一句话→真生成→入feed→真人试玩(6c6g mini-desktop真机验)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 03:27:08 +00:00
zizi
e0fba66b06 docs(coord): 多session分工与任务总账(角色分权版)——Mac实现/6c6g独立评审+真机验/studio前端 
- 分权模型:Mac主力重实现(本地浏览器迭代)/6c6g架构+独立质量门(研究·spec·独立review·mini-desktop真机验·UI走查·DB异常分析·轻dev)/studio前端;实现方≠评审验证方逮作者盲点
- 每功能环线:6c6g写spec(2轮评审)→Mac实现→6c6g独立review diff→6c6g mini-desktop真机验→收口蒸馏
- game-runtime放Mac:代码轻但验证需浏览器(6c6g禁chrome);6c6g轻dev=契约/schema/SQL/prompt文本/纯逻辑
- dev先行集成测后置:外部key(SMS/微信/抖音/支付/广告)只阻塞集成测+真实API,不阻塞开发→E lane降级dev-now/integ-test-later
- 任务总账角色版(Lane A后端/B引擎/P产品主线对话修改+素材/C studio/D founder/E外部对接)+权重+关键路径
- _index注册置顶,取代旧2026-06-16-生成引擎-并行编排.md

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 03:18:32 +00:00
zizi
a09a03e91e docs(round3): SAA路trace接线split-brain真库收口——verdict落档+saa-graph§6蒸馏+_index注册 
- verdict: dispatcher=saa+trace.enabled=true真库验trace_json非空/readiness=74,开关关NULL(additive字节零变),进程内非HTTP非HMAC,live未动
- saa-graph§6: 新增「多派发路·回调可观测字段必须每路都set」铁律(回调trace split-brain,与发布裁决split-brain区分)+字节兼容红线+readiness浮动/firstPlay quirk坑
- _index: SAA段注册execution+verdict为已收口,登记F5/F3/早期boot预热follow-up

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 02:06:34 +00:00
zizi
703e462c96 fix(aigc): 闭合 SAA 进程内派发路 trace 接线 split-brain——dispatcher=saa 时落 trace_json/readiness_score 
组B(96081a57)给 game_aigc_task 加了 trace_json/readiness_score 可观测列,HTTP worker 路经
service.py:_extract_trace 抽 trace 落库;但 SAA 进程内路(SaaGraphDispatcher.buildCallbackReqVO)
构造回调 reqVO 时从不 setTrace,故 dispatcher=saa(未来主力)时 trace_json 恒 NULL、组B 的
9d/D11/D9 静默失效。本提交在 buildCallbackReqVO 末尾(return 前)新增 extractTraceQuietly,
从图终态 OverAllState 抽一个与 HTTP 路 _extract_trace 字节兼容的 camelCase trace map 并 setTrace。

实现要点:
- 严格 additive(独立成段紧贴 return,删两行即回到修前;null 不 set 走存量旁路)+ best-effort
  (整段 try-catch,抽不到/解析失败返 null,绝不打断 SAA 生成)+ 复用组B 同一 feature flag
  aigc.trace.enabled,落库由现成 persistTraceQuietly 兜底,零改契约/零改消费侧/零改 HTTP 路。
- 键集严格对齐 HTTP 子集:必填 pass/repairs/wallS/models/attempts/gameId/stage + 可选
  gatespec/sevenGateVerdict{pass,guards}/tokens/player;cost 键 v0 整段省略(SAA 只有 token,
  token≠¥,挂 cost 语义错→efficiency 中性 0.5 非阻断);similarity 永远省略(D9 未接 SAA)。
- attempts snake→camel(stage_fail→stageFail、usage 仅 {in,out}),不含 per-attempt guards/
  sevenGatePass(已核 appendAttempt 三调用点 SAA attempt 从不写,不伪造)。
- models 取 K_TOKENS_BY_MODEL 名键 ∪ attempts[].{role:model} 并集(纯 attempts 缺 player 模型)。
- wallS 唯一来源是 runGraphAndCallback 计时变量 wallMs,透传进 buildCallbackReqVO(签名加参,
  唯一调用点同步加参)。safeFailedCallback(图崩溃兜底路)默认不补 setTrace(state 不可达,F4)。

测试(mini-desktop x86 权威构建机,clean test):
- 新增 SaaGraphDispatcherTraceTest 7 用例全绿(纯单元,桩 OverAllState,不起图/不起DB):
  键集对齐 HTTP 子集、attempts camelCase 无 guards、抽出 map 喂真实 ReadinessScorer.score
  得真值(firstPlay=0.5 评分器既存 quirk + efficiency 中性 0.5 → 总分 83,非过度承诺满分)、
  parse-fail/null-state 返 null 不抛、snake→camel red-line、cost 省略 efficiency 中性不报错。
- aigc-server 模块全量 119 测全绿(Failures:0 Errors:0 Skipped:4),零回归,
  尤其 DifyCallbackTxTraceTest 6/0/0、DifyCallbackServiceImplTest 13/0/0。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 01:16:07 +00:00
zizi
7de582e4c7 docs(distill): Lane D2 Round1 学习蒸馏回填——4 处就近落档(split-brain铁律/隔离-D真验/localStorage走查/防悬空提交) 
把 Round1 四条已验证学习整合进既有文件(就近插入·保持风格·零孤儿新文件):
- saa-graph-orchestration §6:铁律「worker succeeded ≠ 准予发布」(split-brain 防线)——九门 runnableOk=机制可玩 ≠ 准予发布,发布裁决归治理层,生产化前安全门由 W-G1 GP9 接管(来源 Lane B agent-loop-v1 退役登记)
- staging-ops §3:配方「隔离实例 + -D 注入真验 feature-flagged 后端改动」——起 :48090 隔离实例、JVM -D 注开关+safety baseUrl/key/model,零改 repo/yaml、live 不动(来源 Lane E G1 GP9 10/10 真验)
- ui-walkthrough-cdp §3:小配方「localStorage 注入 token 过 requiresAuth 走查」——免登录直达受保护页只读走查(来源 Lane E G0)
- 2026-06-16-生成引擎-并行编排 §3:硬规则#7「ultracode 并行 worktree 防悬空提交」——git ops 必须 git -C <worktree>、禁 commit 主 checkout、主 agent 推送前核验 commit 真在其分支(来源 Lane E 错落成悬空 commit 已 cherry-pick 救回)

README 索引无需动(4 处均为既有文件内容补充,非结构性增删改名)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 19:10:05 +00:00
zizi
0138bec3dc docs(lane-s): round-2 staging e2e 双验证 verdict——V16真库+form① SAA(V1-V4)+组B落库 全PASS 
隔离实例 :48090(dispatcher=saa,连 staging V15 真库),live :48080 全程未动(pid479414不变,每步HTTP200)。
- V16 真库验(最低交付)PASS:game_aigc_task 真建 trace_json(json,序13)+readiness_score(smallint,序14)
  紧贴 failure_reason 后,flyway 16.0.0 success=1 exec32ms,boot 前基线无两列(实证本次真建)。
- form① SAA(task140) V1-V4 全PASS:图真跑 design→generate(M2.7真产engineBundle212901含__GameBundle)
  →scaffold→esbuild→九门真玩;首次8/9门(挡板I_control真可玩,H_progress=false)→SAA图repair环重生
  →最终九门全过→status=succeeded(wall479s);进程内回调(saa-graph-dispatcher-1线程,无HTTP/dify
  /callback-internal无HMAC)→versionId93113落包checksum c07ece…→回写currentVersionId。
  V4落「version就绪+待发布」正确档:包scene=preview可取/scene=play未发布门控/project9318留DRAFT
  →feed过滤未发布(worker succeeded≠发布,退役登记§5,链路无缺口缺的只是过发布门)。
- 组B落库(经HTTP回调路=组B实际接线路,task139)PASS:trace_json 12键/必填子集7项全非空/
  D9 similarity{dupHit,titleNorm,sig,dupWith}内嵌/readiness_score=96∈[0,100]/RespVO透出96。
- checkpoint step5顺带PASS:GRAPH_CHECKPOINT+GRAPH_THREAD真建;SaaNewApiGenerateSmokeTest真调new-api PASS。

揪出2真问题+1取证坑:
①[设计边界·split-brain双向实证]SaaGraphDispatcher.buildCallbackReqVO不setTrace→task140 SAA路
  成功但trace_json恒NULL/readiness NULL(对比task139 HTTP路trace非空readiness96);组B 9d/D11/D9
  三件在SAA生产路全失效(组B只接HTTP worker路,git实证未触Saa*),需补SAA路_extract_trace等价物;
②[可靠性·待复现]早期boot的task137/138 fast-fail llm_error(取证受阻于append:吞日志,改shell
  重定向后task140恰成功未在同一次取到根因,标待复现不夸大);
③[取证坑·已绕过]systemd append:吞后台线程stdout日志,改shell > file重定向解。

证据:/root/lane-s-48090.log + verdict.json + DB实查 + 截图;harness=/root/{saa_form1_e2e,groupb_landing}.py。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 19:06:16 +00:00
zizi
6412bf30e4 docs(open-gate): 开闸前置两道验证 G0/G1 verdict——G0创作页W-CLEAN过渡态非缺陷·G1 GP9十负例staging真验10/10阻断 
Lane E 在 mini-desktop staging 做（live :48080 全程不动）：
- G0：CDP 只读走查 studio :4173 创作页——template/list HTTP 200 非故障返空→诚实空态「升级中」+「开始生成」disabled+「去游戏流」出口；零console错；按设计W-CLEAN过渡态，非断点缺陷，无需交studio session修。
- G1：隔离实例 :48090（-D 注入 aigc.control-plane.enabled=true + safety baseUrl http://100.64.0.8:3000 + NEWAPI_KEY），10条违规负例经 submitGenerate 提交侧门④真 new-api(MiniMax-M2.7) 判定 100% safe=false→100% 抛 AIGC_UNSAFE_PROMPT(1101001004)、0条落库（日志栈帧+game_aigc_task双实证）。
两道开闸硬前提均通过，无blocker。临时验证态(48090/9222)测后已停。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 18:00:31 +00:00
zizi
1d5ee31723 docs(saa): Lane B 收尾两件——agent-loop-v1 退役登记 + form① e2e 跑测方案(ready-to-run) 
普查 §3「P1·SAA 框架收尾」两 row 交付:
- 退役登记: 厘清 SAA 只继任 per-job worker 躯体(非 batch 治理外壳);
  judge D1-D10/ledger 幂等/预算闸八项/查重 四块逻辑归宿三分(已迁worker
  /直接退役/留治理层);给 A段(worker冻结)+B段(治理层退役)两段触发条件;
  挖出最高优先级硬前置=saa 路当前无对抗 P0 安全门(须 W-G1 GP9 接管)
  + 判据 split-brain 风险(worker succeeded≠准予发布)。
- form① e2e 跑测方案: 真job走 studio→tick→dispatcher=saa→SAA图九门
  →进程内 handleCallback→feed 全链;harness 复用 backend_gw.py 黑盒观察
  (V1九门/V2真生成/V3进程内回调无HTTP/V4入feed);前置/验收/失败旁路齐全;
  本轮仅 prep 标 ready-to-run(staging 归 Lane E,不抢)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 17:58:09 +00:00
zizi
2c74069144 docs(gen): 生成引擎并行开发编排——依赖图 + 5 车道(worktree隔离) + studio session 边界 
把普查清单 open 任务切成可并行车道:A(aigc后端/DB·组B→source列→R6 车道内串行)/B(SAA worker)/
C(质量harness成本)/D(prompt-gatespec 双侧同步)/E(开闸前置 G0创作页核实 + G1 GP9 staging验);
game-studio/ 全域划归另一 session,接缝(FeedCard templateName / sort_score / SSE)走契约先行 + 通知。
Flyway 版本预分配 V16/V17 防抢号;跨车道依赖 + 创始人卡点(labels.json/2安全洞/日历闸门)标清。供多 session 共用。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 16:41:13 +00:00
zizi
911fdc8ded docs(gen): W-G1 开闸验收门·组B execution——落库组(9d trace+D11就绪分+D9反同质化)v0 spec 
7 锚点亲核到真 file:line + 断链洞见证实(worker 产全数据·build_callback_payload 只塞 5+2 字段丢富 result);
三件 additive 可空 + 全程非阻断 best-effort + feature-flag(全关=字节不变);契约先行(aigc.yaml 加 trace + 补 engineBundle 漂移);
D11 审核台 /task/page 后端透出防孤儿 + 前端展示坐实为产品轨 follow-up(game-admin 确无 aigc 任务页·review 页消费 ProjectApi);
V16 合一迁移(trace_json JSON + readiness_score SMALLINT);D9 移植 _norm_text/重接 _dedup_gate 诚实标重接成本。
4 待确认留 v0 占位待校准(必填子集7项/D11占位权重display-only/D9精确撞重only/事务内best-effort)。未评审未实现,仅 spec。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 16:41:13 +00:00
zizi
2cd9bff52c docs(architecture): 技术决策版补 2 处远期标记(L227/L119) + 修 doc-organizer args 兜底 
doc-organizer skill 首次 dry-run 产出:分析(5 agent workflow)+对抗评审逮出上轮人工重写漏的 2 处真漂移——§2.3 三模式表「全自定义编排」行(L227) + 角色权限表「专业创作者」行(L119):把未建的「可视化/工作流编排」当现行、无 future-state 标记,与 L180/L815/L122(P1)自相矛盾 → 补「(远期)」对齐,不删 Dify(其余处系有意决策史)。

doc-organizer-analyze.mjs:修 Workflow 透传 args 为 JSON 字符串时不解析的坑(加 typeof string→JSON.parse 兜底),dry-run 实证(首跑 0 agent 空转→修后 5 agent 真跑 340K tok)。证据目录归档(低优先)按创始人决定延后。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 15:47:59 +00:00
zizi
f98ad0f801 docs(fe-ds): studio视觉体系/i18n/通用组件库 双spec+mockup+P1token层(HJ-FE-DS-001) 
评审版+执行版双spec、真chrome验证mockup(zh/en+暗/浅/柔三主题实时切换)、P1 tokens.css体系化补全(全additive·旧令牌保留→暗色零回归)。
创始人5决议:响应式消费Web否决demo桌面侧栏/暗色先行+设置内多档主题/SVG图标替emoji/金样板先行/统一圆角矩形(禁药丸椭圆)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 14:55:47 +00:00
zizi
d4f16aabff feat(wg1-groupc): 九门 harness 加首局体验门(品类化·additive 派生超集)——3 断言三款真玩全绿+skill 类首反馈 A/B 真判 
组C 严谨首反馈:A/B 无输入对照,skill 类升级真判(超上一档诚实化 SKIP):
- 上一档(P1-1)把动画自走类(skill/action,如 breakout)首反馈标 SKIP,因「帧哈希 changed」对动球
  是重言式(球每帧本就在动)非输入因果。本档落地 A/B 无输入对照,把 SKIP 升级为真判——
  动画自走类的输入因果靠「有输入 vs 无输入的差异」鉴别,而非裸帧变。
- 复用 G 门 A/B 范式:三趟 fresh 实例同 seed(缺省 0x1234abcd)+LittleJS 固定步推进到【同一绝对帧】比对:
  A=无输入自走基线 / Ap=无输入纯净探针 / B=派一招首招。real 引擎自由运行(host 不掌 RAF/无法暂停回退),
  三趟落帧有 ≤数帧抖动→动球自走位置略差,故【不】用裸帧哈希等值(过严必假 SKIP),分阶梯判:
    [0] 控制体维度(input-controllable,最干净免动球抖动):spec.controlCheck.paddlePath(如 breakout
        paddle.x)——A 趟控制体停默认位、B 趟点远端边连派 tapsPerTarget 拍被移开;|ctrlB-ctrlA|>moveMin
        =真输入因果 true。这是 prompt「只比 input-controllable 维度」之意。
    [1] 否则 state 级因果(remaining/score/moves/phase A vs B 变)=次强信号,直接 true;
    [2] 否则像素信号/噪声(noise=diff(A,Ap)基线抖动地板,signal=diff(A,B));signal 显著超 noise→true(兜底);
    [3] noise 超顶=非确定性(unseeded random/wall-clock)→不可净判 SKIP(血统债,不假判);
    [4] signal≈noise 且无控制体维度→SKIP(动球抖动可能盖过信号,不假 FAIL)。
- 必须串行跑三趟:headless Chrome 对后台 target rAF 节流/冻结,并发开三个只前台跑(实测 A/Ap frame=-1、
  B=2484 全程跑完=对照失效);串行下每趟=当前唯一活动 target 满速,确定性保同绝对帧自走态可比。
- 纪律:路A 零改契约/prompt/play-spec,只动 play.cdp.cjs(additive,advanceToFrame 加 pollMs 缺省 100 向后兼容,
  G 门逐字不变);静态盘类(placement/avoidance)走原单趟口径不动;首局门 FAIL 不阻断九门;warm-only 标注保留。
- 重验(mini-desktop Chrome/CDP):breakout 首反馈 假 SKIP→真判 (控制体 paddle.x delta=145,A=195/B=50,
  control-body-moved,净判=true);tictactoe/saolei 首反馈仍真(单趟 state变=true);三款九门零回归
  (逐门 base==verify,均 A-I 全 true,base 跑于 pristine ee1b697e);firstPlay.pass 全 true。
- 诚实:breakout A/B 净判靠控制体维度(paddle.x),非裸全帧像素——实测裸全帧 noise≈signal(球每帧动+两趟落帧
  抖动污染),故有控制体路径优先取该维度免污染;无控制体路径的 skill 类退信号/噪声兜底,signal≈noise 即诚实 SKIP。

P2-1 warm-only 局限标注保留:playableMs=预热后 warm 稳态,不覆盖 bundle 首加载退化;warmupMs 记冷启;
真机 first-load 阈值校准留 staging。本门 v0 守得住卡死/装载失败退化,守不住大 bundle/慢首加载退化。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 22:38:33 +08:00
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
zizi
8e7ace3ec3 docs(architecture): 核心设计档全线对齐现行真相（技术决策版/开发团队版/投资人版/护城河） 
承接核心设计文档真相对齐，创始人批『全部核心档一起对齐』。废弃选型(Dify/OpenGame/自研Canvas/ComfyUI/AgentScope)曾被当现行架构详述，新接手照信即落废栈。

技术决策版(架构基线 1528→1562)：4 张 Mermaid 重画(DIFY/OG/COMFY/CANVAS_RT→new-api/SAA/mmx/LittleJS)+3 选型表翻面+删虚构字段 dify_workflow_id+MQ/Nacos 标 future-state(框架自带·MVP未部署)+顶部横幅升 v2.1+决策索引补 6 行。

开发团队版(13处)/投资人版(8处)/护城河(5处)：事实性技术栈改现行，工程目标态细节+护城河论述/愿景保留；Doc B 那处 AgentScope 已是『作废→SAA』现行标注。事实核查据 contracts/+game-cloud 实测。Mermaid 结构校验通过未真渲染→建议 mini-desktop 终确认。待定夺=成本或高估(¥4,300按纪律未改)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 12:24:46 +00:00
zizi
45ec5cc6c3 docs(review): 消费侧钱包最小闭环评审版(HJ-PAYWALLET-001)——admin手动加余额可行性 + go/no-go 
- 读码实证两套钱包:创作者收益(trade,已建)/消费支付(huijing-module-pay yudao原生,完整但pom注释未接入)
- admin 手动加余额=yudao /pay/wallet/update-balance 现成端点,接入 pay 后近乎免费(M4 已隔离实测接入启动干净零冲突)
- "加余额其余都正常"不成立:消费扣款游戏侧零接线、会员订阅未建(v2.0)
- 最小波次=接入pay+admin加余额+1条内购扣款闭环(会员订阅 out);裁断=新增scope非MVP闭环必需,推荐推迟保MVP聚焦(关键路径仍是日历闸门+IAA),待创始人 go/no-go
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 12:17:16 +00:00
zizi
eb3b3a162d docs(plan): 技术决策版重写计划补事实核查结论(MQ/Nacos=future-state勿删·dify_workflow_id=虚构字段删·new-api/SAA已实测真接入) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 12:17:16 +00:00