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

19 Commits

Author SHA1 Message Date
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
zizi
7ecd616eb8 docs: tier2 口径对齐批量修(① 旧 Cocos 引擎口径→Phaser/Pixi 两轴 · ② 第二轨/控制面在各 SoT 登记;15 档跨知识层/架构/前后端/产品/运营) 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-21 16:58:59 +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
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
ebb994b155 docs(conventions): §10.5 立 canonical 活档约定 + knowledge 加 canonical 指针 
§10.5(补 §10.4 子系统粒度落地):canonical 活档=无日期主题名子系统SoT,与§10.1 dated命名词表互补;
dated spec 波次收口折进对应 canonical;分层 canonical>knowledge速查>architecture基线>总账状态(不双写)。
product-and-architecture 加子系统 canonical 指针(知识层→canonical 接线)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 14:14:11 +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
c52a8305a0 docs: 文档真相对齐——蓝图除锈 + 工作记录压缩/退役06-09设计簇 + 技术决策版重写计划 
承接 agent-specs 目录治理对『哪些工作记录该压缩 vs 哪些核心设计档该重写』的追问，按目标 1→3→2 落地。

[1 蓝图除锈] .agents/knowledge 4 档(tech-decisions/glossary/product-and-architecture/mvp-scope)外科改 11 处：把 Dify/OpenGame/自研Canvas/ComfyUI/AgentScope 当现行架构的过期表述，改为现行口径(模板驱动 via new-api / LittleJS / SAA HJ-AGI-002 / mmx-cli)；已正确标降级的 mention 不动。

[3 压缩+退役] 23 个已收口 execution/edit-plan 巨档压成桩(留状态横幅+目标+结论+权威指针；Mc批② 1305→9、wave3 985→8、A0 789→9、P3 641→10…)；退役 06-09 核心功能技术实现方案单体(2360→9)+总体设计-review(选型层全过期)并删其 sections/ DUP(11 文件)。docs/agent-specs 21M→4.0M。

[2 重写计划] 技术决策版(AGENTS §4 架构基线,96 处废弃选型词)逐节重写计划落 docs/agent-specs/2026-06-16-技术决策版重写-review.md，待创始人批准后执行——本提交未动其正文。

约束：仅动文件名 ≤2026-06-15 的件 + .agents 蓝图，0 个 06-16 在飞档被改。完整方案见 2026-06-16-agent-specs目录治理-review.md。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 12:17:16 +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
cf2e1ed3b5 docs(agents): 改名收尾——playbook 内 yudao-server/YudaoServerApplication/cn.wanxiang.game 同步到 huijing-server/HuijingServerApplication/com.wanxiang.huijing.game(follow-up ②,c74aa7da 改名连带) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-15 13:31:31 +00:00
zizi
f63c56bec8 docs(cleanup): 全文档清毒收编——长尾18改+1新建(知识3/技能6/DocB注记/契约deprecated/DifyCallback诚实注记×4/双.agent/执行spec横幅)+主会话补刀tech-decisions两处漏网(回填横幅与生成主线行的'模板驱动'死口径);活文档面残毒终扫清零 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-06-12 17:40:16 +00:00
zizi
75d01f0e92 docs(tier1): 约束框架定稿——15KB红线废除→三层框架,四路引擎尽调收口(HJ-T1-REDESIGN-001·创始人专门会话) 
- 新增 brainstorm requirements(单一事实源):SLO地板@千元机+4G P75/预算入场券B1 gz≤350KB·raw≤1.5MB/工程增强层E1-E6;裁决语义=预算入场券·S2实测主考
- 重设计评审版 v1.1:四路尽调回填(LittleJS 8.0/Phaser 8.0/KAPLAY 6.5淘汰/自研+微库淘汰),D2引擎URL化交付铁律(HTTP+编译双缓存)
- 裁定回填:tech-decisions §1.1(自研壳退役→成品轻引擎+Runner v2,终裁待spike)+glossary/product-and-architecture词条+技术决策版横幅第4条
- 1.x手册挂横幅(add-game-template/runtime-and-multichannel/game-studio/.agent),双轨冻结期仍有效;历史spec不动
- 护城河话术三处措辞修:自研边界改'宿主控制层自研+渲染引擎用开源可替换',强化B0定调

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-06-11 17:51:16 +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