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

16 Commits

Author SHA1 Message Date
lili
a207cb8d65 docs(agents): skill 规范化双层收口 + 席位context skill 新增 + W-NSTAR/W-TPL/W-GENLOG 设计波落档
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
Details
docs-gate / docs-gate (push) Has been cancelled
Details 
- .agents/skills 25 件全量 frontmatter 规范化与评审修入(含 prompt-governance 大修);.claude/skills 7 件薄壳按双层方案①落位
- 新增 skill:agentic-seat-context-design(agentic 席位与 context 工程设计基线,2026-07-05 探索蒸馏)
- 设计波三件落档:复杂游戏北极星件(W-NSTAR 终审稿待拍)/黄金模板规格件(W-TPL 定稿待批)/生成侧过程蒸馏回路(W-GENLOG 骨架)
- protocol/在飞板/作战清单/数据飞轮 SoT/契约 prompts 索引同步;breakout 九门证据刷新
- .gitignore 补 /localagents.md 真实忽略行(该文件自声明绝不提交,此前声明未被机器执行)
- 刻意不入库:nacos-data/ 与 _tier2-gen、c2v-*、amgen-* 生成产物(可重生成,忽略行格式待拍)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-06 05:32:56 -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
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
lili
071f44713d docs: 删 4 份纯 gamedef 死设计文档 + 修引发的活层死链 
删除(gamedef=已废错误路线,2026-06-21 创始人判废):
- docs/brainstorms/2026-06-18-生成失败根因分析-requirements.md
- docs/brainstorms/2026-06-19-plan003-phase1验收闭环-requirements.md
- docs/plans/2026-06-19-002-feat-gendone-用对M3生成生死门-plan.md
- docs/plans/2026-06-18-003-feat-gen-quality-converge-and-m0-integration-plan.md

修死链:.agents/skills/saa-graph-orchestration.md 去掉指向被删
根因分析文档的失效指针(保留根因结论本身,SAA 编排史有效经验)。

边界档 docs/plans/2026-06-19-001(status=active、主体即 gd-runtime)
仍引用被删档(origin + 来源段),按 spec 划为"留待人判·别动",
其遗留死链列入收尾报告上报,不在本次授权内处理。

docs/agent-specs/_index.md 经查无指向这 4 份的链接。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 01:59:01 -07:00
zizi
a1e9265305 Merge 'feat/mac-amodel-foundation' → dev/2.0.0:A-model 地基(Tier1 agentic 优化) 
并入 A-model 分支 22 提交:4 编排插件(hud-ui/scene-fsm/session-score/timer-scheduler,
各带 api.d.ts/impl/manifest/test)+ catch-fruit 样板游戏 + amodel-gen 工具链
(gen/m3/play/prompt/tools/publish.mjs)+ boot-game-host/all-plugins/plugin 扩展 +
source-project.schema.json 升 oneOf(1.0 gamedef-legacy / 2.0 A-model 多文件代码工件)。

唯一冲突 = contracts/agent-loop/source-project.schema.json 顶层 description(两侧都改):
取 A-model 的 oneOf 结构升级为基底,再补回 dev 侧的 tier2-边界 note(本 schema 限 Tier0/1;
tier2 真 Phaser 引擎另立独立 schema、不复用本路)——两侧意图互补不矛盾(HANDOFF 已预判)。
JSON 校验通过,oneOf 2 支 + 两侧意图均在。

dev/2.0.0 侧 ~20 提交(tier2 计划/细图/接口协议/agentscope 2.0.2 订正)全在 docs/tier2/contracts,
与 A-model 的 game-runtime 改动零代码重叠。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 03:33:30 +00:00
zizi
c9db9f7d36 docs(agent-specs): 域化重构收尾(保守批)——归档18档+清引用+_index瘦身 
确立 docs/architecture 为设计/现状唯一真源,agent-specs 仅留正在演进的设计。
回灌核对(review §2.4)后将 18 份「已迁入 architecture 或纯留痕」的设计/过程档
git mv 进 _archive(各带 SUPERSEDED tombstone 指新落点);生成域在飞设计链
(架构演进路线/生命周期范式/多session总账/任务普查)+ 3 待定档暂留,待二次收尾。

