cfdaily
125 lines
7.9 KiB
Markdown
125 lines
7.9 KiB
Markdown
# 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 详细分析 | 部分覆盖 |
|