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

20 Commits

Author SHA1 Message Date
lili
2b9ebdbda4 docs(svg): plan①顶图纵切redraw+质量SoT quality-01/02门面图+重推演档§0门面图(atlas规范,眼验待主会话) (尾波SVG批) 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-03 20:41:50 -07:00
lili
6ef0b5d75e docs(gen-engine): 运行时图说 doc-sync 回写实现对账 12 项(W-DSGN) 
以 2026-07-03《生成引擎实现与图说一致性对账》§5 八条 + 重推演 Δ6/Δ9① +
预算两段式裁决为据,把掉队约两周的运行时图说追回现实,写前逐条重核工作树代码。

图说本体(主对象):
- 配置口径反转:ADR-4/A13/§5.2/§5.8/对标表/五列/§二补④ 从「Langfuse 式热取 + GitOps
  四闸」改为「yudao 配置中心版本化(MySQL 版本行)⊕ Nacos 下发 ⊕ AgentScope per-POST
  热重载」,阶段〇+一① 已代码落地;Langfuse 式退历史备选、原表保留作决策留痕。
- §4.2 收敛环:前瞻「go(留观微调)」改为真跑 conditional 结论,补 agent 层 win-balance
  瓶颈(约 1-2/5 thrash)、网关无强档记 conditional no-go、F-1 反馈补厚已落。
- §4.1 便宜档:补运行时载体已 Python 化(cheap-worker 双入口 CLI+Service、复用 tier2
  worker 包;Node 拆两半:gen.mjs 退对照、tools.mjs/serve-and-play.sh/play.cdp.cjs
  九门执行层 shell-out 仍活);「十一插件」核正为十二(8 基元+4 编排)。
- §5.3 续修:回同续修原语迁入 on_reasoning 的 RepairMiddleware(单 POST 内 finish 点
  续修=生产主路,外层 resume 为本地 runner 并存 fallback);预算两段式(软停线 ¥10/¥50
  + 硬地板 ×1.5=¥15/¥75、与轮数/墙钟任一先到即停),§5.2/§5.7 同步。
- §5.1 checkpoint 降准(每外层 resume 落本地 JSON;Redis durable 已编码未真跑);服务壳
  已编码真跑未验证、阶段一 Agent Team 已提前落地默认开启。
- §5.4 删 DockerWorkspace 前置阻断句(06-28 已裁 in-process);A2.5 表行改现·部分;
  补引质量 canonical(D11 权重管辖已移交、四层塔与三层校验共用 L1-L3 但异轴防混)。
- §一 Δ6：第一原则改述为「接缝按变更频率设」(模型月换>品类周扩>引擎季增>框架可能永不换;
  协议脊柱与 judge 独立两资产保留;框架适配验证明确为远期非投入项)。
- §三 Δ9①：A8–A13 加「单实现期不冻、第二消费者出现才抬升」注记(不删行);C5/C6 判分
  闭环两契约入表(PlaySpec 考卷/VerdictFeedback 判卷反馈,已立 schema+校验器、生产接线
  在途,指 contracts/play-loop/)。
- A11(工单第 10 条)复核:图说 §六已是完整 A11 章节，无需重复补——系对账/工单误判。

配套一处:contracts/trace/README.md 廉价线口径 SAA→cheap-worker(便宜档已 Python 化复用
tier2 TraceAdapter/schema,saa-trace-event schema 保留作 SAA 远期轨立位)。
代码触点一处:tier2 agent_loop/studio.py 头注释纠正（「不再外层 repair」与同文件外层
resume 相左）。
收尾:两份配置设计档 sot-impact「收口时回写」翻「已回写」；plan① §11 TODO ⑤⑥ 勾状态。

