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

36 Commits

Author SHA1 Message Date
lili
5d0f351050 docs(cheap-gen): W-AXIS 波0 文档批——诊断档+SoT×4 修订+两份 plan+策展层勘误 
2026-07-09 创始人方向性质疑经五路审计坐实,正式推翻两个历史结论(80% 天花板=口径混淆
+stripCode 污染;玩法坏死主因=判卷合约缺口误标),病根三条=判定语义膨胀/判卷合约反噬/
真相层缺失。本批为纯文档批:

- 诊断档 docs/brainstorms/2026-07-09-生成线harness方向性诊断与换轴方向.md(人审版)
- SoT 修订×4(双评审修入、docs-gate 绿):质量模型裁定三(L1 双证据=机械预筛∧独立模型
  玩法判定,fail-closed+金标校准)/图说护城河改「分层验收」/验收门 §2.4/AGENTS.md §3.1
- 执行版 plan×2:07-09 三波换轴 + 07-10 验收v2(测试agent替E/G/H,创始人已批,
  含附录A SoT 修订逐字终文与波0-3 工单拆分)
- 策展层定点勘误:tech-decisions/三份生成线 skill 追加 2026-07-09 勘误注记(过九门
  自此只算机械预筛),feature-design-doc 固化「人审版=brainstorm/SoT、执行版=plan」定位
- 在飞板登记 W-AXIS

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-10 04:27:17 -07:00
lili
8f2ca254ad docs(agents): §6.13 硬约束——工具输出只是参考不是事实,最终产物必须真浏览器验收 
创始人 2026-07-08 定:任何工具/harness 判定(check.ok/九门 verdict/smoke/lint/bright 等)
只作参考、绝不当事实——会假阳也会假阴。当日 stripCode 遇字符串内 // 致 check 假阴性误报红线
缺失(模型写对却被反复拒到熔断)、九门也放行过秒死/存档刷分坏死游戏,双向坐实。故:每个最终
产物必须真浏览器打开、亲看亲玩、截图硬证验收;失败根因下钻到具体代码/数据/配置,不停在「工具说」。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-10 04:27:17 -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
a164f4c222 docs(.agents): 配置控制面阶段〇蒸馏 + 累积能力蒸馏批次 + 本轮 plan/设计 
- tech-decisions §10:配置控制面阶段〇生产基建落地(Nacos 2.4.3/RocketMQ 5.3.1/Sentinel
  自托管 mini-infra + 三层并发正交承重[Sentinel=入口QPS / consumeThreadMax=dispatch速率 /
  有界worker池=真并发cap follow-up]+ rocketmq-spring consumeThreadMax 无界队列坑:死参数须 min=max)
- AGENTS.md:Nacos/RocketMQ/Sentinel 反转为 MVP 生产 runtime(2026-07-01 build-vs-buy 现货尽调)
- 累积 .agents 蒸馏:agentscope-2.0-facts / build-vs-buy 硬门 / cheap-model-game-generation /
  contract-first-development / game-e2e-cdp-harness + README 索引
- 本轮留痕:配置控制面 spike 与阶段〇 plan + 设计文档

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-01 18:53:39 -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
zizi
3cd4769f6b docs(agents): 精简 AGENTS/指令体系 + 立功能设计文档规范，删退役 pipeline 
- 新增 feature-design-doc.md：功能设计文档作业手册（WHAT+HOW 合一·图文一式两份：文字+mermaid 给人/AI、svg/html 给人更重要；取代 review/execution 双档）
- 删退役 ai-generation-pipeline.md（Dify/OpenGame 蓝图）；现行红线（回调唯一写入路径/免鉴权身份注入/HMAC 验签）抢救进 security-and-reliability §1.3；8 处引用改指向 agentic-amodel/saa/§1.3/§5.2
- AGENTS.md 226→182：§5 四张资产表删→指针（根治与 README 双维护漂移，补回漏列项）；§3.1 生成线 banner 考古史瘦身；§3.3+§6 接入功能设计文档
- README 索引同步

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-24 13:46:03 +00: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
ae7d78ddde docs(arch): 全仓架构档对齐游戏生成两条线(组外 ~14 档) 
- tier2 富游戏线 = AgentScope(Python 独立 service) + Phaser；Tier0/1 廉价线 = SAA + LittleJS(产物走 src 源项目)
- gamedef json 正废除中(另会话)→ 终态=可维护 src 源项目；gameDefinition 现为迁移中的中间脚手架/债(非已移除)
- Cocos 区分：退出 tier2 自治轨改 Phaser；Tier3/3D/渠道导出的 Cocos 保留
- 未来可能两条线收敛入 AgentScope(登记)
- 覆盖：顶层图说体系(系统全景/架构/产品/前端图说) + 架构核心(README/产物执行沙箱) + glossary/tech-decisions + AGENTS§3 + mvp(总账/作战清单/可行性方案) + agent-specs(agentic编排-SAA/_index) + 图①svg

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 14:24:20 +00:00
lili
6e388d9bbb feat(amodel-gen): agentic A-model 生成 harness(ReAct+M3)+ skill + 四层设计 
spike 验证通过:M3 经 new-api(openai+tools)agentic 自闭环产出可玩 A-model 游戏。

