BossAgents × PLM 底座 · 通用技能集成框架 v3（五层 · 含 A2A / 验证合约 / 技能发现 · 对齐代码现实）

版本沿革：

• v1（外部撰写）：骨架正确，但把采购当待建白纸、技能与 worker 脱节、外部技能标"已验证"、数据资产源误判。
• v2（本仓 AI 校正）：把框架落回代码现实——技能=worker 能力单元、采购栈已上线、数据源是 SCSAI+电商、扩展 unified-asset-service、加第 0 步盘点。
• v3（本版）：在 v2 基础上吸收外部检索补充的三个缺口——A2A 协作层、技能验证合约（质量门禁）、技能发现机制；架构扩为五层；并附"行业验证信号"章（标注为检索结论，非本系统实测）。

01 结论先行（v3 校正）

底座方向对，但两件事要同时校准：

1. 底座不是从零建，也不是纯协议堆叠——它一半已经存在（worker/CapabilityRuntime/procurement-workflow-v3/global-blackboard 协作/unified-asset-service）。先把既有资产收纳进范式。
2. 协议层要补 A2A，但分内外：内部 Agent 协作（global-blackboard+lite-scheduler）已落地；外部 Agent 协作（BossAgents↔客户/供应商系统）走 A2A，现在预留接口、不急于实现。
3. 质量门禁（验证合约）是规模化前提：没有"准确率/覆盖率/响应时间"三个数字的技能，不算已接入。这把 v2 第 5 步回测变成了强制工程标准。
4. 技能发现机制：内部先索引 86 个 worker，外部再从 MCP 生态检索——不是人工翻 GitHub。

02 设计原则（v2 + 三缺口合并）

| 维度 | 校正结论 |

|------|---------|

| 起点 | 盘点收纳既有 worker/协作/聚合层，不绿地重造 |

| 技能 | = worker 能力单元；外部 MCP 是 worker 的可选实现源 |

| 协议 | MCP（微观工具调用）+ A2A（宏观 Agent 协作）组合拳；内部 A2A 已有，外部预留 |

| 数据资产 | 真实源 = SCSAI PLM + 外部电商 API；扩展 unified-asset-service 加权限/审计 |

| 质量门禁 | 每个技能必须有"验证合约"（输入边界/输出格式/准确率下限/响应上限/失败回退） |

| 技能发现 | 内部索引 86 worker + 外部 MCP 生态检索脚本，按 Star/更新/许可证排序 |

铁律：外部技能状态严禁写"已验证"，只能"检索到/待集成/已验证（集成+回测后）"。

03 总体架构（五层，非四层）

┌─────────────────────────────────────────────────────────────┐
│ L5 场景层（插拔）                                            │
│ 采购比价(已有 DS-PROC-001) · 设备运维 · 质量分析 · 工艺优化   │
│ 每个场景 = 一个配置包（数据资产映射 + 技能编排 + 评分权重）    │
├─────────────────────────────────────────────────────────────┤
│ L4 协作层【新增·外部】                                       │
│ A2A Agent 注册表 + 跨平台协作编排                           │
│ （BossAgents 数字员工 ↔ 外部系统 Agent：供应商/客户/生态）    │
│ ★ 内部 Agent 协作不在此层——已在 global-blackboard+lite-scheduler │
│   落地（IQC→IPQC→OQC 多员工并发，L0~L4 协同），L4 只管对外 │
├─────────────────────────────────────────────────────────────┤
│ L3 技能层（原"技能接入层+运行时"扩展）                      │
│ 技能注册表 · 技能发现【新增】 · 数据映射引擎 · 四项适配器    │
│ 技能验证合约【新增】 · MCP/API/SDK 统一调用                  │
├─────────────────────────────────────────────────────────────┤
│ L2 运行时层（不变）                                          │
│ 编排 · 鉴权 · 审计 · 重试 · 结果回流                         │
├─────────────────────────────────────────────────────────────┤
│ L1 数据资产层（不变·对齐真实源）                             │
│ SCSAI PLM（Vendor/Part/BOM）· 外部电商 API · 历史价/PO(待核实) │
└─────────────────────────────────────────────────────────────┘

04 数据资产中心（同 v2，真实源对齐）

| 资产 ID | 真实数据源 | 现状 |

|---------|-----------|------|

| DA-001 物料 | SCSAI Part（SCSAIClient） | 已连通，待注册 |

| DA-003 供应商 | SCSAI Vendor（findVendorsByProduct） | 已实际读取 |

| DA-005 BOM | SCSAI BOM / 本地 phos_chem | 部分可用 |

| DA-电商 比价源 | /api/unified-procurement（京东+1688） | 已实际调用 |

| DA-002 历史价 / DA-004 PO | purchase_orders(core_runtime)/SCSAI | 114 实例未核实，待确认 |

扩展 server/core/unified-asset-service.js(126KB) 为带权限/审计的取数注册表，不另起模块。

05 技能注册表（v2 + 发现 + 验证合约）

5.1 技能=worker 能力单元（v2 结论保留）

5.2 技能发现机制【新增·缺口3】

不再靠人工翻 GitHub。两层发现：