docs-gate 七检全绿；studio.py 语法校验通过。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-03 14:10:56 -07:00
lili
4d220e77da docs(轨2+板): 质量模型与回流环两设计档(双评审已修·决策包⑦已批定稿)+ 工单板对账(阶段一②收口/决策②⑥⑦落账/R6+rubric落库前置工单/在飞板/06-29§7)
Some checks failed
docs-gate / docs-gate (push) Has been cancelled
Details 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-02 19:31:53 -07:00
lili
8e2d5d9e50 docs(governance): 计划谱系单指针 上级: 立约(§10.8)+ docs-gate 七检加 G7 + plan-tree 查询视图 + 存量断链回填 
新建 plan/设计档 frontmatter 必带一行 上级:(仓根相对路径),沿链 6 跳内达 canonical SoT;
全链/树/当前位置都是查询结果(plan-tree.py)而非维护对象,_index 在飞板保持线级、不加逐叶登记。
G7 拦三种腐坏:缺字段 / 上级死链 / 链断(中途档既非 canonical 又无上级),成环与超跳同挡(均已植坏档实测命中)。
存量修复:统一执行计划基建线补认领配置控制面设计(治真断链、含 07-01 SCA 选型反转口径),
配置控制面设计与阶段〇/一① plan 补 上级:;AGENTS.md/.agents README/feature-design-doc 模板同步七检口径。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-02 11:45:32 -07:00
zizi
d97e194383 docs(治理): SoT注册表+docs-gate六检门,清缩历史档126→69 
- 注册表:docs/architecture/README.md §2,37 份 canonical(frontmatter topic+canonical:true)与表双向机器对账
- 门:.agents/tools/docs-gate.py 六检(品牌根/canonical唯一/死链/入口卫生/留痕隔离/设计档申报),挂 .githooks/pre-commit(本仓已激活)+ .gitea/workflows/docs-gate.yml(待runner)+ wave-close 第8步;旧 check-deadlinks.sh 退役并入 G3
- 清缩:删 54 项历史档(plans 16/agent-specs 设计与spike 20/brainstorms 5/memorys 3/goals+作战清单完成史归档/王蓝莓design/SAA现状html/add-game-template);channel-spike 564K 代码资产迁仓级 spikes/;六件删前蒸馏已迁(代码评审16条open项→进度总账§5、prefix-cache字段表→cheap-model skill、意图基线29条→需求清单附录、九门降级rationale→验收门、A11 TODO→tech-decisions、3layer边界→littlejs-game-dev 指针)
- 修口径约90处:六处SAA『现行主线』旧标、Nacos/RocketMQ『未部署』旧述(07-01反转)、gameDefinition残留、全部死链改 git show 定位;AGENTS.md 249→136行(决策史归tech-decisions);_index 改纯在飞板;对外演示版 md→html
- 依据:docs/agent-specs/2026-07-02-文档治理-{全量普查与裁决-report,SoT注册表与治理门-设计}.md(四路普查191份md+Codex/Opus双评审必修项已折入);恢复基线 8ea97234(单档 git checkout 8ea97234 -- <路径>)
 2026-07-02 14:24:12 +08:00
lili
ba69b386ee docs(plans): 便宜档 M3 生产 cutover plan(已批准·选B·§6.8 双评审收口)+ plan① 横切回写 
M3 plan:承接 6-28 已完成的路由 cutover、推进对外开闸放量(S0 核实→S1 worker 更新到 M1 富化→S2 control-plane 重启+验Bean→S3 阈值起步→S4 小流量→S5 生产≥80%复验→S6 6门放行);Codex 有条件放行 + Opus(BLOCKER 经核实=误判)双评审 12 项发现全修;创始人裁定决策点二选 B(直接 live 开 flag+回滚兜、不走 staging 避 split-brain)。plan① 横切回写:状态表/§M3 记路由 cutover 已 6-28 go-live、§104 五款3/5 校正为 M1-rich 达标、§119 灰度→D3 整体翻转校正(横切一致性漂移修齐)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-30 03:37:17 -07:00
lili
ba0197a1a3 docs(cheap-worker): 纠 reskin 错框 + plan 切片完成度回写 
创始人纠正:reskin「锁循环只换皮作成本主线」/「重做丰富脚手架」= 越线,成本数据留痕、
策略框作废。架构红线:项目代码只做机械确定的事;玩法/美术/音乐的「丰富生成」归生成 agent
设计创作(据 sim-business 指导 + 组合插件)、「丰富校验」归纯 LLM 验证 agent(非阻塞)——
代码/九门/脚手架都不碰。便宜=LLM 低参与度≠游戏低质量,底线=2D 丰富游戏。

