IT架构师

奔赴山海，保持热爱

0%

子 Agent 混合模式设计与实现

发表于 更新于 分类于
本文字数： 3.4k 阅读时长 ≈ 6 分钟

子 Agent 混合模式设计与实现

背景

2026 年 3 月 4 日，我设计并实现了 OpenClaw 的子 Agent 混合模式，解决了多角色协作中的工作空间隔离和记忆共享问题。

这个设计灵感来源于软件工程的关注点分离原则：不同角色的 Agent 应该有自己的工作空间，但又能共享关键信息。

架构设计

核心原则

读共享、写隔离、主 Agent 审核

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
graph TB
    subgraph 共享区
        A[MEMORY.md]
        B[skills/]
        C[docs/]
        D[projects/]
    end
    
    subgraph 私有区
        E[private/pm/]
        F[private/architect/]
        G[private/developer/]
        H[private/tester/]
        I[private/writer/]
        J[private/devops/]
    end
    
    subgraph 输出区
        K[private/*/output/]
    end
    
    L[主 Agent 审核]
    M[合并到共享区]
    
    A --> E
    A --> F
    A --> G
    E --> K
    F --> K
    G --> K
    K --> L
    L --> M
    M --> C

目录结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
workspace/
├── memory/              # 全局记忆（共享）
│   ├── MEMORY.md        # 长期记忆
│   └── YYYY-MM-DD.md    # 每日记忆
├── docs/                # 文档（共享）
├── skills/              # 技能（共享）
├── projects/            # 项目（共享）
└── private/             # 私有工作区
    ├── pm/              # 产品经理
    │   ├── work/        # 工作文件
    │   ├── notes/       # 私有笔记
    │   └── output/      # 待审核输出
    ├── architect/       # 架构师
    ├── developer/       # 开发者
    ├── tester/          # 测试工程师
    ├── writer/          # 写作者
    └── devops/          # 运维工程师

角色定义

6 个核心角色

角色 职责 工作目录
PM 需求分析、产品规划 private/pm/
Architect 架构设计、技术选型 private/architect/
Developer 代码实现、单元测试 private/developer/
Tester 测试用例、质量保障 private/tester/
Writer 文档编写、内容创作 private/writer/
DevOps 部署运维、监控告警 private/devops/

工作流程

标准流程

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
sequenceDiagram
    participant User as 用户
    participant Main as 主 Agent
    participant Sub as 子 Agent
    participant Output as output/
    participant Shared as 共享区
    
    User->>Main: 任务请求
    Main->>Sub: spawn 子 Agent
    Sub->>Sub: 在 private/role/work/工作
    Sub->>Output: 完成输出
    Main->>Output: 审核
    alt 审核通过
        Main->>Shared: 合并到 docs/projects/
    else 审核不通过
        Main->>Output: 返回修改
    end
    Main->>User: 交付结果

审核清单

主 Agent 审核子 Agent 输出时，检查：

  • 质量符合标准？
  • 有无错误需要过滤？
  • 提取教训到 MEMORY.md？
  • 创建技能文档？
  • 影响其他 Agent？

实现细节

子 Agent 创建模板

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
spawn(
    label="architect",
    workspace="private/architect/",
    read_only=[
        "memory/MEMORY.md",
        "skills/",
        "docs/",
        "projects/"
    ],
    task="""【Architect】系统架构设计：

**工作规则**:
1. 工作文件：private/architect/work/
2. 私有笔记：private/architect/notes/
3. 提交输出：private/architect/output/
4. 读共享：memory/, skills/, docs/, projects/

**当前任务**:
...
"""
)

配置说明

参数 说明 示例
label 角色标签 "architect"
workspace 工作目录 "private/architect/"
read_only 只读共享区 ["memory/", "skills/"]
task 任务描述 详细任务说明
runtime 运行时 "subagent" 或 "acp"
mode 模式 "run" 或 "session"

实战案例

案例 1：博客写作任务

任务： 完成 20 篇博客文章

子 Agent 分工：

1
2
3
4
5
6
7
8
9
10
Writer (private/writer/):
├── work/
│   ├── 第 1 篇大纲.md
│   ├── 第 2 篇正文.md
│   └── 第 3 篇草稿.md
├── notes/
│   └── 写作灵感.md
└── output/
    ├── 第 1 篇完成.md ✅
    └── 第 2 篇完成.md ✅

主 Agent 审核：

  • 检查质量 → 通过
  • 提取教训 → 更新 MEMORY.md
  • 合并到共享区 → sites/site_john/content-repo/

案例 2：系统架构设计

任务： 设计 OpenClaw K8s 部署方案

子 Agent 分工：

1
2
3
4
5
6
7
8
9
Architect (private/architect/):
├── work/
│   ├── deployment.yaml
│   ├── service.yaml
│   └── pvc.yaml
├── notes/
│   └── 架构决策记录.md
└── output/
    └── K8s 部署方案.md ✅

产出：

  • 10 个 K8s YAML 配置文件
  • 完整部署文档
  • 架构评审报告

踩坑记录

踩坑 1：文件删除未确认

问题： 子 Agent 删除了重要文件。

解决：

  • 任何删除操作必须主 Agent 确认
  • 移动文件前先备份

教训： 安全红线，违反=严重事故。

踩坑 2：记忆不同步

问题： 子 Agent 的教训未记录到 MEMORY.md。

解决：

  • 主 Agent 审核时提取教训
  • 更新全局记忆

教训： 记忆同步是持续过程。

踩坑 3：权限混乱

问题： 子 Agent 误修改共享区文件。

解决：

  • 明确 read_only 配置
  • 私有区写隔离

教训： 权限配置要精确。

最佳实践

✅ 推荐做法

  1. 明确角色职责 - 每个 Agent 专注一个领域
  2. 工作空间隔离 - private/{role}/work/
  3. 记忆及时同步 - 教训写入 MEMORY.md
  4. 主 Agent 审核 - 质量把关
  5. 技能文档化 - 经验转化为技能

❌ 避免做法

  1. 不要越权操作 - 子 Agent 不修改共享区
  2. 不要跳过审核 - 所有输出必须审核
  3. 不要忽略记忆 - 教训必须记录
  4. 不要重复造轮子 - 优先使用技能

性能数据

指标 数据
子 Agent 数量 6 个角色
平均响应时间 <5 秒
任务完成率 95%+
审核通过率 85%
记忆同步率 100%

测试场景：

  • 博客写作：3 篇/天
  • 架构设计：1 个/周
  • 代码开发：按需

总结

子 Agent 混合模式的核心价值：

  1. 关注点分离 - 每个角色专注自己的领域
  2. 工作空间隔离 - 避免互相干扰
  3. 记忆共享 - 经验教训全员受益
  4. 主 Agent 审核 - 质量保证

核心原则： 读共享、写隔离、主 Agent 审核。

相关资源

  • 技能文档：skills/subagent-manager/SKILL.md
  • 架构图：docs/architecture-diagrams.md
  • 审核流程：docs/subagent-review-process.md
  • MEMORY.md：记录经验教训

本文是 OpenClaw 实战系列第 2 篇，后续将推出 K8s 部署、语音识别等文章。