- 归档 18 档:SAA编排/引擎运行时/验收门/prompt治理(settled 底座,内容在子树)
  + WG1/设计裁决/OpenGame/开闸接线/固定架构review/传承演进/并行编排(已迁子树)
  + 完成度总账(FOLD 进需求模块映射)+ SAA-dossier残留 + 根因复盘/目录治理/
  深度重构plan/文档整理plan/planB-closeout(纯留痕)
- 清 7 处死引用:5 处 .agents/plans 旧 agent-specs 路径→新树 + 2 处 architecture
  树内回链(开闸接线/观测体系→验收门新树路径)
- 修 7 处归档连带死链(指已归档档→新树现行档 或 _archive 留痕)
- _index 补 2026-06-22 收尾 banner + 6 处指针改新树/_archive
- 死链门 check-deadlinks.sh = 0;收尾清单 docs/plans/2026-06-22-域化重构收尾清单.md

待二次收尾(创始人选保守暂留):总体架构-review/固定架构-execution/产品开发路线图
(architecture 仍当其权威源回链,需先补迁详义)+ 对话素材v1(留痕,牵连保留档链接)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 18:18:31 +00:00
lili
0ae557d388 docs(.agents): 并入 dev/2.0.0 后补回本地独有蒸馏(saa-graph §3.5 两类静态游戏 + security CSP unsafe-eval 红线) 
FF 合并 dev/2.0.0(19 提交)后，把 merge 前工作树里两处本地独有内容补回：
- saa-graph §3.5「两类静态游戏(gen-quality 哑火 vs wiring 哑火/CSP)」块——dev 未含，运行时无关的裁责快招，保留。
- security §1.1 CSP unsafe-eval 红线——与 dev 第4行(蒸馏来源域化)取并集；措辞泛化为「受控代码执行面」(不绑死 gamedef，兼容 agent 写码路)。
inject.ts/staging-ops 采 dev 版(功能等价、零损失)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 00:55:02 -07:00
lili
f4c6789312 docs(saa): 蒸馏 M3 thinking 治理/协议/流式 + rc 门修(91.7% 跃迁) → .agents 技能 + 决策档 
§7 知识沉淀（仓库权威版，配套代码提交 4e5a7bbf）：

- .agents/skills/saa-graph-orchestration.md：新增 §3.5「M3 thinking 治理 + 协议/流式」——M3 thinking 二元(无深度/budget、提示词压不住)；openai adaptive 内联污染→只能关；anthropic 原生分离要质量走这条但必配【流式 StreamingCallChatModel + NO_PROXY webClientBuilder】否则阻塞整取大面积 SocketTimeout；#4407 对 1.1.2 过时；rc 门耦合 bug(playNode pass 别前置 rc==0)。e2e 段补 2026-06-20 跃迁(67%→91.7%、证伪模型天花板)。
- docs/plans/2026-06-20-…md：状态 banner→主线达成 + 追加 §7 结果与修正(rc 真根因 / thinking+协议杠杆 / 实测对照 / n=12 达标口径放宽 / 未尽项)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-20 11:38:59 -07:00
lili
affb507bc3 docs(.agents): 沉淀 003-U1 e2e 验收门工具化 + 「SAA 路无¥(token≠¥,折¥=F3)」坑 
扩 saa-graph-orchestration「真·全图 e2e 测成功率」章一条：SaaFullGraphE2eTest 003-U1 工具化
（n≥10/外部 brief 文件、minSuccessRate 可配硬门默认不设、token 成本会计软警告、模型无关单测），
并记关键坑「SAA 路无 ¥ 数据（SaaGraphDispatcher cost 整段省略，折¥=F3）→ 别接¥门、别造假¥」。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 16:30:43 -07: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
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
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
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
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
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
b7786caa40 docs(saa): 新增 SAA 图编排 skill + 索引（AGENTS §7 沉淀） 
知识缺口收口：现有 ai-generation-pipeline.md 是退役 Dify 蓝图、无 SAA 编排 playbook。
新建 .agents/skills/saa-graph-orchestration.md：最小依赖集/拓扑/加节点/接 new-api(剥 /v1 坑)/checkpoint(含 saved_at 无 tiebreaker 框架坑+显式 checkPointId 修法)/observation/派发契约/验证门(门E/门B)。
索引更新 .agents/README.md + AGENTS.md §5。

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