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

11 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
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
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
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
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