From 1d41e169a13399174b01f82d8b9739f3bcfabf10 Mon Sep 17 00:00:00 2001 From: cfdaily Date: Thu, 14 May 2026 12:03:27 +0800 Subject: [PATCH] auto-sync: 2026-05-14 12:03:27 --- docs/review/design-to-practices-mapping.md | 124 +++++++++++++++++++++ 1 file changed, 124 insertions(+) create mode 100644 docs/review/design-to-practices-mapping.md diff --git a/docs/review/design-to-practices-mapping.md b/docs/review/design-to-practices-mapping.md new file mode 100644 index 0000000..033703c --- /dev/null +++ b/docs/review/design-to-practices-mapping.md @@ -0,0 +1,124 @@ +# moziplus v2.0 设计决策 ← 优秀实践映射表 + +> 整理者：庞统 🐦 +> 日期：2026-05-14 +> 目的：清晰展示每个设计决策参考了哪些优秀实践的什么内容 + +--- + +## 一、核心架构决策 + +### 1. 共享意识空间（SQLite + 文件系统） + +| 设计内容 | 参考来源 | 具体借鉴 | +|---------|---------|---------| +| SQLite 存状态 + 文件系统存产出物 | **OpenAI Codex Cookbook** | PM Agent 写 REQUIREMENTS.md / AGENT_TASKS.md，产出物 gating check | +| moments.jsonl 原子事件流 | **Edict 朝堂议政** | MessageBus 消息总线设计 | +| decisions.jsonl 决策记录 | **Network-AI** | HMAC 链式审计日志（每条日志包含前一条的签名哈希） | +| 双存储同步（SQLite权威 + 文件缓存） | **Wanman** | per-agent workspace 隔离 + artifact.put CLI | +| atomic_write（tmp → rename） | **Network-AI** | 三阶段原子写入的简化版（propose→validate→commit → 直接 atomic write） | +| experience.md 经验蒸馏 | **Nuwa Skill（女娲）** | 五层蒸馏框架的简化版（取前两层：surface + heuristic） | + +### 2. 中央协调 + Agent 自主（v2.4 核心） + +| 设计内容 | 参考来源 | 具体借鉴 | +|---------|---------|---------| +| 三层自主模型（庞统定方向 → Agent 自主执行 → 共享空间连接） | **Edict 朝堂议政** | phaseMask 机制——每个 Agent 声明在哪些 phase 主动发言，不是被动等调度 | +| Agent 自主行为协议（感知→执行→观察） | **Ouroboros** | 后台意识循环 consciousness.py——Agent 不只是被动响应，而是主动思考 | +| Agent 可主动委派/建议 | **Open Multi-Agent** | sharedMemory + delegate_to_agent——Agent 可主动委派给其他 Agent | +| 观察写入 observations/ 供其他 Agent 感知 | **Network-AI** | Blackboard + CRDT——Agent 读黑板、看到变化、自己决定行动 | +| 庞统持续意识（定期推送执行摘要） | **Ouroboros** | 后台意识循环——任务间主动思考，不是被动等待调用 | +| 团队协作 pipeline（plan→prd→exec→verify→fix） | **oh-my-claudecode** | Team staged pipeline 模式 | +| Kanban 工单绑定 Agent | **Hermes Agent** | kanban_* 工具集 + dispatcher——Worker 通过专用工具集与 kanban board 交互 | +| Agent-first task board | **agent-kanban (saltbo)** | Agent 自主 claim task 的理念 | +| ticket-pod binding | **AgentsMesh** | 工单绑定 Agent 实例，进度追踪 | +| hub-spoke 协调 | **Claude Code Sub-Agent Collective** | task-orchestrator 作为路由枢纽，专业化 Agent 定义 | +| MCP 上下文共享 + A2A Agent 间通信 | **MCP + A2A 协议** | MCP 提供结构化上下文共享，A2A 提供 Agent 间直接通信 | + +### 3. Daemon 设计 + +| 设计内容 | 参考来源 | 具体借鉴 | +|---------|---------|---------| +| FastAPI + uvicorn + SQLite WAL | **v1.0 经验** | v1.0 已验证的 daemon 架构 | +| HTTP API 接口设计 | **Wanman** | 30+ JSON-RPC 方法 + 标准错误码体系 + Agent 零SDK CLI 模式 | +| Transactional Outbox Pattern | **Edict（三省六部）** | Redis Streams 消费者组 + 死信队列（我们简化为 SQLite events 表） | +| 长存活守护进程 | **Gstack** | 状态文件持久化 + 版本自动重启 | +| 分层事件总线 | **Multica** | 进程内同步事件（我们简化为 daemon 内直接调用） | + +### 4. Agent 调度 + +| 设计内容 | 参考来源 | 具体借鉴 | +|---------|---------|---------| +| `openclaw agent` CLI 封装 | **Claude Code** | claude CLI 的 sub-agent delegation via sidechain transcript | +| Agent 选择算法（能力匹配） | **Multi-Agent Blackboard System (arXiv:2510.01285)** | Agent 自主注册能力到黑板，按能力响应任务 | +| 主 session + sub-agent 双模式 | **Claude Code** | in-process teammate backend in swarm path | +| cleanup:delete 自动清理 | **Claude Code** | sub-agent isolation——独立上下文窗口防止交叉污染 | +| 执行历史归档（transcript → artifacts） | **Claude Code** | session linked by parent_session_id chains for compression | + +### 5. 质量治理 + +| 设计内容 | 参考来源 | 具体借鉴 | +|---------|---------|---------| +| 三重预算（token/时间/成本） | **Network-AI** | Token Budget（全局 + per-agent 双重预算控制） | +| 幻觉门控（产出验证） | **Hermes v0.13** | Agent 声称完成时验证产出是否真实存在 | +| 产出物 gating check | **OpenAI Codex Cookbook** | "Do not advance until required files are present" | +| 挑战循环（reviewing → challenge） | **Ouroboros** | 多模型自我评审——用其他 LLM 评审自己的变更 | +| 质量分级（critical/standard/exploratory） | **Deloitte 2026** | "human-on-the-loop"——人的参与密度随质量等级调整 | + +### 6. 状态机与配置化 + +| 设计内容 | 参考来源 | 具体借鉴 | +|---------|---------|---------| +| 状态机骨架 + AI 决策层 | **v1.0 经验** + **业界共识** | 可预测骨架 + LLM 动态填充（LangGraph/OpenAI/Google ADK） | +| YAML 配置化（states/events/exceptions） | **v1.0 教训** | v1.0 硬编码状态名导致 bug，v2.0 全部配置化 | +| 异常分类（确定性 + AI 处理未知） | **Hermes v0.13** | per-task 重试上限 + Worker 自动 block | + +### 7. 经验沉淀 + +| 设计内容 | 参考来源 | 具体借鉴 | +|---------|---------|---------| +| 两层蒸馏（surface + heuristic） | **Nuwa Skill（女娲）** | 五层蒸馏框架，取前两层先验证 | +| 经验生命周期（draft→verified→superseded→expired） | **Nuwa Skill** | 经验的时效性管理 | +| 经验检索（规划/执行/异常时注入） | **A-MEM (arXiv 2502.12110)** | Zettelkasten 式记忆，新记忆触发已有记忆的更新 | +| 闭环学习（DISCOVER→DISTILL→APPLY→IMPROVE） | **Wiki 知识管理体系** | 知识管理闭环模式 | +| Skill 自动改进 | **Hermes Agent** | skill_manage 使用中发现过时立即修复 | + +--- + +## 二、调研来源完整列表 + +| # | 来源 | 类型 | Wiki 是否已蒸馏 | +|---|------|------|---------------| +| 1 | Edict 朝堂议政 | 知识库 + Wiki | ✅ 有 practices，R4 补充 TurnScheduler 细节 | +| 2 | Ouroboros (joi-lab) | 知识库 + Wiki | ✅ 有 practices | +| 3 | Network-AI | 知识库 + Wiki | ✅ 有 practices | +| 4 | Open Multi-Agent | 知识库 + Wiki | ✅ 有 practices | +| 5 | oh-my-claudecode | 知识库 + Wiki | ✅ 有 practices | +| 6 | Hermes Agent | 知识库 + Wiki | ✅ 有 practices，R4 补充 kanban 细节 | +| 7 | Wanman | 知识库 + Wiki | ✅ 有 practices | +| 8 | Claude Code (leak + 分析) | 知识库 + Wiki | ✅ 有 practices | +| 9 | Nuwa Skill (女娲) | 知识库 + Wiki | ✅ 有 practices | +| 10 | A-MEM | Wiki | ✅ 有 practices | +| 11 | OpenAI Codex Cookbook | Wiki | ✅ 有 practices | +| 12 | Google ADK | 知识库 + Wiki | ✅ 有 practices | +| 13 | Gstack | 知识库 + Wiki | ✅ 有 practices | +| 14 | Multica | 知识库 + Wiki | ✅ 有 practices | +| 15 | agent-kanban (saltbo) | 网络调研 | ⏳ 新建中 | +| 16 | AgentsMesh | 网络调研 | ⏳ 新建中 | +| 17 | Operator (untra) | 网络调研 | ⏳ 新建中 | +| 18 | Claude Code Sub-Agent Collective | 网络调研 | ⏳ 新建中 | +| 19 | MCP + A2A 协议 | 网络调研 | ⏳ 新建中 | +| 20 | Multi-Agent Blackboard System (arXiv:2510.01285) | 网络调研 | ⏳ 新建中 | +| 21 | awesome-agent-orchestrators | 网络调研 | ⏳ 新建中 | +| 22 | Deloitte 2026 AI Agent 报告 | 网络调研 | ❌ 待蒸馏 | +| 23 | v1.0 经验教训 | 项目经验 | ✅ 在 MEMORY.md 中 | + +--- + +## 三、知识库 GAP（有知识库但未蒸馏到 Wiki） + +| 知识库目录 | Wiki 状态 | 影响 | +|-----------|----------|------| +| `edict/edict/朝堂议政_开发规格.md` | 有 practices 但缺 TurnScheduler/MessageBus 完整代码 | R4 sub-agent 正在补充 | +| `hermes-agent/AGENTS.md` | 有 practices 但缺 kanban 实现 | R4 sub-agent 正在补充 | +| `claude-code-leak/` 全套源码分析 | 有 practices 但缺 Grove/Swarm/Team 详细分析 | 部分覆盖 |