- harness game-runtime/tools/amodel-gen/(tools/play/m3/prompt/gen.mjs,零三方依赖):
  scaffold(clone _template)→ ReAct(read/write/list/check/build/done;done 门=check+build 绿;
  compaction + loop-detection)→ 循环外 play(headless Chrome boot+截图+交互 = 能跑能玩)。
- 3/3 玩法干净自闭环实证:打地鼠 / 陨石躲避 / 反应点击(13-22 步,175-378K token,play PASS)。
- skill .agents/skills/agentic-amodel-generation.md(链路/配方/8 坑/M3 实证/主流定性)+ README/AGENTS 索引同步。
- 设计 docs/agent-specs/2026-06-21-agentic-amodel-generation-design.md(§0 整链路 current→new + 四层 + §0.8 主流对照;draft 待 §6.8 双评审)。

取代旧 gamedef/factory 单次产线(A-model 生产形态);production 删 gamedef 待双评审(D1=A 无退路)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 18:50:38 -07:00
lili
c44681b580 feat(runtime): A-model 地基——4 编排插件 + 2 skill + _template/catch-fruit + SAA 改写评审版 
- 新增 4 编排层插件(session-score/hud-ui/scene-fsm/timer-scheduler),barrel 注册 12 件,各 impl/api.d.ts/manifest/PLUGIN.md/test,全 node 测绿;audio-music manifest 描述修红门
- skill littlejs-game-dev(code 层:12 插件 API/结构/写-vs-调/资产-mmx/工厂契约)+ sim-business-game-design(design 层:经营模拟范式 + 反"无趣"配方)
- _template(游戏克隆起点,10/10)+ catch-fruit(sonnet 扮生成 agent 只凭 skill 产出,25/25,真浏览器可玩 + canvas 自适应修复)
- docs/agent-specs SAA→A-model 改写评审版(Opus+Codex 双评审收口;D1=A 全压 A-model/D6=A 押 SAA,D6 已 mini-desktop 活验证 1/1)
- staging-ops 加「ssh 绕代理直连内网 IP」配方

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 09:58:52 -07:00
zizi
1ded0281bf docs: 无AI味写作标准入 AGENTS §6.12 + tier2 自治富游戏引擎设计(生成引擎子树·风格金样板) 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 12:28:38 +00:00
lili
7bd9cd05e6 docs(governance): Phase7 收口——治理门反转 + 源档归档 + 入口对账 + 死链门 
设计文档域化重构总收口:
- §10 治理门反转(engineering-conventions §10.5/10.6/10.7):canonical 根从 agent-specs 改为 docs/architecture 6 域树;品牌门白名单加 architecture/_archive。
- 归档 11 settled 源档(7 根 architecture + 4 非生成 agent-specs canonical)→ 各自 _archive(git mv 保 history + tombstone redirect)。生成域设计链过渡期保留(架构演进中)。
- rewire 17 个活层文件(.agents/knowledge|rules|skills + docs/mvp + AGENTS.md + 新树)指向新树路径;活层零残留旧 canonical 路径。
- AGENTS.md §4 必读表/§3.2 目录树/§3.3-3.4 指针 → 新树;_index.md 瘦身为 trace/spike + 生成域演进链 + 修 line22↔40 自相矛盾。
- 新增死链门 .agents/tools/check-deadlinks.sh(§10.7 死链项的可执行脚本)。
- 全门齐跑:死链 0 / 新树无旧品牌 / 无超 2000 行 / 活层无残留。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 20:48:38 -07:00
zizi
dbb0a76856 docs(治理+生成): 文档治理强制门体系 + 整体一致性负责人 + AGENTS.md 全中文化 + 品牌收敛 + 生成产物终态定调 
- AGENTS.md: 品牌「造梦AI→绘境AI」+ 剔除 §9 gstack 安装命令(入口卫生) + 全文简体中文化
  + §6 条款10/11(强制门清单 / 整体一致性负责人=创始人+6c6g文档线 / AGENTS.md 自检)
  + §3.4 关键模块架构设计引用(指向 product-and-architecture.md, 不在入口重写)
