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