MBSE 多智能体开发架构

v2.0 · 2026-05-29

1

架构总览

MBSE 多智能体开发架构采用三层分离设计,将工作流编排、阶段执行、方法知识解耦为独立层次,通过 ACP 协议实现标准化通信。

Orchestration Layer

Project Coordinator

总控调度 · Gate Check · 用户交互

派遣任务 [ACP/TASK]
Execution Layer
阶段 0

Knowledge Collector

知识搜集

阶段 1

Requirement Clarifier

需求澄清

阶段 2

Solution Designer

方案设计

阶段 3

Code Developer

代码开发

阶段 3

Verifier

独立验证

阶段 3.5

Template Auditor

模板审计

阶段 4

QA Reviewer

质量审查

引用方法
Knowledge Layer
knowledge-collection
requirement-clarification
solution-design
code-development
verification
template-audit
qa-review

辅助 Skills

acp-protocol graph-query-helper headless-architecture code-review-rules mbse-internal-libs
2

三层职责分离

编排层

Orchestration

  • 与用户交互
  • 调度 Agent
  • Gate Check
  • 状态管理

执行层

Execution

  • 引用 Skill 方法
  • 执行阶段任务
  • 产出交付物
  • 向 PC 报告

知识层

Knowledge

  • 提供 Skills
  • 操作步骤
  • I/O 模板
  • 质量标准
  • 检查脚本

设计原则

层级 职责 包含什么 不包含什么
编排层调度 + 质量门控Gate Check 条件、用户交互协议具体执行方法
执行层阶段执行角色定义、工具权限、交付物声明方法细节(引用 Skill)
知识层方法知识操作步骤、模板、标准、脚本执行角色、调度逻辑
3

工作流全景