- tech-decisions §5.1 / 设计文档执行进度 / plan① 切片一里程碑:reskin 错框纠正 + 修正方向
  (接 sim-business 设计指导 + 建 LLM 丰富度验证 agent → 喂 M1「过九门+丰富」)。
- plan① §2 执行现状:加切片完成度快照(切片一地基✅/达标门✗ · 切片二 go-no-go悬 · 切片三~90%
  · 基建线~15%)+ 便宜档待办更新(减摩擦已落 + 丰富度新缺口 + 预算闸已接线)+ A11 现状更新。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-30 01:39:05 -07:00
lili
92f6a84205 docs(cheap-worker): 经营 reskin n=5 收敛环确认——降本杠杆坐实 
5 个不同店主题(奶茶/书店/花店/拉面/冰淇淋)强制换皮跑:
5/5 全过九门 · 成本均 ¥0.252(区间 0.21-0.38,-64% vs 基线 ~¥0.7)·
game-logic.js 全 0-diff(循环锁定证明生效)· 全 1 轮 · 5 店菜单全互异。

连同咖啡馆 = n=6 全过、全腰斩、循环全锁定——reskin 三件(成本腰斩稳 /
过门 100% 可靠 / 多款不雷同)全确认收敛,无失败无需追加。扩模板降本杠杆
= 脚手架 + 写边界强制锁循环,经营档坐实;阶段二以 reskin 为成本主线、
剩四品类各建骨架 + n=5 确认。蒸馏入设计/tech-decisions §5.1/plan① 切片一。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-30 01:39:05 -07:00
lili
c17b15cbdf docs(cheap-worker): 扩模板数据点结论蒸馏——降工作面只在强制换皮 reskin 模式 
经营品类三路对照(同咖啡馆 brief,n=1):
- 无脚手架基线(7 局 bake-shop-serve):~890 行 / ¥0.7 / 6·7 过门。
- 软脚手架(骨架 + 软提示):892 行 / ¥0.85 / 过门 / distinct——AI 把省下预算投增富化
  (自加 combo + VIP)、对基线三指标(行数/成本/轮数)全平没降。
- 强制换皮(write_whitelist 锁 game-logic.js、只改 core 主题 + render 观感):
  696 行(-22%)/ ¥0.34(-51%)/ tokens -64% / game-logic 0-diff / 过门 / 仍 distinct。

