docs: API验证分工表+北极星四层地图（项目Bot产出）

docs/northstar-layer-maps/02-multi-bot.md

@@ -0,0 +1,44 @@
+# 北极星② 多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出结论）——中期规划