- engineering-conventions §10.7: 4 道强制门可执行规格(品牌不变量 / canonical唯一 / doc↔code兑现 / 入口卫生)
  + 白名单(docs/ip 法务 + _archive 留痕豁免) + AGENTS.md 自检清单
- 生成主线架构演进路线.md: ★产物终态定调(创始人 2026-06-20 拍)——终态=src/ 多文件工程,
  gameDefinition 仅中间脚手架, new Function 跑 JSON 内嵌串=债; 配 doc↔code 兑现门;
  就地 reconcile v2/固定架构「都 ACTIVE 却冲突」
- 现行层品牌收敛: .agents/ + docs/architecture/ + docs/mvp/ 共 20 处「造梦AI→绘境AI」

由来: 2026-06-20 架构错误 + 文档治理复盘(codex/opus + 三 agent 对抗验证收敛);
根因 = 规则没编译成机器门 + 整体一致性无主。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-20 16:55:24 +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
6c9c1bd2ad docs(agents): §6 条款8 去掉 Harness 触发——只保留 plan/brainstorm 文档双评审要求(创始人定) 
创始人 06-18:AGENTS.md 只写'新建 brainstorm/plan 文档须 Codex+Opus 双评审(Codex 挂回落 Opus)'这条要求;'写入 Harness'触发不入 SoT 条款。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 08:03:21 +00:00
zizi
aefffb889d docs(agents): §6 加硬约束条款8——plan/brainstorm 文档及写入 Harness 必 Codex+Opus 双评审 
创始人 2026-06-18 定:新建 brainstorm/plan 文档(含就地扩活计划补 units)或写入 Harness(九门 e2e 评测 harness=生成质量裁决器)→ 收口前必过 Codex+Opus 双评审,Codex 不可用回落 Opus 单评;并行跑+喂设计前提+在档修+跨档列待办。本会话立证(对 plan 002 增量揪 2 P0)。放 SoT 入口档而非 .agents/rules(创始人指定)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 07:54:50 +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
51c6811e11 feat(agents): 文档整理助手 skill（doc-organizer）——增量 + 两阶段审批门 
承接创始人需求:手动触发、增量(记上次清理时间→只分析该窗口)、两阶段审批门(发起分析 Workflow→编清理计划→评审→创始人批准后才动手清理)。把 2026-06-16 首轮目录治理固化为可重复可控流程。

三轴:①过期历史档→归档/压缩 ②核心设计档→措辞对齐现行真相 ③主任务总账→回填。组成:.agents/skills/doc-organizer.md(playbook两阶段) + .agents/tools/doc-organizer.sh(检测scan/可逆归档archive/记时record,实测exit0) + doc-organizer-analyze.mjs(分析相Workflow,三轴fan-out只读) + doc-organizer-state.json(seed 7f24a344@2026-06-16)。

