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

10 KiB

Raw Blame History

agent-specs 活地图（_index）

✅ 2026-06-22 域化重构收尾(保守批):已归档 18 份「已迁入 docs/architecture/ 或纯留痕」的设计/过程档(git mv 进 _archive/,各带 SUPERSEDED tombstone 指新落点);顶层现仅剩正在演进的生成域设计链 + 待定档 + 本重构 2 档。下方 §1/§2 标「→ 新树」的子系统正本已在 architecture,本页相应条目仅留指针。收尾清单见 ../plans/2026-06-22-域化重构收尾清单.md。 ⚠️ 2026-06-20 设计文档域化重构:settled 子系统 canonical 已迁入 docs/architecture/ 6 域树(读那里即知现行,总索引 ../architecture/README.md);本 _index 降为 trace/spike 索引 + 生成域演进设计链(🚧 过渡期保留)。历史/决策史见 _archive/ + git。维护：波次收口按 .agents/skills/wave-close-checklist.md 第 8 步；命名/分层见 .agents/rules/engineering-conventions.md §10。 2026-06-17 双线重构：settled 7 域→canonical（Phase A·本 session，2026-06-17-agent-specs深度重构-plan.md）；生成域设计链收敛（他 session：固定架构 + 一题一活档规则）。两线已合入 dev/2.0.0。

1. 子系统 canonical（settled 域已迁入 `docs/architecture/` 域树)

以下 settled 子系统的 canonical 内容已重写并迁入 6 域树,读新树;原 agent-specs 档已归 _archive。

渠道发行 → ../architecture/运营/渠道发行.md
studio 前端设计体系 → ../architecture/前端/README.md
变现与单位经济 → ../architecture/运营/变现与单位经济.md
战略与合规 → 战略入 ../architecture/产品/商业定位.md · 合规入 ../architecture/运营/合规闸门.md

生成域现行真相（2026-06-22 · 两条生成线并存）：绘境AI 现有两条运行期解耦的游戏生成线——Tier0/1 廉价线（超休闲单局，SAA·Java 16 节点裸图 + LittleJS + 便宜模型 + 九门）与 tier2 自治富游戏线（合成/经营/挂机等多系统富游戏，AgentScope·Python 自治 ReAct + Phaser + 三层校验，独立 service、设计中待 0 号 spike 验证、尚未落代码）。两条线只在公共组件（计费/送审/feed/CDP 验收基线/源项目契约）交汇，按品类/复杂度分流；远期可能收敛为一条（廉价线并入 AgentScope）已登记、当前不做。两条线的产物终态都是 src/ 多文件源项目（改源不改包、重新构建）；廉价线现行实现仍用 gameDefinition（声明式 JSON 中间表示 + new Function）作通往 src/ 的中间脚手架/债（不是终态设计、绝非已移除，迁移 plan 2026-06-18-001 U1–U4 在飞）。Cocos 区分：tier2 半改 Phaser，但 Tier3/3D/渠道导出（人在环）仍保留 Cocos+MCP，未一刀切删。

生成域 canonical（🚧 过渡期保留为活档;现行真相权威活档已迁入新树 docs/architecture/架构/生成引擎/,读新树):

agentic编排-SAA.md（廉价线 SAA 编排）→ 新树 架构/生成引擎/SAA编排.md
tier2 富游戏线设计 → 新树 架构/生成引擎/自治富游戏引擎.md · 架构/生成引擎/tier2四层工程架构.md · 架构/生成引擎/tier2实现详设.md（agent-specs 侧无对应活档,直接读新树）
两线全景看图入口 → 新树 架构/生成引擎/生成引擎图说.md
开闸验收门-W-G1.md → 架构/生成引擎/验收门-W-G1.md
引擎与运行时.md → 架构/生成引擎/引擎与运行时.md
prompt治理体系-execution.md → 架构/生成引擎/prompt治理.md

2. 生成域（HJ-GEN-001 设计链 · 🚧 架构演进中 · 本 session 维护,在飞红线已解除 `1101d016`）

★ 协作总账（三 session 分权 · 派活/接手先读）

2026-06-17-多session分工与任务总账.md — 三阶段/两开发线/增量集成 + 角色分权（Mac 实现 / 6c6g 独立评审+真机验 / studio 前端）；取代 生成引擎-并行编排(模块切分版)

生成主线设计链（现行架构）

