From ee55a2db6a66c5de8be716b406009aff5cd63e2d Mon Sep 17 00:00:00 2001 From: zizi Date: Wed, 17 Jun 2026 14:06:22 +0000 Subject: [PATCH] =?UTF-8?q?docs(merge):=20=5Findex=20=E5=90=88=E5=B9=B6?= =?UTF-8?q?=E2=80=94=E2=80=94settled=20canonical(=E6=9C=ACsession=20Phase?= =?UTF-8?q?=20A)=20+=20=E7=94=9F=E6=88=90=E5=9F=9F=E8=AE=BE=E8=AE=A1?= =?UTF-8?q?=E9=93=BE(=E4=BB=96session=20=E5=9B=BA=E5=AE=9A=E6=9E=B6?= =?UTF-8?q?=E6=9E=84)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit cherry-pick 本 session 4 提交(深度重构 Phase A + 增量整理)到 origin(他 session 生成域设计链已先落); _index 合并双线:settled 7 域=canonical 活档 / 生成域=固定架构设计链;两线文件零冲突共存。 Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/agent-specs/_index.md | 69 +++++++++++++++++--------------------- 1 file changed, 31 insertions(+), 38 deletions(-) diff --git a/docs/agent-specs/_index.md b/docs/agent-specs/_index.md index 2b34a549..86186409 100644 --- a/docs/agent-specs/_index.md +++ b/docs/agent-specs/_index.md @@ -1,59 +1,52 @@ # agent-specs 活地图（_index） -> **用途**：本目录的单一导航。**每子系统一份 canonical 档 = 该域 SoT，读它即知现行真相**；历史/决策史见 `_archive/` + git。 -> **维护**：波次收口按 [`.agents/skills/wave-close-checklist.md`](../../.agents/skills/wave-close-checklist.md) 第 8 步；命名/分层规范见 [`.agents/rules/engineering-conventions.md`](../../.agents/rules/engineering-conventions.md) §10。 -> **2026-06-17 深度重构**：42 流水档（review/execution/verdict/report）→ 子系统 canonical（计划+评审留痕见 [`2026-06-17-agent-specs深度重构-plan.md`](2026-06-17-agent-specs深度重构-plan.md)）。 +> **用途**：本目录单一导航。**settled 子系统 = canonical 活档**(一域一档·无日期·SoT,读它即知现行)；**生成域 = 设计链**(固定架构+SAA studio，他 session 收敛中)；历史/决策史见 `_archive/` + git。 +> **维护**：波次收口按 [`.agents/skills/wave-close-checklist.md`](../../.agents/skills/wave-close-checklist.md) 第 8 步；命名/分层见 [`.agents/rules/engineering-conventions.md`](../../.agents/rules/engineering-conventions.md) §10。 +> **2026-06-17 双线重构**：settled 7 域→canonical（Phase A·本 session，[`2026-06-17-agent-specs深度重构-plan.md`](2026-06-17-agent-specs深度重构-plan.md)）；生成域设计链收敛（他 session：固定架构 + 一题一活档规则）。两线已合入 dev/2.0.0。 --- -## 1. canonical 活档（子系统 SoT · 一域一档 · 读它即知现行） +## 1. canonical 活档（settled 子系统 SoT · 一域一档 · 读它即知现行） -### 生成域 -- [`agentic编排-SAA.md`](agentic编排-SAA.md) — HJ-AGI-002 SAA 裸图 StateGraph 编排基建（架构/六不变量/split-brain 铁律/orchestrator 边界/现状） +- [`agentic编排-SAA.md`](agentic编排-SAA.md) — HJ-AGI-002 SAA 裸图 StateGraph 编排基建（架构/六不变量/split-brain 铁律/orchestrator 边界） - [`开闸验收门-W-G1.md`](开闸验收门-W-G1.md) — 一句话生成对外开闸 6 门（组A 控制平面+GP9 / 组B 落库 / 组C 首局门 / G0G1 前置） +- [`引擎与运行时.md`](引擎与运行时.md) — LittleJS 增强发行版（55KB gz，06-12 终裁）+ Runner v2 两层装载契约 + engineBundle 内嵌；含★模板术语纠偏 +- [`渠道发行.md`](渠道发行.md) — HJ-CH-001（一壳多游 L1 / L2 不上渠道 / 合规闸门 / 引擎竞标 C-A vs C-B） +- [`studio前端设计体系.md`](studio前端设计体系.md) — HJ-FE-DS-001（token 两层 / i18n 双语 / 三主题 / 创始人 5 决议） +- [`变现与单位经济.md`](变现与单位经济.md) — 收益闭环④ + new-api 成本源 + 单位经济模型 + 资金一致性红线 +- [`战略与合规.md`](战略与合规.md) — 四雷 R1-R4 / 三线变现 / 合规闸门（指 A1 看板）/ demo 定位纠偏（HJ-DEMO-AUDIT-001） - [`prompt治理体系-execution.md`](prompt治理体系-execution.md) — Prompt 第 8 契约（Registry / load-inject / 门禁 / HITL） -- ⏳ **Phase B 待建**：`生成主线.md`、`固定架构与SAA-agentic-studio.md`（含他 session 06-17 在飞 WIP，待其落定/授权后收敛，见 §3） - -### 引擎 / 运行时 -- [`引擎与运行时.md`](引擎与运行时.md) — LittleJS 增强发行版（55KB gz，2026-06-12 终裁）+ Runner v2 两层装载契约 + engineBundle 内嵌交付 + 能力边界；含★模板术语纠偏 - -### 渠道发行 -- [`渠道发行.md`](渠道发行.md) — HJ-CH-001（一壳多游 L1 / L2 不上渠道 / 合规闸门 / Channel Runner v1 / 引擎竞标 C-A vs C-B） - -### 前端 -- [`studio前端设计体系.md`](studio前端设计体系.md) — HJ-FE-DS-001（token 两层 / i18n 双语 / 三主题 / 创始人 5 决议 / vs demo 勿误砍） - -### 变现 / 战略 -- [`变现与单位经济.md`](变现与单位经济.md) — 收益闭环④（广告→分账→钱包→提现）+ new-api 成本源 + 单位经济模型 + 资金一致性红线 -- [`战略与合规.md`](战略与合规.md) — 四雷 R1-R4 / 三线变现排序 / 合规闸门（指 A1 看板）/ 经济模型 / demo 定位纠偏（HJ-DEMO-AUDIT-001） - -### 跨线 -- ⏳ **Phase B 待建**：`产品路线图与协作.md`（三阶段/完成度/多session 协作；含 `多session总账` WIP，见 §3） --- -## 2. KEEP（专项 SoT · 独立保留，不折叠） -- [`2026-06-15-SAA-能力API接入-dossier.md`](2026-06-15-SAA-能力API接入-dossier.md) — SAA API/坑 逐键源码证据底座（比 skill 深一层；`agentic编排-SAA.md` §4 指向它） +## 2. 生成域（HJ-GEN-001 设计链 · 他 session 收敛中） + +### ★ 协作总账（三 session 分权 · 派活/接手先读） +- `2026-06-17-多session分工与任务总账.md` — 三阶段/两开发线/增量集成 + 角色分权（Mac 实现 / 6c6g 独立评审+真机验 / studio 前端）；取代 `生成引擎-并行编排`(模块切分版) + +### 生成主线设计链（现行架构） +- `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 证据底座 +- ↳ **一题一活档收敛（他 session，2026-06-17）**：`对话生成修改素材-review`(v1) 已删（前提证伪）、`生命周期项目管理-review`(v2) 已折入固定架构 + 归档 `_archive/` + +> 注：生成域的 canonical 化由他 session 以「固定架构设计链」推进（与本 session settled 域 canonical 互补）；后续按 [[agent-specs-canonical-structure]] 统一收敛。 --- -## 3. Phase B 待重构（生成域 · 含他 session 06-17 在飞 WIP — 红线不擅动，待其落定/创始人授权后收敛） - -> 这些档暂留原状；其活内容将在 Phase B 蒸馏入 `生成主线.md` / `固定架构与SAA-agentic-studio.md` / `产品路线图与协作.md`。 - -- **生成主线簇**：`2026-06-12-游戏生成系统总体架构-review` · `2026-06-13-WG1-20经典轻游戏基准-review` · `2026-06-16-生成引擎主线-传承与演进-review` · `2026-06-16-生成引擎-任务清单普查` · `2026-06-16-生成引擎-并行编排`(桩) · `2026-06-17-开闸-一句话入口接线-review` · `2026-06-17-生成主线-对话生成修改素材-review`(⚠WIP·已被生命周期v2 supersede) · `2026-06-17-生成主线-游戏生命周期项目管理-review`(⚠WIP) -- **固定架构簇**：`2026-06-17-固定架构与SAA-agentic-studio-review` + `-execution`（⚠WIP·他 session 设计中） -- **产品路线图簇**：`2026-06-16-产品开发路线图-review` · `2026-06-17-产品功能与技术模块-完成度与优先级总账` · `2026-06-17-多session分工与任务总账`(⚠WIP·被重写) +## 3. KEEP（专项 SoT · 独立保留） +- [`2026-06-15-SAA-能力API接入-dossier.md`](2026-06-15-SAA-能力API接入-dossier.md) — SAA API/坑 逐键源码证据底座（`agentic编排-SAA.md` §4 指向它） --- -## 4. 活工具箱 / spike（白名单保留 · 非 canonical 但活） -- `2026-06-09-agent-loop-v1/orchestrator/` — QA 批跑编排器 + `newapi_cost.py` + CDP harness（被多处活资产引用；建议长期迁 `tools/`） -- `2026-06-09-generation-spike/` · `2026-06-12-channel-spike/` — 可复现 spike 证据 -- `2026-06-11-tier1-engine-spike/` · `2026-06-10-模型评估矩阵/` · `2026-06-11-前端接线创作链路UI走查/`(report.md) — 已瘦身证据 +## 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 档 + `总账-波次史归档.md`（总账 §6 整段）。 -- 治理留痕：`2026-06-16-agent-specs目录治理-review`（首轮治理 + 全量分类附录）· `2026-06-17-文档整理-plan`（增量轮）· `2026-06-17-agent-specs深度重构-plan`（本轮深度重构） +- `_archive/` — 取证账本 / 收口报告 / 已死档（git 可查）。本次新归 10 档（settled 域源）+ `总账-波次史归档.md`（总账 §6）+ 生成主线 v2（他 session）。 +- 治理留痕：`2026-06-16-agent-specs目录治理-review` · `2026-06-17-文档整理-plan` · `2026-06-17-agent-specs深度重构-plan`