结论:设计 §1「扩模板缩小 AI 工作面」假设成立、但只在强制换皮 reskin 模式(脚手架 +
写边界强制锁循环);软脚手架买质量/过门鲁棒(增富化)、不买成本。降本杠杆 = 脚手架 + 锁循环、
非脚手架本身。取舍:reskin 省成本但封顶增富化,软脚手架反之。阶段二应以 reskin 为成本主线
(待创始人定范围、n=3-5 每类确认)。蒸馏入设计执行进度 / tech-decisions §5.1 / plan① 切片一。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-30 01:39:05 -07:00
lili
7c9c8a8b47 docs(cheap-gen): 阶段一B 改签名收口 —— plan①里程碑 + 设计执行进度 + 存量重生成复验 
阶段一B(附A 15 处可改签名 #1-#15)全完成收口:
- plan① 切片一「降AI参与」里程碑:执行序列标记阶段一A/B ✅(2a20e5e7→2be7b718 共13提交、前置核查证 L2/tier2 隔离)
- 设计文档执行进度:逐条母语化要点 + 正交泛型门修复 + 存量重生成九门复验结果
- 存量重生成代表性一局 PASS:打地鼠+菜单+高分(drawButton/sessionScore/save.get/ctx.random)
  attempts=1/¥0.64/209s,对比改签名前同款栽在 save.get 泛型门 bug(2attempts/¥6.69/失败)
  —— 现一次过、更便宜更快不 thrash,减摩擦端到端见效。
下一步:难品类数据点(B,前置阶段二)→ 阶段一C 补密度 → 阶段二扩模板。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-30 01:39:05 -07:00
lili
f477666f1d docs(plan①): 切片一认领「降AI参与」里程碑(L2 API 母语化 + per-genre 脚手架) 
把「便宜档降AI参与」探索结论正式认领进 plan① 切片一(canonical · 创始人 2026-06-29 directed):
- 加里程碑「降AI参与·减摩擦+扩模板覆盖」= 把 3/5 推向 ≥80% 的生成质量地基,喂 M1 达标门
  · 减摩擦(小头,26× 含学 API 税):改 L2 签名向母语直觉 + 清脏数据 + 重写形状门判据
  · 扩模板覆盖(大头未验):per-genre 脚手架,缩 AI 自由写面 —— 难品类数据点前不敲定范围
- WU 归属:WU-B 实例达标 / WU-C 5.4 能力面契约变更(改 22 处 L2 API)/ WU-F 达标门
- 跨设计面加 L2 API 母语化契约变更 + 设计指针
红线:九门内核不降 / L2 插件库保留(降参与核心载体非税)/ 不动 tier2。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-30 01:39:05 -07:00
lili
9ac0e860d1 docs(gen-engine): A11 切片三收口蒸馏 —— 回写 plan① + 设计面入运行时 SoT §六 
收口 TODO①②(创始人 2026-06-29):
- 回写 plan① 切片三:确定性覆写定性精化(执行仍零 LLM、但 A11 经判意图两段式到达、
  非直接覆写;落点对齐工程规范性)+ 后续细化标记已执行(M1-M5 代码完成、6 提交)
- A11 设计面蒸馏入运行时 SoT:新增 §六 调整回路(试玩后纠错)——两段式判意图/工程规范性改一处/
  两档执行/三断言,散文设计面(兑现 plan① TODO⑥ "A11 无 §5.x facet 专节");§三 A11 行状态更新为
  便宜档代码完成
- .agents/knowledge/tech-decisions §1.2 A11 调整回路简洁蒸馏(指向 §六 + 细化 plan)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 03:08:06 -07:00
lili
618eca14d4 docs(gen-plan): Codex 四维度专项评审 10 项修复 + 蒸馏两坑 
Codex 末轮重连完整产出,双评审真正凑齐。修复:
- §7 切片三补进 WU-C/WU-F 对账(对账漏面);WU-D 补第二批协议 ADR-1/2/5 接收方
- 切片二 n=5 钉死追加轮数上限(≤3 轮 / 累计 n≤20);切片三 A11 补三条结构断言完成判据(改动生效/非目标模块 diff 稳定/baseVersionId 血缘)
- M2 同等过门率补 delta 阈值口径;基建线三项补最小验收判据
- §5 依赖图排队顺序改虚线、硬前置改实线+图例(防误读成阻塞依赖)
- M3 限定生成线端到端+非生成模块归 16 周主计划;§6 补生成线 P0 承接子集
- skill execution-plan-slicing 补第六/七坑(判据未钉阈值 / 依赖图把排队画成依赖)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 22:27:11 -07:00
lili
d9786950d6 docs(gen-plan): Opus 四维度评审修复 — 达标按品类/§7 八面对账/切片三完成判据 
四维度(任务顺序/目标一致性/任务边界/可验证完成)专项评审,Opus 全过无必修,9 处建议/可选已修;Codex 三次占位+连接中断,按 §8 回落 Opus 单评。

关键修订:① M1 ≥80% 改"按品类判、核心品类全覆盖"防达标假绿(对齐 002);② §7 WU-C 5.5 能力面主体归切片二、注册子项留基建线、补 5.3,八面对账闭合;③ 切片三补显式完成判据(两档落地+过九门+接 A2A/D12 跑通一次受计费调整);④ M3 补后端 studio 移交边界 + 生产分布达标复验;⑤ 切片二结构化门标可并行;⑥ §7 WU-F 下钻补 §5.2/§5.7;⑦ §11 TODO 补 A11 设计面缺口。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 22:02:53 -07:00
lili
f0e5638c9a docs(gen-plan): 补回切片一迁移安全契约 + 立"执行契约必须留"换轴判据 
创始人 catch 换轴丢细节:核出被压缩的 WU 内容分两类——设计 HOW(八面/三档矩阵/A2A·cancel·幂等协议/6 ADR)归位设计 SoT 无碍(§7 对账可下钻),但 WU-A 便宜档灰度迁移契约 11 项(链路/灰度 flag/对照/幂等/在途/切换门槛/回滚)是执行契约、被误当设计细节压掉,补回切片一。

skills/execution-plan-slicing.md 立第五坑 + "设计 HOW 移交设计 SoT / 执行契约必须留切片"的判据;README 同步。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 21:17:31 -07:00
lili
de496321c6 docs(gen-plan): plan① 换轴重构为纵切执行序列 SoT + 蒸馏切分轴 skill 
把生成引擎统一执行计划从关注面横切(WU-A..F)重构为成果纵切三切片(便宜档达标上线 / tier2 go/no-go / A11 调整回路)+ 基建线 + 已冻协议基线,WU-A..F 降为 §7 设计面对账。补上执行序列 SoT 这一缺失的中间层(夹在设计 SoT 与切片细化 plan 之间)。canonical 唯一性门:原地重构、文件名保留、旧主轴降对账。

过 Codex + Opus 双评审,必修项已修:假前置门(A1-A13 定级设计 SoT 已冻、非待拍)/ 散文元叙述 / 切片三对切片一真依赖(A2A·D12)/ §7 对账补全八面 / 插件数 11→12 / base 编号去掉。

蒸馏:新增 skills/execution-plan-slicing.md(横切 vs 纵切判据 + 换轴动作 + canonical 唯一性门 + 四坑),README 索引同步。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 18:13:09 -07:00
lili
f3d4bc1f24 docs(gen+master-plan): ①③ §0 门面图落地 + §6.8 收尾三修(F4/F7/CT1) 
- ① 生成引擎执行计划:补 §0 门面《生成引擎执行总览》SVG(6 工作单元依赖+状态)并 embed;F7 退役映射 06-18-001 行注明两 contract-first 待办随 gameDefinition 声明式路废弃而 moot
- ③ 上线主计划:补 §0 门面《上线主计划 16 周轴》SVG(16 周泳道甘特+日历闸门+55 P0 挂点)并 embed;F4 aigc「GameConfig 生成」加 A-model 写真 src/ 兑现、非声明式 JSON 消歧
- 003 tier2 子计划:CT1 注明子计划有效边界(Phase A U1–U7 有效 runbook / Phase B U8–U10 以 HANDOFF 为准)
- 两图均过 atlas 复验:XML 良构 / 不溢出 viewBox / 脚注全角「：」/ 无裸 &

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 18:01:15 -07:00
lili
0000ade12d docs(svg): 全域 SVG reframe doc-sync — 配图两线→三档 + 脚注死链 repoint 
- 结构重画:03-两条生成轨边界 / 07-全局两线与tier体系(两泳道→三档统一 AgentScope、引擎随复杂度选 LittleJS/Phaser)。
- 文字/framing(全域 SVG):两线→三档、SAA 廉价线→便宜档、AgentScope premium 独立轨→统一框架、超休闲档→轻量、tier2 远期/待 spike→accept(实线)。
- 脚注死链:自治富游戏引擎.md / agentic集成架构.md / tier2实现详设.md / tier2四层工程架构.md(均已并入 SoT)→ agentic运行时架构图说.md;全域 SVG 零死链。
- 07-泳道 tier2 框 紫虚线→实线现行(accept、核心已落)。
- MD doc-sync:删 4 处"待重绘 mini-desktop"注(图已重画)、①③ §0 / README / SoT 注脚去 mini-desktop(全归本机)。
- atlas house-style 复验:良构 / 界内 / 脚注全角「：」/ 无裸& 全绿;t2-E-04「两线分立(06-23)」已加注 06-25 reframe 取代之、作留痕。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 13:07:49 -07:00
lili
4f7eae5d7a fix(reframe收口): F1=(B) 便宜档 Python 重写三档同构 + 创始人 4 决策 + ①③ 转正式 
- F1=(B)(创始人 2026-06-25 拍板):①WU-A 从「JS 留、只换外层」改为「便宜档 Node amodel-gen
  整条用 Python 重写进 AgentScope agent、三档彻底同构」(Summary / Decision1 / WU-A 拓扑+迁移归属
  +迁移契约 / mermaid / R1 / 吸收映射 / 排期 全口径对齐;Node 旧路灰度兜底、≥80%+对照等价才切默认)。
- §8 双轴:生成引擎 README §8 加 L1/L2/L3(产品 / 创作者轴)↔ Tier0/1/2(技术 AI 深度轴)对应关系表
  (两套保留、不合并、非 1:1)。
- ③ 留存口径笔误:次留 ≥35% / 7留 ≥40% → 次留 ≥40% / 7留 ≥35%(符合 D7<D1)。
- ① canonical:true(reframe 后唯一执行 SoT、受 canonical-uniqueness 门保护)。
- ①③ status 草稿 → 正式(§6.8 双评审过 + 必修已修 + F1/§8/留存 等决策已落)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 12:31:32 -07:00
lili
4e801d5e8a docs(reframe收口): 生成引擎 reframe 全层 doc-sync + 统一执行 plan + 上线主计划 SoT + §6.8 双评审 
双查一致性(Codex+Opus)→ 修问题 → 出 plan 全链收口。

修问题(reframe 全活层 doc-sync · 框架统一 AgentScope / 三档按 AI 深度 / 去超休闲 /
A-model 写真 src/ / tier2 spike accept · n=5 收敛环 / 预算闸 <¥10·<¥50):
knowledge 三件套 + 顶层图说 00/01/02/05 + 6 域 README + 5 mvp 账本 + skill·workflow +
agent-specs(_index / 演进路线降留痕);系统性死链 自治富游戏引擎.md → 运行时 SoT repoint(7 档)。

AGENTS.md:§2 收敛上线主计划 SoT、§3.1 入口自审 reframe 对齐。

出 plan:① 生成引擎统一执行计划(新建 · 统一三档 · 吸收退役 06-18-001/06-19-001/003);
② 4 份重复 plan 退役/并入/去两线 banner;③ 可行性方案16周 就地升格为项目上线主计划 SoT(canonical)。

§6.8 双评审(Codex+Opus)6 必修已修:WU-A 真实拓扑+JS留+迁移契约 / A11 孤儿接缝(①WU-B↔③阶段三)
/ 三档拆清 / ③ 过度表述 / 人办清单 n≥30→n=5 / 死链。

tier2/HANDOFF.md:n≥30→n=5 + agentscope-runtime→2.0.2 Workspace doc-sync banner。

①③ status=草稿·双评审已过·待创始人确认 F1(WU-A 迁移归属)后转正式。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 12:14:25 -07:00