diff --git a/docs/design/architecture-v3.0.md b/docs/design/architecture-v3.0.md index e796f5e..c3cdeb3 100644 --- a/docs/design/architecture-v3.0.md +++ b/docs/design/architecture-v3.0.md @@ -1420,3 +1420,168 @@ PRAGMA busy_timeout=5000 # 写锁等待 5s **总计**: ✅ 已实现 25 项 | ⚠️ 部分实现 8 项 | ❌ 未实现 12 项 > 上述数据经 2026-05-28 用户复查 + 司马懿评审修正。广播认领从未实现移至已实现。 + +--- + +## §21. T 阶段规划(T1~Tn) + +> 2026-05-28 新增。基于 architecture-v3.0 回溯 + v2.8-direction-notes 讨论话题 + §17 待实现项,规划后续迭代阶段。 + +### 21.1 T 阶段总览 + +| 阶段 | 名称 | 状态 | 核心目标 | 涉及话题 | +|------|------|------|---------|----------| +| **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 | + +### 21.2 各阶段详细规划 + +#### T1: 一致性回溯 + 清理 ✅ 已完成 + +**周期**: 2026-05-27 ~ 2026-05-28 + +**完成内容**: +- ✅ architecture-v3.0.md 回溯性架构文档(20 章节,58KB) +- ✅ 7 条分类原则逐项审查 +- ✅ BUG-22: `list_mail` 的 `from` 过滤改为 SQL WHERE +- ✅ OBS-25: `send_mail` 的 `from` 统一用 `assigned_by` +- ✅ OBS-26: polling 时 Mail Tab 加载修复 +- ✅ 广播认领从"未实现"纠正为"已实现"(司马懿评审纠正) +- ✅ 5 个设计矛盾逐个解决 +- ✅ §17 待实现项分级(P1~P4) +- ✅ Gateway Watchdog 设计 + 部署 +- ✅ 司马懿评审通过 + +#### T2: Daemon 退化 + 持续指挥 📋 待开始 + +**核心目标**:庞统从"被动 delegate"变为"持续在线指挥官" + +**对应 PRD**:B2(编排层是 AI 指挥官)、C3(持续指挥)、C2(动态规划) + +**关键变更**: +1. 庞统持续指挥 session(当前只在 delegate 时被 spawn,无持续 session) +2. 动态规划(活的执行方案,全程可调) +3. Daemon 角色退化(从调度器 → 投递员 + 看护人) +4. Agent 自主决策(读黑板 → 想 → 干 → 写回) + +**涉及文件**: `src/daemon/ticker.py`、`src/daemon/dispatcher.py`、`src/daemon/router.py` + +**前置条件**: T1 完成 ✅ + +**对应待实现项**: §17 #2(动态规划)、§17 #3(持续指挥) + +**对应设计方向**: §6.5(Daemon 退化 + Agent 进化) + +**来源**: v2.8-direction-notes §一~§二 + +#### T3: Prompt 进化 + Handoff + 知识注入 📋 待开始 + +**核心目标**:让 Agent 拥有自主决策的 prompt + 结构化交接能力 + 领域知识 + +**对应 PRD**:B3(共享意识)、C6(上下文管理) + +**关键变更**: +1. Prompt 进化:从固定步骤 → "身份 + 目标 + 能做什么 + 约束 + 交接责任"(§10.4) +2. Handoff 上下文:新建 `schemas/handoff.schema.json` + bootstrap 增强(§10.5) +3. 知识注入:spawner 新增 `_inject_wiki_knowledge()`(§10.6) +4. 新建 `prompt_templates/executor.md`、`reviewer.md` + +**涉及文件**: `src/daemon/spawner.py`、`src/daemon/bootstrap.py`、`schemas/`(新建) + +**前置条件**: T2 完成(Prompt 进化依赖 Daemon 退化方向确定) + +**对应待实现项**: §17 #14(prompt_templates) + +**对应设计方向**: §10.4(Prompt 进化)、§10.5(Handoff)、§10.6(知识注入) + +**来源**: v2.8-direction-notes §三(2)(3)(4) + §六 + +#### T4: 质量体系增强 📋 待开始 + +**核心目标**:补齐质量门控的自动化环节 + +**对应 PRD**:C4(质量门禁)、C9(安全红线) + +**关键变更**: +1. Runaway Guard:per-task max_ticks + 超限暂停告警(§14.3) +2. 方案审查自动流程:reviews 表支持 plan_review,但 Daemon 不自动触发(§17 #8) +3. 审查协议注册表:review_protocols/ 目录创建(§17 #9) +4. verification_commands:验证脚本层(§17 #11) + +**涉及文件**: `src/daemon/ticker.py`、`src/daemon/review.py`、`review_protocols/`(新建) + +**前置条件**: T3 完成 + +**对应待实现项**: §17 #8/#9/#11、§14.3 + +**来源**: v2.8-direction-notes §三(5) + §17 + +#### T5: 需求探索 + 主动汇报 📋 待开始 + +**核心目标**:补齐 PRD 四相循环的 Phase 1 和 Phase 4 + +**对应 PRD**:B1(AI 帮人想清楚要什么)、B4(主动汇报)、C1/C7 + +**关键变更**: +1. 需求探索自动触发:Skill 已有(requirement-clarification + requirements-analysis),缺 Daemon 自动触发机制(§17 #1) +2. 主动汇报 AI 摘要:SSE 推送已有,但推送原始事件,不是 AI 自然语言摘要(§17 #4) +3. Dashboard AI Native 化:§11.3 + +**涉及文件**: `src/daemon/ticker.py`、`src/daemon/sse.py`、前端 + +**前置条件**: T2 完成 + +**对应待实现项**: §17 #1、§17 #4 + +#### T6: Mail 硬编码统一 📋 最后做 + +**核心目标**:消除 `_mail` 硬编码,收敛 Mail 特殊逻辑 + +**设计方向**(两种可选): +- **方案 A**:新建 `mail_handler.py`,集中 Mail 投递逻辑(~100 行新建 + ~30 行替换),纯代码整理 +- **方案 B**:TaskType Pipeline(策略模式),`MailPipeline` 类,更大规模重构 + +**决策**: 最后做,等其他专题稳定后再统一解决。优先方案 A(简单收敛),如果 T2~T5 中引入了更多 Task 类型再考虑方案 B。 + +**涉及文件**: `src/daemon/dispatcher.py`、`src/daemon/spawner.py`、`src/api/blackboard_routes.py` + +**前置条件**: T2~T5 完成(等稳定后再动) + +**对应设计矛盾**: §19.5 + +**来源**: v2.8-direction-notes §三(1) + +### 21.3 话题与 T 阶段映射 + +| 话题 | T 阶段 | 状态 | +|------|--------|------| +| 话题1: Mail 硬编码独立 | **T6**(最后做) | ❌ 未实施 | +| 话题2: Prompt 进化 | **T3** | ❌ 未实施 | +| 话题3: Handoff 上下文 | **T3** | ❌ 未实施 | +| 话题4: 知识注入 | **T3** | ❌ 未实施 | +| 话题5: Runaway Guard | **T4** | ⚠️ 部分实现 | +| 话题6: Daemon 退化 + Agent 进化 | **T2** | ❌ 未实施 | + +### 21.4 待实现项与 T 阶段映射 + +| §17 # | 待实现项 | T 阶段 | +|--------|---------|--------| +| 1 | 需求探索自动触发 | T5 | +| 2 | 动态规划 | T2 | +| 3 | 持续指挥 | T2 | +| 4 | 主动汇报 AI 摘要 | T5 | +| 5 | 工具链集成 | T5+(远期) | +| 6 | 经验闭环 IMPROVE | T4 | +| 8 | 方案审查自动流程 | T4 | +| 9 | 审查协议注册表 | T4 | +| 10 | 对抗辩论模式 | T5+(远期) | +| 11 | verification_commands | T4 | +| 12 | Shadow Checkpoint | T5+(远期) | +| 13 | Skill 生命周期 | T5+(远期) | +| 14 | prompt_templates 角色模板 | T3 | +| 15 | CLI Schema 校验 | T4 | +| 16 | per-provider 冷却 | P4 低优 |