# 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 详细分析 | 部分覆盖 |