手动触发=~/.claude/skills/doc-organizer/SKILL.md 薄入口(本机注册,照 _gstack-command 范式;执行逻辑随仓走)。红线:检测自动·判断留人·脚本不自删·阶段一只读·最新日在飞档不碰·白名单 orchestrator/channel-spike/generation-spike。索引同步 AGENTS §5 + .agents/README。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 15:47:59 +00:00
zizi
ca695362bd fix(trade): M4 支付 2 个 P0 资金安全 bug(对抗审计 Opus+Codex+主agent 三方确认,87单测漏掉) 
- P0-1 money-loss:AccountServiceImpl settlePaid/refundFrozen 更新 0 行原只 log.error 不抛→改抛 TRADE_ACCOUNT_FROZEN_NOT_ENOUGH(错误码 1-106-001-002),让 handlePayoutNotify(@Transactional)的 status CAS 与账户动作一并回滚,杜绝"状态已置终态、资金没动"半态 commit 破 balance+frozen+total_withdraw=total_income 恒等式;对齐既有 freeze 0 行抛错范式
- P0-2 切渠道误驱动:PayoutClientFactory 加 byChannel(channel)(current() 委托之、fail-fast 收敛一处);compensateStuckPayouts 改用 byChannel(w.getChannel()) 按提现单记录渠道查终态,而非当前 Nacos 渠道——切渠道(mock→wxpay)不再用错渠道 client 误驱动 1→2/1→4
- 单测+5:0行抛错(settle/refund)/回滚透传(handlePayoutNotify)/byChannel(注册·未注册fail-fast)/compensate 渠道路由;mini trade-server 46 测全绿(41→46)零回归
- Codex 佐证:同 bizNo 并发/成功失败回调赛跑/审核驳回赛跑均被 uk_biz_no/status CAS 挡住(安全),无新增 P0
- 余 P1/P2(mock 渠道崩溃卡单兜底/ad 回调空 secret 铸币面/setSql 预防)待 Codex 完整报告后续修
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 10:55:47 +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
zizi
b92eba6b06 docs(agentic): 主线 agentic 基建口径 HJ-AGI-001(AgentScope 2.x) → HJ-AGI-002(SAA) 漂移对齐 
SAA 迁移 spike 落地后，把主线文档里"agentic 基建=AgentScope 2.x(HJ-AGI-001)"的过时活文本，对齐到现行决策 HJ-AGI-002(SAA-only)。审计由 5 代理 workflow + Codex 独立审 + 源码 grep 三源交叉定位，再独立验残零遗漏。