用户
提交需求
阶段 0知识搜集
拉取后端代码 查询前端图谱 查询后端图谱 生成 CODE_KNOWLEDGE.md
Gate Check 0:后端已拉取 · 前端图谱≥3节点 · 后端图谱已分类 · 文档已生成
阶段 1需求澄清
收集需求信息 参考代码知识 逐功能点澄清 生成 DRAFT_SPEC.md
Gate Check 1:唯一 ID · 可验证 · 用户确认 · 文档已提交
阶段 2方案设计
代码库分析 逐功能点设计 整体方案整合 生成 TECHNICAL_SPEC.md + feature/*.md
Gate Check 2:独立 feature 文档 · 后端参考 · Headless 方案 · 用户已确认
阶段 3代码开发
按任务顺序实现 pnpm typecheck + lint 自审修复
Gate Check 3:typecheck · lint · 无内联样式 · Headless 合规
阶段 3.5模板审计
TA: 扫描 template/ 目录 扫描临时接口 检查后端 API 就绪状态 生成审计报告
alt 有可替换接口 → 派遣 CD 替换临时接口
阶段 4QA 审核
QR: 第一阶段 · 规范符合审查 第二阶段 · 代码质量审查 生成审查报告
alt 审查通过 → Gate Check 4 → 阶段 5 收尾 · 审查失败 → 派遣 CD 修复 → 重新审查
阶段 5收尾
规格漂移检测 文档对齐 代码提交
交付用户
4

Agent 交互序列

sequenceDiagram
    autonumber
    participant U as 👤 用户
    participant PC as 🎯 Project Coordinator
    participant KC as 📚 Knowledge Collector
    participant RC as 📋 Requirement Clarifier
    participant SD as 🏗️ Solution Designer
    participant CD as 💻 Code Developer
    participant TA as 📦 Template Auditor
    participant QR as 🔍 QA Reviewer

    Note over U,QR: 阶段 0 · 知识搜集
    U->>PC: 提交需求
    PC->>PC: 分析需求 · 提取关键词 · 创建任务 ID
    PC->>U: ⏸️ 展示知识搜集计划
    U-->>PC: 确认
    PC->>KC: [ACP/TASK] 搜集代码知识
    KC->>KC: git pull 后端代码
    KC->>KC: 查询前端图谱
    KC->>KC: 查询后端图谱
    KC-->>PC: [ACP/HANDOFF] CODE_KNOWLEDGE.md 已生成
    PC->>PC: Gate Check 0
    PC->>U: ⏸️ 展示知识摘要

    Note over U,QR: 阶段 1 · 需求澄清
    U-->>PC: 确认进入需求澄清
    PC->>RC: [ACP/TASK] 澄清需求
    RC->>U: 一次一个问题(多选优先)
    U-->>RC: 回答
    RC->>RC: 增量验证 · 写入文档
    RC-->>PC: [ACP/HANDOFF] DRAFT_SPEC.md 已生成
    PC->>PC: Gate Check 1
    PC->>U: ⏸️ 展示需求清单

    Note over U,QR: 阶段 2 · 方案设计
    U-->>PC: 确认进入方案设计
    PC->>SD: [ACP/TASK] 设计技术方案
    SD->>SD: 分析后端参考
    SD->>U: 逐功能点确认(一次一问)
    U-->>SD: 确认技术决策
    SD->>SD: 编写 TECHNICAL_SPEC.md + feature/*.md
    SD-->>PC: [ACP/HANDOFF] 方案已生成
    PC->>PC: Gate Check 2
    PC->>U: ⏸️ 展示方案摘要

    Note over U,QR: 阶段 3 · 代码开发
    U-->>PC: 确认进入开发
    PC->>CD: [ACP/TASK] 执行编码实现
    CD->>CD: 按任务顺序实现
    CD->>CD: pnpm typecheck + lint
    CD->>CD: 自审修复
    CD-->>PC: [ACP/HANDOFF] 代码已实现
    PC->>PC: Gate Check 3

    Note over U,QR: 阶段 3.5 · 模板审计
    PC->>TA: [ACP/TASK] 扫描 template/ 目录
    TA->>TA: 扫描临时接口
    TA->>TA: 检查后端 API 就绪状态
    TA-->>PC: [ACP/HANDOFF] 审计报告

    alt 有可替换接口
        PC->>CD: [ACP/TASK] 替换临时接口
        CD-->>PC: [ACP/HANDOFF] 已替换
    end

    Note over U,QR: 阶段 4 · QA 审核
    PC->>QR: [ACP/TASK] 双阶段审查
    QR->>QR: 第一阶段:规范符合审查
    QR->>QR: 第二阶段:代码质量审查
    QR-->>PC: [ACP/HANDOFF] 审查报告

    alt 审查通过
        PC->>PC: Gate Check 4
        PC->>PC: 阶段 5 · 漂移检测 + 文档对齐
        PC->>U: ✅ 开发完成
    else 审查失败
        PC->>CD: [ACP/TASK] 修复问题
        CD-->>PC: [ACP/HANDOFF] 已修复
        PC->>QR: 重新审查
    end
    
5

数据流向

输入
用户需求
前端代码
后端代码
设计稿 (Pixso)
阶段 0 产出
CODE_KNOWLEDGE.md
阶段 1 产出
DRAFT_SPEC.md
阶段 2 产出
TECHNICAL_SPEC.md
feature/*.md
阶段 3 产出
useXxxLogic.ts
XxxView.tsx
index.module.less
阶段 3.5 产出
模板审计报告
阶段 4 产出
审查报告
(pass/conditional/fail)
6

Gate Check 门控机制

Stage 0PC 派遣 KC → 产出 CODE_KNOWLEDGE.md
Gate0
Pass0 → Stage 1 Fail0 → 退回 KC
Stage 1PC 派遣 RC → 产出 DRAFT_SPEC.md
Gate1
Pass1 → Stage 2 Fail1 → 退回 RC
Stage 2PC 派遣 SD → 产出 TECHNICAL_SPEC.md + feature/*.md
Gate2
Pass2 → Stage 3 Fail2 → 退回 SD
Stage 3PC 派遣 CD → 编码实现 + VER 独立验证
Gate3
Pass3 → Stage 3.5 Fail3 → 退回 CD
Stage 3.5模板审计 → 扫描临时接口 → 审计报告
Gate35
Pass35 → Stage 4 Fail35 → 退回 CD 替换
Stage 4QA 审核 → 规范符合 + 代码质量
Gate4
Pass4 → Stage 5 收尾 Fail4 → 退回 CD 修复
Stage 5漂移检测 → 文档对齐 → 代码提交
交付用户
7

ACP 通信协议

所有 Agent 间交互遵循 ACP v1.1 协议,消息格式如下:

消息结构

消息头[ACP/1.1] 类型 ID 时间戳
元数据From / To / Task / Step
状态段State / Progress / Context
正文具体内容

消息类型

TASKPC 派遣任务给子 Agent
HANDOFF子 Agent 报告完成
BLOCK阻塞问题上报
SYNCPC 向用户同步进度
CHECKPOINT进度断点保存
8

文件结构

.claude/
├── agents/                    # 执行层 Agent 定义
│   ├── project-coordinator.md    # 编排层 · 总控
│   ├── knowledge-collector.md    # 阶段 0 · 知识搜集
│   ├── requirement-clarifier.md  # 阶段 1 · 需求澄清
│   ├── solution-designer.md      # 阶段 2 · 方案设计
│   ├── code-developer.md         # 阶段 3 · 代码开发
│   ├── template-auditor.md       # 阶段 3.5 · 模板审计
│   └── qa-reviewer.md            # 阶段 4 · QA 审核
│
├── skills/                    # 知识层 Skill 定义
│   ├── knowledge-collection.md   # 阶段 0 方法
│   ├── requirement-clarification.md
│   ├── solution-design.md
│   ├── code-development.md
│   ├── template-audit.md
│   ├── qa-review.md
│   ├── acp-protocol.md           # 辅助:通信协议
│   ├── graph-query-helper.md     # 辅助:图谱查询
│   ├── headless-architecture.md  # 辅助:架构规范
│   ├── code-review-rules.md      # 辅助:审查规则
│   └── mbse-internal-libs.md     # 辅助:内部包规则
│
├── scripts/                   # 检查脚本
│   ├── detect_inline_styles.py   # 内联样式检测
│   ├── check_headless_arch.py    # Headless 架构检查
│   ├── graphify_query_frontend.py
│   ├── graphify_query_backend.py
│   ├── code-review-checks.ps1
│   └── graphify-query.ps1
│
├── templates/                 # 文档模板
│   ├── TECHNICAL_SPEC_template.md
│   ├── feature_template.md
│   └── CODE_KNOWLEDGE_template.md
│
└── commands/
    └── mbse.md                   # 工作流入口命令
9

设计决策记录

决策 原因
三层分离消除 Agent 与 Skill 的重复,职责单一
Skill 只含方法Agent 负责执行,Skill 负责知识,互不侵入
Gate Check 强制每阶段质量可控,问题早发现早修复
单点推进需求/方案阶段避免批量确认导致的遗漏
ACP 协议标准化Agent 通信可追溯、可审计
Headless 绝对强制所有组件 Logic + View 分离,内联样式零容忍
后端代码前置方案设计基于后端实际实现,减少前后端不一致
检查脚本独立可复用、可维护、不嵌入 Agent/Skill 文档
滚轮缩放 · 拖拽移动 · Esc 关闭