docs(shared): 三省六部 Edict 多 Agent 架构分析

docs/shared/edict-three-ministries.md

@@ -0,0 +1,98 @@
+# 三省六部 · Edict — 多 Agent 协作架构分析
+
+## 概述
+
+[三省六部 · Edict](https://github.com/Yazeo11/openclaw) 是一个基于 OpenClaw 的多 Agent 协作框架（6.9k+ Stars），用唐朝官制设计 AI 工作流。12 个 Agent 各司其职，核心亮点是**制度性审核**、**实时看板**和**完全可审计**。
+
+## 架构
+
+```
+皇上(你) → 太子(分拣) → 中书省(规划) → 门下省(审核/封驳) → 尚书省(派发) → 六部(并行执行) → 奏折(回报)
+```
+
+| 角色 | 职责 | 类比我们的 |
+|------|------|-----------|
+| 太子 | 消息分拣：闲聊直接回，正式任务才建流程 | AGENTS.md 里的"队长判断" |
+| 中书省 | 接旨 → 规划 → 拆解子任务 | 协调者拆任务 |
+| 门下省 | **专职审核，不合格直接封驳打回** | 我们没有独立审核层 |
+| 尚书省 | 任务派发到具体执行部门 | subagent 调度 |
+| 六部 | 户/礼/兵/刑/工/吏，各有专精 Skills | coding agent + 各种工具 |
+| 吏部 | Agent 管理、健康监控 | 无对应 |
+
+## 核心亮点
+
+### 1. 门下省封驳（最大差异化）
+
+独立的审核 Agent，**每个方案必须经过门下省**，没有例外：
+
+- 审查中书省的规划是否完备
+- 子任务拆解是否合理
+- 不合格 → 封驳打回重做
+- 强制返工循环直到达标
+
+对比其他框架：CrewAI/AutoGen/MetaGPT 都没有制度性审核。
+
+### 2. 军机处看板（10 个功能面板）
+
+- **旨意看板** — Kanban 列式展示，支持过滤/搜索/操作
+- **省部调度** — Agent 健康状态实时卡片 + 心跳检测（🟢🟡🔴）
+- **奏折阁** — 完成任务自动归档，五阶段时间线完整回溯
+- **官员总览** — Token 消耗排行榜 + 活跃度统计
+- **模型配置** — 每个 Agent 独立切换 LLM，一键热切换
+- **技能配置** — Skills 管理
+- **圣旨模板** — 9 个预设任务模板（类似 gpu-broker 的 template 系统）
+- **天下要闻** — 自动新闻聚合 + 飞书推送
+- **朝堂议政** — 多 Agent 从部门视角展开多角色辩论
+- **上朝仪式** — 每日开场动画（仪式感拉满）
+
+### 3. 完全可审计
+
+- 严格的权限矩阵：谁能给谁发消息，白纸黑字
+- 状态流转校验：非法状态跳转被拒绝
+- 完整奏折存档：每个任务的全生命周期可追溯
+
+## 部署方式
+
+```bash
+# Docker 一键体验（看板 Demo）
+docker run -p 7891:7891 cft0808/edict
+
+# 完整安装
+git clone https://github.com/cft0808/edict.git
+cd edict && chmod +x install.sh && ./install.sh
+```
+
+安装脚本自动：创建 12 个 Agent Workspace → 写入各省部 SOUL.md → 注册权限矩阵 → 符号链接数据目录 → 同步 API Key → 构建 React 前端 → 重启 Gateway。
+
+需要：OpenClaw + Python 3.9+ + Node.js 18+（前端构建）
+
+## 对比：三省六部 vs RAKU 三层模式
+
+| 维度 | 三省六部 | RAKU |
+|------|---------|------|
+| Agent 数量 | 12 个固定角色 | 2 个常驻 + 动态 subagent |
+| 审核机制 | 门下省专职审核 | subagent 自验证 |
+| 可观测性 | 实时看板 + 完整审计 | memory 日志 + git |
+| 灵活性 | 固定流程，适合标准化任务 | 灵活调度，适合多变任务 |
+| 资源开销 | 12 个 Agent 常驻，Token 消耗大 | 按需 spawn，用完释放 |
+| 适合场景 | 多人团队、需要合规审计 | 个人助手、快速迭代 |
+| 部署复杂度 | 中等（12 个 workspace） | 低（2 个 workspace） |
+
+## 值得借鉴的点
+
+1. **独立审核层** — 给 subagent 工作流加一个验证步骤，不是自己验证自己
+2. **结构化归档** — 任务完成后生成结构化报告（奏折），不只是日志
+3. **Agent 健康监控** — 心跳 + 活跃度检测，及时发现卡死的 Agent
+4. **朝堂议政** — 多 Agent 多视角讨论同一问题，适合复杂决策
+5. **仪式感设计** — 上朝仪式、奏折等概念让交互更有趣
+
+## 适用场景
+
+- 新机器到了想体验完整多 Agent 协作
+- 需要合规审计的正式工作流
+- 多人团队共用一套 Agent 系统
+- 想要可视化看板监控全局
+
+---
+
+*2026-03-30 | 敖丙整理 | 待新机器到了实际体验*