- Tier-1 活文本直改(7处): AGENTS.md / tech-decisions.md(×4，含 §95 "SAA 藏 job/callback 契约#6 后保持可替换") / contracts/DEPRECATED-dify-workflow-io.md / .agents/skills/ai-generation-pipeline.md
- Tier-2 活文本改+回填注(9处): product-and-architecture / glossary / mvp-scope-and-milestones / ai-development-protocol / 技术架构与模块(T-AGC-18) / MVP进度总账 / MVP作战清单
- Tier-3 历史 spec 加 supersede 横幅(4档): 2026-06-12-agentic基建框架选型-review、2026-06-14-OpenGame蓝图补缺-review、2026-06-14-P3-W-G1生成主线-review/execution
- 统一口径: SAA(Spring AI Alibaba v1.1.2.2)裸图编排，short-term SAA-only，AgentScope 降 long-term premium 独立轨
- 历史进度账用括号回填、不改史；全仓 grep 残留零(Python 对照基线/banner 覆盖项除外)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 02:34:42 +00:00
zizi
063ec4edf2 docs(rename): ③ 文档/契约漂移清理——contracts+docs+根文档 yudao 标识同步 com.wanxiang.huijing(follow-up,脚本) 
- 范围:全仓除已完成的 game-cloud/game-admin(及排除区);91 文件
- cn.iocoder.yudao→com.wanxiang.huijing / cn.wanxiang.game→com.wanxiang.huijing.game / cn.iocoder.cloud→com.wanxiang / Yudao*→Huijing* / bare yudao→huijing
- 含 contracts/api-schemas(apiInterface FQCN)、docs/architecture+agent-specs(含中文名,git ls-files -z 修复)、AGENTS.md/CLAUDE.md 等根文档
- 保留不动:上游归属 URL(gitee/github yudaocode·YunaiV,改则断链+违反署名)、game-cloud Flyway 迁移注释(保 checksum)、lockfile(装包重生)
- 纯文档/字符串,零构建影响(game-cloud/game-admin 字节码未动)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-15 14:32:44 +00:00
zizi
d79f2c37d5 docs(wg1): L1 newer 蒸馏增补(reframe→knowledge / design-agent gatespec)+ AGENTS.md 补登记 + staging-ops 四机口径 
① tech-decisions §4.1 生产质量三层 reframe(确定性门=地板/便宜player=主观层有天花板须人锚/创始人抽检不可替代;无Claude在生产环;上下文杠杆 -50%/-80%、player MAE 1.25→0.75)② cheap-model §7 design-agent 自产 gatespec(roles.DESIGN_SYSTEM 产机器可读 gatespec→studio._extract_gatespec 合入;ballPath .y→.x 坑+归一兜底)③ game-e2e-cdp-harness §7 gatespec 交叉链 ④ AGENTS.md §5 补登记 L1 漏注册的 cheap-model-game-generation.md ⑤ staging-ops 四机分工(创始人编辑)。出处 a205929/405394d/WG1 评估门 review §8。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-14 13:06:01 +00:00
zizi
4fe0845e2d docs(close): T1b-α wave-close 七步收口——总账补今日五波欠账(渠道/W-CLEAN/T1b-α/战略审计簇/收口)+作战清单归档⑫与完成线提请重锁(候选=T1b-β+链路③⑤);蒸馏新skill game-e2e-cdp-harness(编排形制/驱动器六律/出厂红线)+game-runtime/.agent户口+e2e runbook自/tmp入库+收口报告落档;索引双同步;逮修W-CH行陈旧C1-C2待拍款 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-06-12 18:33:06 +00:00
zizi
1272383507 docs: 裁决①落账+单源文件清毒——三件插件改引擎能力包装层(β真接线门);tech-decisions三处(模板双层+LLM填参退役/adapter行/护城河runtime出列);AGENTS栈行Dify-OpenGame-RocketMQ-Nacos如实化;T1b-β显式队列行立项 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-06-12 17:23:42 +00:00
zizi
5a40824168 docs(audit): 自研偏误全链审计落地——报告HJ-AUDIT-NIH-001入库+rules/build-vs-buy.md七条硬规+三处死约束/复发种子回填(AGENTS.md 15KB·复用三级次序·编排引擎行改判)+整改包登记(🔴引擎零接线待创始人裁决) 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-06-12 17:07:45 +00:00
zizi
60e736ac1a docs(harness): 收口协议单清单化+四处漂移纠偏+配方出仓蒸馏——2026-06-11 harness 体检落地 
体检根因：收口规则散落 4 处（总账铁律/作战清单回填铁律/README 维护规则/协议 §6）靠记忆执行
→ 漂移已实发（总账表头停 06-09 两日、作战清单轮次未滚动、.agent 残留 Day-0 横幅、AGENTS §3 仍写"三仓未入本仓"）。

- 新增 .agents/skills/wave-close-checklist.md：收口七步唯一可执行清单（总账+表头/作战清单+归档/回填/.agent 仅结构变化/蒸馏/索引/编排资产入库+30秒自检）；总账铁律、协议 §6、编排文档全部改为指向它
- 四处漂移一次纠偏：总账表头 06-11+对账 f403d11；game-cloud/.agent（Day-0→11/13 模块实态、技术栈对齐 C2 裁定、Wave4 销账）；game-studio/.agent（mock 态→接 staging 实态）；AGENTS.md §3 monorepo 实态+目录树补 contracts/game-*/deploy/mvp+memorys 标记停增
- 作战清单瘦身：3843 字符巨型 bullet 等完成史整体迁 MVP作战清单-完成史归档.md（原文快照保真），清单 68→33 行只留队列；新一轮完成线标注待创始人拍板重锁
- 配方出仓蒸馏（原仅存会话私有记忆）：skills/staging-ops.md（机器分工/git 同步/重部署字节码实证/前端构建门/冒烟）+ skills/ui-walkthrough-cdp.md（CDP 七坑/studio/admin 走查/信道探针）；README+AGENTS §5 索引同步（§5 顺带补回漏登的 add-game-template/prompt-governance）
- 编排器 .agent 户口：QA 工具箱定位/组件清单/纪律（新工具不再长进 runs/）/Doc B T-id 编目与 tools/ 迁移留待办
- 协议修正：§5 前端验证门 pnpm test→npm run build（vue-tsc 假门禁红线入文）；§1 历史检索改指 agent-specs 收口报告；mvp-execution-orchestration 加波次制现状注记（Day0-15/站会为目标态）
- .gitignore 加 __pycache__/.pytest_cache（注释说明与 build/ 老雷的区别）

