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
feature/*.md
阶段 3 产出
useXxxLogic.ts
XxxView.tsx
index.module.less
XxxView.tsx
index.module.less
阶段 3.5 产出
模板审计报告
阶段 4 产出
审查报告
(pass/conditional/fail)
(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 文档 |