From 610bb8a3fb210e2e5c21a48968e9ce42dd3c79a3 Mon Sep 17 00:00:00 2001 From: cfdaily Date: Wed, 27 May 2026 22:39:44 +0800 Subject: [PATCH] auto-sync: 2026-05-27 22:39:44 --- docs/design/v2.8-direction-notes.md | 73 ++++++++++++++++++++++++++--- 1 file changed, 66 insertions(+), 7 deletions(-) diff --git a/docs/design/v2.8-direction-notes.md b/docs/design/v2.8-direction-notes.md index e3225f4..54c2c76 100644 --- a/docs/design/v2.8-direction-notes.md +++ b/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 + 推送机制 |