diff --git a/docs/design/architecture-v3.0.md b/docs/design/architecture-v3.0.md index 137a6ea..fd5e6e6 100644 --- a/docs/design/architecture-v3.0.md +++ b/docs/design/architecture-v3.0.md @@ -1424,20 +1424,54 @@ PRAGMA busy_timeout=5000 # 写锁等待 5s --- -## §21. T 阶段规划(T1~Tn) +## §21. T 阶段规划(T1~T8) -> 2026-05-28 新增。基于 architecture-v3.0 回溯 + v2.8-direction-notes 讨论话题 + §17 待实现项,规划后续迭代阶段。 +> 2026-05-28 新增,v3.0.1 更新。基于 architecture-v3.0 回溯 + v2.8-direction-notes 讨论话题 + §17/§19 待实现项 + 设计矛盾 + MEMORY/HEARTBEAT 遗留。 -### 21.1 T 阶段总览 +### 21.1 遗留问题完整清单(A/B/C/D 编号) -| 阶段 | 名称 | 状态 | 核心目标 | 涉及话题 | -|------|------|------|---------|----------| -| **T1** | 一致性回溯 + 清理 | ✅ 已完成 | architecture-v3.0 回溯 + BUG-22/OBS-25/OBS-26 修复 + 司马懿评审 | — | -| **T2** | Daemon 退化 + 持续指挥 | 📋 待开始 | 庞统持续在线 + 动态规划 + Daemon 角色退化 | 话题6(Daemon退化) | -| **T3** | Prompt 进化 + Handoff + 知识注入 | 📋 待开始 | Agent 自主决策 + 结构化交接 + 知识增强 | 话题2/3/4 | -| **T4** | 质量体系增强 | 📋 待开始 | 方案审查自动流程 + 审查协议注册表 + Runaway Guard | 话题5 + §17 #8/#9 | -| **T5** | 需求探索 + 主动汇报 | 📋 待开始 | 苏格拉底对话入口 + AI 自然语言推送 | §17 #1/#4 | -| **T6** | Mail 硬编码统一 | 📋 最后做 | mail_handler.py 收敛 / TaskType Pipeline | 话题1 | +> 2026-05-28 08:44 规划,来源于 architecture-v3.0.md §17/§19 + HEARTBEAT.md + MEMORY.md 三路汇总。 + +| # | 来源 | 问题 | 类型 | 优先级 | +|---|------|------|------|--------| +| A1 | §17.1 #2 | **动态规划**(活计划,全程可调) | PRD 核心差距 | P1 | +| A2 | §17.1 #3 | **持续指挥**(庞统全程在线) | PRD 核心差距 | P1 | +| A3 | §19.1 | **状态机矛盾**(v2.8 设计 vs 代码,以代码为准更新文档) | 设计矛盾 | ~~P1~~ ✅ T1 已解决 | +| A4 | §19.3 | **`_generate_title()` 绕过 Gateway** | Bug | ~~P1~~ ✅ T1 已保留,待替换本地 LLM | +| B1 | §17.1 #1 | **需求探索自动触发**(Skill 已有,缺 Daemon 触发机制) | PRD 差距 | P2 | +| B2 | §17.1 #4 | **主动汇报**(SSE 推原始事件,不是 AI 摘要) | PRD 差距 | P2 | +| B3 | §17.2 #8 | **方案审查自动流程**(reviews 表有,Daemon 不触发) | 设计未落地 | P2 | +| B4 | §17.2 #9 | **审查协议注册表**(review_protocols/ 不存在) | 设计未落地 | P2 | +| B5 | §17.2 #11 | **verification_commands**(Guardrail 验证脚本层) | 设计未落地 | P2 | +| B6 | §17.2 #14 | **prompt_templates 角色模板**(目录不存在) | 设计未落地 | P2 | +| B7 | §17.2 #15 | **CLI Schema 校验**(schemas/ 不存在) | 设计未落地 | P2 | +| B8 | MEMORY | **BUG-7** planning 暂停失败 | Bug | P2 | +| B9 | MEMORY | **BUG-8** cancel→resume 空图完成 | Bug | P2 | +| B10 | MEMORY | **P3 遗留** 404/4xx 响应码 | Bug | ~~P3~~ ✅ 已修复 | +| B11 | MEMORY | **v2.7 遗留** BUG-22/OBS-25/OBS-26 | P3 | ~~P3~~ ✅ T1 已修复 | +| C1 | §17.2 #10 | **对抗辩论模式** | 设计未落地 | P3 | +| C2 | §17.2 #12 | **Shadow Checkpoint**(git 自动 commit) | 设计未落地 | P3 | +| C3 | §17.2 #13 | **Skill 生命周期** | 设计未落地 | P3 | +| C4 | §17.1 #5 | **工具链集成** | PRD 差距 | P3 | +| C5 | §17.1 #6 | **经验闭环 IMPROVE** | PRD 差距 | P3 | +| C6 | §17.2 #16 | **per-provider 冷却** | 设计未落地 | P4 | +| D1 | HEARTBEAT | **v2.8 executor-prompt-design 漏洞**(3 个设计漏洞未修) | 设计暂停 | P3 | +| D2 | HEARTBEAT | **Pipeline 架构调研**(暂停,已废弃——不搞 Pipeline 框架) | 设计暂停 | ~~P3~~ 📦 已归档 | +| D3 | MEMORY | **M2 进程管理**(同步 vs 异步) | 待讨论 | P2 | +| D4 | MEMORY | **Agent 上下文膨胀** | 待讨论 | P2 | + +### 21.2 T 阶段总览 + +| 阶段 | 名称 | 状态 | 核心目标 | 编号 | +|------|------|------|---------|------| +| **T1** | 文档对齐 + Bug 清理 | ✅ 已完成 | 状态机文档对齐 + BUG-22/OBS-25/OBS-26 修复 + 司马懿评审 | A3, A4, B10, B11 | +| **T2** | 持续指挥 + 动态规划 | 📋 待开始 | 庞统持续在线 + 活计划 + Daemon 退化 | A1, A2 | +| **T3** | 主动汇报 + 需求探索触发 | 📋 待开始 | SSE 推 AI 摘要 + Daemon 自动触发需求探索 Skill | B1, B2 | +| **T4** | 审查体系完善 | 📋 待开始 | 方案审查自动流程 + 审查协议注册表 + verification_commands + 对抗辩论 | B3, B4, B5, C1 | +| **T5** | 上下文管理 | 📋 待开始 | prompt_templates + Prompt 进化 + Handoff + 知识注入 + CLI Schema + executor prompt 漏洞 + 上下文膨胀 | B6, B7, D1, D4 | +| **T6** | 进程管理 M2 | 📋 待开始 | 同步进程管理方案 + Shadow Checkpoint | D3, C2 | +| **T7** | 经验闭环 + Skill 体系 | 📋 待开始 | Skill 生命周期 + IMPROVE 阶段 | C3, C5 | +| **T8** | 工具链 + 冷却 + Mail 统一 | 📋 最后做 | 工具链集成 + per-provider 冷却 + Mail 硬编码统一 | C4, C6, 话题1 | ### 21.2 各阶段详细规划