1. 内部索引（优先）：扫描 server/boss-scheduler/workers/*.js + local.yaml，生成内部技能目录（当前 86 个 worker），新场景先查内部是否有等价实现（即 v2 第 0 步盘点自动化）。
2. 外部检索脚本：输入"行业+场景+能力类型"，从 MCP 生态/开源项目检索候选，按 Star 数 / 最近更新时间 / 许可证类型 排序，输出候选列表供人工审核，再进入"验证→登记→接入"。

5.3 技能验证合约【新增·缺口2·质量门禁】

每个技能登记时必须带验证合约，上线前跑出三个数字写回注册表：

{
  "skill_id": "SK-PROC-001",
  "impl": "worker:procurement",
  "validation_contract": {
    "input_bounds": "产品名+数量+预算；缺失预算则走默认阈值",
    "output_schema": "比价结论/供应商推荐/PO/省钱报告",
    "accuracy_min": "推荐结果与人工决策一致率 ≥ __%",
    "coverage_min": "可处理物料种类 / 企业总物料 ≥ __%",
    "max_latency_ms": 5000,
    "fallback": "SCSAI/电商不可用时返回明确错误，禁止编造报价"
  },
  "verified_metrics": {
    "accuracy": "待回测", "coverage": "待回测", "avg_latency": "待回测"
  },
  "status": "已运行 / 待集成 / 已验证"
}

没有 verified_metrics 三个数字的技能，状态不得升为"已验证"。采购比价先跑通这三者，设备运维/质量/工艺接入时用同一标准。

06 四项适配器 + A2A 适配（v2 + L4）

| 适配器 | 现状 | 底座补齐 |

|--------|------|---------|

| ① 数据适配 | SCSAIClient / 电商解析 | 外置为配置表 |

| ② 安全适配 | ConfirmNeededError / i18n | 补脱敏+取数审计+出网白名单（接外部 MCP/A2A 必填） |

| ③ 性能适配 | worker 内超时/重试散落 | 统一连接池/超时/重试/缓存 |

| ④ 输出适配 | 各 worker 自渲染 | 统一渲染器→BossAgents 产物 Schema |

| ⑤ A2A 适配【新增】 | 内部协作已有（global-blackboard） | 外部：A2A 端点注册 + 消息格式 + 协作类型白名单；预留，默认关闭 |

私有化 vs 出网矛盾（v2 遗留，L4 强化）：接公网 MCP/A2A 必出网。决策——A 私有自建托管（数据不出网）/ B 出网脱敏审计+白名单（默认关闭，显式开启，沿用 USE_1688_SOURCING 先例）。

07 编排运行时（泛化 procurement-workflow-v3，不变）

现有 server/tools/procurement-workflow-v3.js(835行) 已是采购编排实现。底座把它泛化为"场景编排配置"：技能序列/评分权重/回退/确认节点从配置读，采购成为第一个配置包样板。

08 场景接入（五步 + 第 0 步 + 验证合约 + 发现）

• 第 0 步 · 盘点+发现：内部索引 86 worker（5.2），确认无等价实现。
• 第 1 步 · 注册数据资产（真实源）
• 第 2 步 · 选技能：优先复用注册表 worker；缺则外部检索（5.2）后登记"待集成"
• 第 3 步 · 填映射表（外置硬编码）
• 第 4 步 · 配编排与评分（权重配置项，40/30/30 标"未校准"）
• 第 5 步 · 验证合约回测：用 SCSAI/本地真实数据跑出准确率/覆盖率/响应时间三数字，达标升"已验证"。未跑通第 5 步 = 未接入完成。

09 采购实例（v2 真实做法，补验证缺口）

10 场景实例二~四（同底座换配置）

11 落地节奏（加 A2A 预留 + 发现脚本 + 验证门禁）

12 风险与对策（v2 + 三缺口）

13 行业验证信号（外部检索结论 · 非本系统实测 · 待逐条核实）

以下为 2026-08-31 联网检索到的行业信号，用于佐证框架方向，非 BossAgents 实测数据，落地前需逐条复核来源与时间线：

• MCP+A2A 组合拳已成工业标准：MCP 负责微观工具调用（Agent→工具），A2A 负责宏观 Agent 协作（Agent→Agent）。A2A v1.0 据称 2026-04 发布、150+ 组织支持；Linux Foundation Agentic AI Foundation 据称 2026-06 发布 MCP+A2A 融合草案；微软 Agent Framework 据称已支持 A2A v1.0。（→ 支撑 L4 协作层）
• MCP 生态规模：据称注册 Server 已破 10 万；Beckhoff TwinCAT CoAgent、Synera、UiPath 已基于 MCP/A2A 落地。（→ 支撑技能发现机制有海量候选）
• 数据资产中心方向：OPC 基金会将 430+ 行业信息模型转 AI-ready 资产；MCP 被用于连接 Agent 到企业数据孤岛。（→ 支撑 L1）
• 军工工艺→民用已验证：开目软件"知识库+多智能体"、天喻 PCBA 电装工艺 AI。（→ 支撑 BossAgents 工艺优化场景可行性）
• 验证标准可借鉴：IBM AssetOpsBench（KDD 2026，460+ 工业场景基准）可用于技能验证合约的基准参考。

诚实标注：上述为检索摘要，含未来日期与统计数字，本仓未独立复验。框架采纳其"方向性结论"，不采纳为已落地事实。

BossAgents 通用技能集成框架 v3（五层·对齐代码现实+三缺口）｜ BossAgents 项目组 ｜ 2026-08-31