★ 生成主线架构演进路线.md — 生成主线“往哪走、先做什么”的单一 SoT（散文·待创始人评审）：把两条线合一——线 A 加固现有(trace 抽取/prompt 同源解 split-brain/模型外置/latch 终态语义 P0/cutover)+ 线 B 补 OpenGame 证明值钱的能力层(GDD 契约+template_api=最高价值/Debug Skill 落 diagnose-repair+checkpoint/Template Skill 按 gameDefinition 重写+入库过九门门/资产接 mmx);两处交汇点(品类独立交叉校验·player 软门做厚)已合并不重列;统一迁移序列对齐 plan-001/002/003 不另起。吸收并取代 _archive/2026-06-19-生成平台架构演进-review.md。承 agentic编排-SAA。
★ 2026-06-20-生成设计合理性-对抗审查裁决.md — 核心生成设计"合理吗"的对抗审查裁决(4 视角找天花板·逐条 file:line 核实·散文)：部分合理——地基(确定性受控面+九门自动验收)是真护城河该坚持;但名实不符(behavior.code 承载 100% 逻辑却没进契约、靠 additionalProperties 偷渡)+ 表达力硬编码焊在 4 类色块玩具(scenes 只取[0]/advance 空操作/渲染只色块/物理只 vx+gravity)+ 好玩好看无下限托底(assets 在 build 链零消费者)。它是 Tier0 可靠产线非通用范式;最大风险=拿它对标 demo 的 Marvel/KOF。四改:正名混合范式+愿景分层(Tier0 不碰复杂品类·创始人级决策)/逻辑往声明式拽回(behavior kind)/打通 assets 链/好玩从九门剥离。findings 待回灌 ↑路线。
2026-06-20-OpenGame对照分析与复刻缺口.md — 外部标杆 prior-art 参考 · OpenGame 真源码深读(复刻缺口已并入 ↑《生成主线架构演进路线》;本档供查 OpenGame 内部机理)：它靠 4 原子工具+六阶段 SOP(system-reminder 接力·无中央编排)+物理优先分类→GDD 契约→多模态资产→确定性贴图;我们 SAA 图比它命令式循环更确定,核心不落后;真缺 3 处=①约束厚度(template_api+GDD 契约·最高价值)②经验复利层(Template/Debug Skill)③资产线(走 mmx);它两卖点:27B 专训刻意不走;VLM Bench 代码其实没开源(只论文),单比已开源的九门已更硬,但九门只覆机制层(能不能跑),VLM 的意图/视觉那两轴对应我们偏弱的 player 软门、是待补强缺口,非已赢项。源码 clone 在 /root/oss/OpenGame。
2026-06-17-固定游戏架构与SAA-agentic-studio-execution.md — ACTIVE · 当前生成主线架构 execution（固定游戏架构=轻量声明式领域模型+2D 适配器 / SAA studio 9+1+1 agent / 8 契约 / 救场阶梯 / 缓存三段式；两 spike 已绿：缓存经 new-api 透传 76-93%、classify tickModel 100%）
2026-06-17-固定游戏架构与SAA-agentic-studio-review.md — 配套设计 review（含深析 §10 + 创始人决策；承原 v2 生命周期原则）
2026-06-12-游戏生成系统总体架构-review.md — 生成系统总体架构纲领（三级生成 / W-G0~G4 路线 / 意图矩阵）
2026-06-13-WG1-20经典轻游戏基准-review.md — W-G1 靶集 + 4 类缺口诊断
2026-06-16-生成引擎主线-传承与演进-review.md · 2026-06-16-生成引擎-任务清单普查.md · 2026-06-17-开闸-一句话入口接线-review.md
2026-06-09-generation-spike/ — C1 生成 spike 证据底座
2026-06-17-生成主线-游戏生命周期项目管理-review.md(v2)— ACTIVE · 范式基座(游戏=长生命周期源项目 / 改源不改包 / LLM as 工作室);固定架构 review 是其具体落地、header 链接它。
2026-06-17-生成主线-对话生成修改素材-review.md(v1)— 留痕(对话生成/改/素材设计;原"改包"前提已被 v2 改源不改包 supersede,内容入固定架构;保全不作现行 SoT)。

注:生成域 canonical 化现由本 session(6c6g 大脑线)维护(SAA 2026-06-18 交本 session 独管;在飞红线解除)——固定架构设计链 + agentic编排-SAA canonical 已 reconcile 反映双证地基(1101d016);后续按 agent-specs-canonical-structure 统一收敛。

3. KEEP（专项 SoT · 独立保留）

2026-06-15-SAA-能力API接入-dossier.md — SAA API/坑逐键源码证据底座（agentic编排-SAA.md §4 指向它）

4. 活工具箱 / spike（白名单保留）

2026-06-09-agent-loop-v1/orchestrator/ · 2026-06-09-generation-spike/ · 2026-06-12-channel-spike/ · 2026-06-11-tier1-engine-spike/ · 2026-06-10-模型评估矩阵/

5. 历史 / 治理留痕

_archive/ — 取证账本 / 收口报告 / 已死档（git 可查）。本次新归 10 档（settled 域源）+ 总账-波次史归档.md（总账 §6）+ 生成主线 v2（他 session）。
治理留痕：2026-06-16-agent-specs目录治理-review · 2026-06-17-文档整理-plan · 2026-06-17-agent-specs深度重构-plan

10 KiB Raw Blame History Unescape Escape