遗留：nightly cron 哨兵（动 mini-desktop，待拍板）/ Doc B 未编目组件销账 / tools/ 迁移评估。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-06-11 13:26:04 +00:00
zizi
4503f6de9e docs(agents): AGENTS.md 去重瘦身——删除与全局配置重复的内容,gstack 收敛为 /gstack 单入口 
- 删除 §0 协作原则整段:与维护者全局 ~/.claude/CLAUDE.md 高度重复,流程性内容仓库内已由 §6 工作协议 + .agents/workflows/ai-development-protocol.md 完整覆盖
- 仓库内唯一无落点的「无孤儿设计」硬规则压缩并入 §6 第 7 条,保证对不读个人全局配置的 agent 自洽
- §9 gstack 收缩为入口指针:删除与全局配置重复的硬约束与 35 技能清单(已过期,盘上实为 53 个),只留一句话描述+安装命令;子技能统一经 /gstack 入口按需读盘触发,不再单独注册
- 章节编号 §1-§9 不变,全仓引用 AGENTS.md §7/§8 的交叉引用不受影响

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-06-11 10:16:32 +00:00
zizi
8a59a35133 docs(audit)+docs(mvp): 三向审计修复全链入库——报告+W1回填+创始人拍板波+W2清洗+三件产出 
- 审计报告 HJ-AUDIT-001 入库 + W1 文档回填波（技术决策版/Doc B/开发团队版废止横幅/AGENTS.md/两规则档/tech-decisions）
- 创始人拍板波（2026-06-10 晚，回填铁律逐项执行）：
  · R4=维持 D2 按 D2 改建（M-c 建 merge→idle→tycoon，动作类降 P1 留契约）→ D2 复审注+tech-decisions #6
  · 鉴权七项全拍（§9.1：C 验证码+邀请码旁路/受限激活/开放注册/创作限白名单/一键登录/实名提现前/纯客户端 anonId）→ glossary+events.schema.json 同步
  · A1 闸门看板建账（12+1 项含短信报备+大模型登记/算法备案/分账选型，主体已确认）+ 律所合规咨询 brief
  · 奇绩 ★1/2/3 定稿 + 品牌造梦→绘境清扫（4 档正文+文件名、demo 改名 huijing-ai-demo.html、禁投/禁外发横幅、内部引用 5 处）
  · M-c 四细节（两批 merge 先行/idle 纯前端+storage/10 校准+20 正式/拖拽为主）
  · R3 收口（叠加规则=IP 从创作者份额出·净额基数·平台恒 20%，eCPM 档 15/30/60）→ D3 复审注+glossary+BP:299 勘误
- W2 对外清洗收口：BP 改造版红线清洗（20 处锁风系红线词清零/独家→非独家/绝对化清零/06-10 实证+三线排序入文，留 3★ 待创始人）
- 三件产出：鉴权 execution 版（V11/system 内扩展/14 @PermitAll 端点/NOT NULL 硬边界）+ Mc 模板波 review 版（已拍）+ 单位经济敏感性模型（基准 324 元/月/千DAU，覆盖基建需 1.33 万 DAU→实证 B 端现金线优先）
- 两本账同步：作战清单（五件拍板项清零）+ 进度总账（三行执行记录）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-06-10 08:51:30 +00:00
zizi
6cf1515e98 docs: 整合项目入口为 AGENTS.md 单一事实源 + 英文化 
- AGENTS.md 升级为单一事实源：并入项目定位/目标/目录 + 新增「角色与协作原则」，整体英文化
- CLAUDE.md 精简为仅 @AGENTS.md 导入，消除双文档同步负担
- .agents/README.md 交叉链接同步指向 AGENTS.md 唯一入口

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-09 10:57:23 +00:00
zizi
570632793b docs: 品牌改名 绘境→造梦 / huijing→wanxiang(仅文档层)+ 治理文档更新 
- 品牌改名：中文 绘境→造梦、英文/拼音 huijing→wanxiang；严格仅文档/计划层
- 代码/契约/Java 根包名一律保持 huijing 不变(cn.huijing.game / HuijingGameSDK / contracts)
- 文档↔代码命名分叉为已知接受态，留待未来专门的后端包名重构(见记忆 brand-rename-huijing-to-zaomeng)
- .agents 治理体系 + CLAUDE/AGENTS 入口 + architecture 三文档套件 + memorys/superpowers spec 更新

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-08 09:11:10 +00:00
zizi
9735142518 docs: 文档治理——单一事实源去冲突 + 版本历史清理 + 文件名去日期 
- 删除 4 个已过时文档（v2 架构选型审阅版 / v2 模块架构与MVP覆盖度 / 2 份已归档 review），
  架构文档收敛为 6 份、agent-specs 收敛为 1 份
