From 65598b9886c2a00045664651c5d4b707af44dcac Mon Sep 17 00:00:00 2001
From: Linghong <ink29535@proton.me>
Date: Tue, 15 Sep 2026 04:41:05 +0000
Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E9=80=80=E5=BD=B9=E7=AD=96?=
 =?UTF-8?q?=E5=88=92Agent=E8=A7=A3=E8=80=A6=E6=B8=85=E7=90=86=E8=AE=A1?=
 =?UTF-8?q?=E5=88=92?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增退役策划 Agent V1/V2 解耦清理里程碑规范

新增分提交实施计划、修改边界与验收命令

明确不主动清理做游戏 Supervisor 与 16 Agent DAG
---
 ...��划】退役策划Agent V1V2解耦清理-2026-09-15.md | 91 +++++++++++++++++++
 ...�碑】退役策划Agent V1V2解耦清理-2026-09-15.md | 48 ++++++++++
 2 files changed, 139 insertions(+)
 create mode 100644 docs/project-memory/plans/【实施计划】退役策划Agent V1V2解耦清理-2026-09-15.md
 create mode 100644 docs/project-memory/plans/【里程碑】退役策划Agent V1V2解耦清理-2026-09-15.md

diff --git a/docs/project-memory/plans/【实施计划】退役策划Agent V1V2解耦清理-2026-09-15.md b/docs/project-memory/plans/【实施计划】退役策划Agent V1V2解耦清理-2026-09-15.md
new file mode 100644
index 000000000..5fadbf66a
--- /dev/null
+++ b/docs/project-memory/plans/【实施计划】退役策划Agent V1V2解耦清理-2026-09-15.md	
@@ -0,0 +1,91 @@
+# 【实施计划】退役策划 Agent V1/V2 解耦清理
+
+| 字段 | 值 |
+| --- | --- |
+| Milestone | `docs/project-memory/plans/【里程碑】退役策划Agent V1V2解耦清理-2026-09-15.md` |
+| Status | ready |
+| Owner | Codex |
+
+## 一句话交付结果
+
+删除退役策划 V1/V2 的现役前端残留，让当前 Design Agent 独立运行并恢复仓库编译，同时不主动清理做游戏 Supervisor + 16 Agent DAG。
+
+## 验收判据
+
+当前分支能够通过 AGC 前端 typecheck 和受影响定向测试；Design Agent 的新建、恢复、澄清、阶段审批和 reasoning 展示仍由当前 Design Agent 链路完成；旧 V2 IPC、旧 GDD 类型和旧前端测试契约不再存在。
+
+## 修改边界
+
+允许修改：
+
+- `apps/ai-game-creator-shell/src/App.tsx` 中旧 V2 状态、helper、IPC 分支和旧 UI props。
+- `apps/ai-game-creator-shell/src/app/types.ts` 中旧 GDD 类型。
+- `apps/ai-game-creator-shell/src/features/project-workspace/planningSessionV2.ts` 及其直接调用方。
+- `apps/ai-game-creator-shell/tests/appSurface/harness.ts`、`home.suite.ts`、旧策划事件测试。
+- `apps/ai-game-creator-shell/src/styles.css` 中只属于旧 Plan GDD / planning lane 的样式。
+- 没有现役调用方的旧策划身份 fixture、注释和文档索引。
+- 为通过编译所需的最小共享残留删除或改名。
+
+明确不修改：
+
+- `directCodex` 主链路。
+- Supervisor + 16 Agent DAG、`supervisor-swarm` 测试和通用 Runtime 编排。
+- 当前 Design Agent Rust runtime、Design Agent 资源包和 Design Agent IPC 协议。
+- 公开 API、SpacetimeDB schema、迁移和历史持久化数据格式。
+
+## 实现顺序与提交拆分
+
+### 提交一：解耦 Design Agent 状态命名
+
+- 将新版 Design Agent 实际使用的 `planningV2*` transient reply、reasoning、active ref 和相关 lane 控制改成 Design Agent 专属状态。
+- 保持行为不变，不删除旧 V2 会话代码。
+- 验证：AGC typecheck、`git diff --check`。
+
+### 提交二：删除 App 旧 V2 会话控制流
+
+- 删除旧 V2 session/GDD 状态和 helper。
+- 删除项目打开、消息发送、问询回答、审批和旧流式事件分支。
+- 将“做方案”只连接到当前 Design Agent hydrate/continue/decide 路径。
+- 保留 `planningStartMode` 作为入口路由字段，避免无关扩大重命名。
+- 验证：AGC typecheck；必要时运行 App 启动相关定向 suite。
+
+### 提交三：删除旧 TypeScript 适配层和类型
+
+- 删除 `planningSessionV2.ts`。
+- 删除 `PlanGddDecisionAction`、`PlanGddStateViewV1` 及所有直接导入。
+- 重新执行旧符号检索，确认没有残留调用方。
+- 验证：AGC typecheck、`npm run check:encoding`、`git diff --check`。
+
+### 提交四：清理测试、事件契约和 CSS
+
+- 精确删除 harness 中旧 V2/GDD 工厂、mock、调用记录和导出。
+- 精确删除首页 suite 中旧 V2 IPC 断言。
+- 删除旧 `planning-session-v2-stream` 事件测试。
+- 删除 Plan GDD、GDD 审批卡和 planning lane 专属 CSS 及过时说明。
+- 验证：appSurface 定向测试、事件订阅定向测试、AGC typecheck、编码和 diff 检查。
+
+### 提交五：收口确定失效的身份残留和文档入口
+
+- 只处理因 V1/V2 退役而确定失效的旧身份展示、测试 fixture、注释和文档索引。
+- 不扫描或重构做游戏 DAG；共享代码只在其旧策划用途已确定死且删除能直接解决编译/测试问题时处理。
+- 验证：旧策划符号定向检索、相关测试、编码和 diff 检查。
+
+## 验证命令
+
+1. `npm --prefix apps/ai-game-creator-shell run typecheck`
+2. `npm run check:encoding`
+3. `git diff --check`
+4. `npm --prefix apps/ai-game-creator-shell exec vitest run tests/appSurface.test.ts`
+5. 受影响 Rust 文件变化后运行 `cargo check --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml`
+6. 完成全部提交后再次执行旧策划符号检索，并核对 `git status` 与提交边界
+
+## 风险与回滚点
+
+- 最大风险是新版 Design Agent 复用了旧变量名；必须先完成提交一，再删除旧 helper。
+- `ProjectSupervisorView` 已经移除旧 GDD props，App 传参残留会在提交二中一并删除。
+- 测试 harness 同时服务通用总控和 Design Agent，必须局部删除旧 mock，不能整段重写。
+- 若某次提交导致 Design Agent 测试失败，只回滚该独立提交，不恢复旧 V2 兼容层。
+
+## 完成后的临时文档处理
+
+全部里程碑验收通过后，删除本里程碑和实施计划两份临时文档；把仍然有效的长期边界同步回现行 Design Agent 技术方案和项目记忆，不保留阶段性提交步骤。
diff --git a/docs/project-memory/plans/【里程碑】退役策划Agent V1V2解耦清理-2026-09-15.md b/docs/project-memory/plans/【里程碑】退役策划Agent V1V2解耦清理-2026-09-15.md
new file mode 100644
index 000000000..0ed7d1b98
--- /dev/null
+++ b/docs/project-memory/plans/【里程碑】退役策划Agent V1V2解耦清理-2026-09-15.md	
@@ -0,0 +1,48 @@
+# 【里程碑】退役策划 Agent V1/V2 解耦清理
+
+| 字段 | 值 |
+| --- | --- |
+| Version | 1.0 |
+| Status | proposed |
+| Date | 2026-09-15 |
+| Parent Spec | `docs/technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md` |
+
+## 目标
+
+移除旧版策划 Agent V1、V2 的前端会话、审批、数据适配、测试契约和确定失效的展示残留，使“做方案”只使用当前 Design Agent 会话；删除过程中产生的编译失败和过时测试同步修复。
+
+## 范围
+
+- 解除当前 Design Agent 与旧 `planningV2` / `PlanGdd` 状态命名和控制流的耦合。
+- 删除旧 V2 会话 hydrate、start、continue、审批和用户问询分支。
+- 删除旧 V2 TypeScript 会话适配层、旧 GDD 前端类型、测试 mock、旧事件契约和专属样式。
+- 清理确定没有现役调用方的旧策划身份说明、测试 fixture 和文档当前入口。
+- 保留当前 Design Agent 的会话、澄清、阶段审批、工作区浏览和 reasoning 展示行为。
+
+## 不在范围内
+
+- 不主动扫描、重构或整体删除做游戏 Agent 的 Supervisor + 16 Agent DAG。
+- 不删除 DirectCodex、通用 Runtime、delegation、acceptance graph、static delivery 或 supervisor-swarm 验收链路。
+- 不为旧项目新增兼容层、迁移器、墓碑注释或退役行为测试。
+- 不修改 SpacetimeDB schema、公开 API、持久化迁移和现役 Design Agent 协议。
+
+## 依赖与前置条件
+
+- PR #159 的合并提交 `3d8e0211` 代表旧 Fast GDD / 策划 V1 的引入。
+- PR #305 的合并提交 `04128eb6` 同时包含 V1 大范围退役、策划 V2 会话链路和后续 Design Agent 迁移。
+- 当前分支已经删除 Rust V1/V2 Runtime 模块和旧审批组件，但前端仍残留旧 V2 调用方；实现前须保持工作树干净。
+
+## 验收标准
+
+- [ ] “做方案”入口和已有 Design Agent 项目只调用当前 Design Agent IPC，不再调用旧 `planning_*_v2` IPC。
+- [ ] 当前 Design Agent 的消息、reasoning、澄清、阶段审批和重试行为不依赖旧 V2 状态变量。
+- [ ] 源码中不再存在旧 V2 TypeScript 会话适配层、旧 `PlanGdd` 类型和旧前端审批契约。
+- [ ] 旧前端测试、事件测试和样式残留被删除或改为当前 Design Agent 契约。
+- [ ] 不主动修改做游戏 Supervisor + 16 Agent DAG；因共享退役代码删除产生的编译错误得到最小修复。
+- [ ] 前端 typecheck、相关定向测试、编码检查和 diff 检查通过；触及 Rust 时对应 cargo check 通过。
+
+## 证据要求
+
+- 自动化：`npm --prefix apps/ai-game-creator-shell run typecheck`、相关 appSurface 定向测试、`npm run check:encoding`、`git diff --check`。
+- 运行时：至少验证“做方案”新项目进入 Design Agent、已有 Design Agent 会话恢复、澄清/审批回合可继续。
+- 边界：确认 DirectCodex 和做游戏既有入口未被旧策划清理改动；确认旧 V2 IPC 字符串和旧事件契约不再进入现役前端。