7bd9cd05e6
设计文档域化重构总收口: - §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>
7.6 KiB
7.6 KiB
agent-specs 活地图（_index）
⚠️ 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
生成域 canonical（🚧 过渡期保留为活档;新树对应子档亦在演进):
agentic编排-SAA.md→ 新树架构/生成引擎/SAA编排.md开闸验收门-W-G1.md→架构/生成引擎/验收门-W-G1.md引擎与运行时.md→架构/生成引擎/引擎与运行时.mdprompt治理体系-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.md2026-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