# 北极星② 多Bot互动 — 一页纸逻辑地图

> 定位：14个Bot像同事一样读写CMA数据、协同干活。任总10分钟消化层。

## 数据流（箭头图）
```
14Bot（研学/财务/项目/运维/创作/商务...）
        │  bot/query  bot/kpis  bot/import
        ▼
   bot_bridge（A2A桥接层，X-BOT-KEY鉴权）
        │  写：kpi-value-with-check / kpi-result / okr/create
        │  读：budget/plans / cost/actual / okr/list
        ▼
   验证引擎（verify + bot-bridge/verify）
        │  passed → 自动回填 + OKR联动 + 通知
        │  failed → 打回Bot重试(≤3次) → 升级人工
        ▼
   CMA数据池（KPI/预算/OKR/ActionPlan）
```

## 关键API（核心5个）
| 核心 | API | 作用 |
|:--|:--|:--|
| ⭐1 | `POST /bot/kpi-value-with-check` | Bot写KPI值+校验 |
| ⭐2 | `GET /bot/overview` | Bot总览（各Bot权限内数据） |
| ⭐3 | `POST /bot-bridge/verify/{plan_id}` | Bot侧轻量验证入口 |
| ⭐4 | `POST /bot/okr/create` | Bot创建OKR |
| ⭐5 | `POST /bot/import` | Bot批量导入 |

## 决策点（需任总拍板 1-3个）
1. Bot写入权限边界：哪个Bot能写哪些表（L1-L4分级已定，执行中）
2. 验证失败打回策略：打回次数/升级阈值（当前默认3次）
3. Bot间数据一致性：多Bot写同一KPI冲突时谁优先（唯一执行人铁律）

## 验证点
- ✅ L1自动：bot/iron-law 铁律KPI看板（每日聚合）
- 🟡 L2 Bot验证：bot_bridge读写闭环（QA Bot造数验证）
- 🔴 L3任总抽验：overview总览 / query查询 / 验证桥 3项核心

## 当前状态
- ✅ A2A + bot_bridge 已落地（14Bot互通）
- ✅ verify引擎已上线（2026-08-30修复4缺陷，commit 6910d90）
- ⏳ 失败打回Bot自动重试链路（cron残留修复派单中）
- 🟡 Bot联合决策（同数据多Bot出结论）——中期规划
