auto-sync: 2026-05-27 22:39:44

docs/design/v2.8-direction-notes.md

@@ -371,11 +371,70 @@ v2.9 上线后，跑 5 个测试 task，观察不同 Agent（张飞/关羽/赵
 
 ---
 
-## 九、下一步
+## 九、PRD v3.0 对齐分析（2026-05-27 第三轮讨论）
 
-1. 🔜 Mail 独立（mail_handler.py）
-2. 🔜 Prompt 进化（改 SPAWN_PROMPT_TEMPLATE）
-3. 🔜 NAS 挂载路径修正
-4. 🔜 知识注入（复用 LLM Wiki index.md 检索）
-5. 🔜 Agent 进化（自主 claim + 间感知）
-6. 🔜 Daemon 简化（退化为投递员）
+### v3.0 四相循环
+
+| Phase | 谁参与 | AI 角色 | 当前实现状态 |
+|-------|--------|---------|------------|
+| Phase 1: 需求探索（苏格拉底对话） | 用户 + 庞统 | 帮用户发现需求 | ❌ 没有（用户直接创建任务） |
+| Phase 2: 动态规划（AI 规划 + 挑战） | 庞统 + 司马懿 + 用户 | 规划者 + 质量守门人 | ❌ 没有（无活的执行方案） |
+| Phase 3: 自主执行（Agent 协作群） | 所有 Agent + 庞统 | 执行者 + 指挥官 | ⚠️ 黑板 API 有，但 Agent 不主动读 |
+| Phase 4: 主动汇报（AI 推送） | 庞统 → 用户 | 汇报者 | ❌ 没有 |
+
+### v3.0 vs architecture-v2.6 的关键区别
+
+| 维度 | v2.6（中间版本） | v3.0（AI Native） |
+|------|-----------------|-------------------|
+| 谁拆解任务 | 庞统拆解成子任务写黑板 | **庞统动态规划，活的执行方案** |
+| 谁分配任务 | Daemon Router 按 task_type 匹配 | **庞统作为指挥官动态决定谁做** |
+| Agent 角色 | 被动执行（领活→执行→写回） | **自主协作，主动发起协作** |
+| 编排 | 确定性状态机 | **AI 感知全局→判断局势→决定下一步** |
+| 庞统 | 交完 plan 退场 | **全程在线，持续指挥** |
+
+### 对 executor.md 的影响
+
+executor.md 应面向 **v3.0 目标**设计，在 **v2.7 实现**上工作：
+
+- **流程步骤保留**（底层 ticker + dispatcher + spawner 短期不变）
+- **步骤 2 从"理解任务"→"感知上下文"**：读黑板全局状态、读其他 Agent 产出、理解在协作中的位置
+- **步骤 3 对齐 v3.0 自主协作**：不只是"执行任务"，而是主动发起协作、发现风险、甚至建议重新分配
+
+### v2.8 的定位
+
+v2.8 不是跳到 v3.0，而是在 v2.7 上**补齐关键缺失**，让 Agent 的行为模式从被动执行者朝自主协作者演进：
+
+| v2.8 做什么 | 对齐 v3.0 哪个能力 |
+|------------|-------------------|
+| 新建 executor.md（感知上下文 + 自主执行） | Phase 3 自主协作 |
+| 新建 reviewer.md（审查流程指引） | Phase 3 质量门禁 |
+| handoff 注入（Agent 间传递上下文） | Phase 3 共享意识 |
+| 知识注入（wiki summary） | Phase 3 能力增强 |
+
+**v3.0 的 Phase 1（需求探索）和 Phase 2（动态规划）是更大的系统级改动，不在 v2.8 范围内。**
+
+---
+
+## 十、下一步
+
+### v2.8 范围（Prompt 进化 + 补齐缺失）
+
+| # | 事项 | 文件 | 对齐 v3.0 |
+|---|------|------|----------|
+| 1 | 新建 executor.md | `prompt_templates/executor.md` | Phase 3 自主协作 |
+| 2 | 新建 reviewer.md | `prompt_templates/reviewer.md` | Phase 3 质量门禁 |
+| 3 | 增强 `_build_api_section()` | `src/daemon/spawner.py` | Phase 3 共享意识 |
+| 4 | 新建 handoff.schema.json | `schemas/handoff.schema.json` | Phase 3 共享意识 |
+| 5 | 增强 `_format_depends_on()` 读 handoff | `src/daemon/bootstrap.py` | Phase 3 共享意识 |
+| 6 | 知识注入 + 查询日志 | `spawner.py` + `bootstrap.py` | Phase 3 能力增强 |
+| 7 | Mail 独立 | 新建 `mail_handler.py` | 代码整理 |
+| 8 | review 前检查 output 非空 | `ticker.py` | Phase 3 质量门禁 |
+
+### v3.0 后续（不在 v2.8 范围）
+
+| Phase | 内容 | 前置条件 |
+|-------|------|---------|
+| Phase 1 | 需求探索（苏格拉底对话） | 庞统 Skill + 对话引擎 |
+| Phase 2 | 动态规划（活的执行方案） | Phase 1 + 持续指挥 |
+| Phase 3 完整 | 持续指挥官 + 自主 claim | Phase 2 + scope_declaration + Scope Guard |
+| Phase 4 | 主动汇报（AI 推送） | Phase 3 + 推送机制 |