- 消除冲突与陈旧值：基础设施成本 ¥3,800→¥4,300；生成成功率 85% 消歧为
  "远期蓝图 / MVP 验收 80%"；技术决策版架构图补 studio（12→13 模块）；
  契约口径全仓统一为 8 类（7 个 Day-0 contracts/ 文件 + Prompt Registry 第 8 类）
- 清理各文档内部历史/迁移/changelog 段落与失效引用（已删"业务能力全景"章节号引用、
  LayaAir 导出快手等事实错误）
- 8 个保留文档文件名去日期，全仓 markdown 链接与蒸馏来源引用联动更新；
  AGENTS.md 必读清单（7→5 份）与 CLAUDE.md 目录结构同步
- docs/memorys/ 按全局约定豁免（保留带日期归档），docs-design/ 不在本次范围

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-07 17:46:17 +00:00
zizi
824183864e docs(architecture): 重构为产品/技术/映射三文档 + MVP 迁移产品功能口径 
- 去版本化：能力清单拆为三文档（产品需求清单/技术架构与模块/需求模块映射），
  文件名去 v2.1 版本号为唯一权威副本；删除混合视角旧档《业务能力全景与模块归属》，
  ~20 处交叉引用重定向（git 留史）
- 模块 12→13：新增 game-module-studio（创作编排域），aigc 收敛为无状态生成原子；
  锁风门 Gate(owner=compliance)、专区 Zone(owner=project) 两横切显式建模
- MVP 口径迁移：验收单位由"能力项(131)"改为 Doc A 的 55 项 P0 产品功能，
  工作量≈137 技术项；CLAUDE/AGENTS/mvp-scope/执行 spec §7/工作流 全链同步
- 三轮评审（人工 + 3 独立 Opus）findings 已修复：0 断链/0 孤儿/0 重复 ID，
  计数 155/204/137 实测自洽；glossary 补锁风门/专区/创作会话/资产图术语
- 新增 docs/memorys 任务记忆与 agent-specs 重划/prompt 治理评审依据

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-07 12:38:14 +00:00
zizi
bf457e88a6 docs(agents): 落地分层运行时决策 + MVP 执行编排与复利提效体系 
- 新增 workflows/mvp-execution-orchestration.md（10-Agent×3周编排 + 8 条复利提效策略）
- 运行时升级为分层：Tier1 自研Canvas(<15KB)/Tier2 Three.js 锁定，Tier3 独立App引擎推迟 MVP 后定
- 修正事实错误：LayaAir 官方平台清单无快手；导出以微信小游戏格式包为枢纽，快手走微信格式兼容转换
- 盖章创始人已确认决策：80%验收/85%蓝图并存、131项 P0 全量、非目标保持收敛(3D/App 仅远期探针)
- AGENTS.md 增"效率原则"节；CLAUDE.md/README/mvp-scope 同步对齐

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-07 05:19:49 +00:00
zizi
dced7d000d docs(agents): 建立 .agents Agent 治理体系与项目入口文档 
- 新增 CLAUDE.md（项目定位/目标/目录）与 AGENTS.md（工作入口指南）
- 新增 .agents/{README,knowledge,rules,skills,workflows} 共 12 份能力中枢文档
- 基于 7 份架构文档蒸馏，统一 4 处源档冲突（运行时栈/成功率/工期/范围）
- 全部 91 条相对交叉链接已校验通过

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-07 01:44:56 +00:00