Persist cutover evidence cards with device-raw A/B keys for board and AI.

Evaluate keeps match keys for normalize/map pairing while diffs, reds, and the board show collected ports plus show-command provenance; add monitor-context and command-raw read APIs with biz-monitor:read scope.

Co-authored-by: Cursor <cursoragent@cursor.com>

skills/README.md

@@ -6,15 +6,16 @@
 |-------|--------------|----------------------------------------|
 | `ops` | `ops/netx-ops/` | NMS 告警/库存/SQL + managed CLI + `findTopologyPaths` |
 | `topology` | `topology/netx-topology/` | 画布 / Fabric / dual_unit / 布图 |
-| `biz-state` | `biz-state/netx-biz-state/` | 状态监控：TextFSM / parser / Profile / 多辅 EnrichJoin（Cursor Agent；无 MCP） |
+| `biz-monitor` | `biz-monitor/netx-biz-monitor/` | 割接/业务监控只读分析（**netxops 宿主工具**直连 REST；非 netx-mcp） |
+| `biz-state` | `biz-state/netx-biz-state/` | 状态监控：TextFSM / parser / Profile（Cursor Agent；无 DSH 工具） |
 
 ## DSH 怎么用
 
 1. 运行时优先：`NETX_SKILLS_ROOT` → 旁路 `../netx/skills` → 包内 `presets/netxops/skills`
 2. 发 npm 前：`powershell -File netxops/scripts/sync-skills-from-netx.ps1`
-3. Settings → 能力组开关：开哪组就注册哪组的 **tools + 对应 skill**
-4. 其它预设可强制挂：`dsh-netxops/tools-ops|topology`（旧别名 `tools-nms` / `tools-common` → ops）
+3. Settings → 能力组开关：开哪组就注册哪组的 **tools + 对应 skill**（含 **bizMonitor**）
+4. 其它预设可强制挂：`dsh-netxops/tools-ops|topology|biz-monitor`（旧别名 `tools-nms` / `tools-common` → ops）
 
-MCP / Cursor：skill 根直接指本目录。MCP 包内不镜像 skills。
+MCP / Cursor：skill 根直接指本目录。MCP 包内不镜像 skills。业务监控分析工具只在 **netxops**，不要往 netx-mcp 加。
 
 **Cursor Agent**：加 biz_state 监控命令时启用或点名 **netx-biz-state**（`skills/biz-state/netx-biz-state/`）。

skills/biz-monitor/netx-biz-monitor/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: netx-biz-monitor
+description: >-
+  Overnight cutover / biz_state monitor analysis via netxops host tools
+  (netx__getBizMonitor*). Given a project_id or task_id, read definitions,
+  board, reds/diffs with evidence (device-raw A/B, show commands), and judge
+  tool false-positive vs real business fault. Does not create templates/tasks.
+---
+
+# netx-biz-monitor（割接 / 业务监控只读分析）
+
+人配好监控与任务；AI 当晚用 **project_id**（或 task_id）做归因。  
+工具在 **netxops**（`netx__*`），直连 netx REST，**不是** netx-mcp。
+
+## 工具（能力组 `bizMonitor`）
+
+| 工具 | 用途 |
+|------|------|
+| `netx__getBizMonitorContext` | 任务定义：项目、监控/对比模板、归一化规则、端口映射、关联任务与命令项 |
+| `netx__getBizMonitorBoard` | 批次进度、evaluate run、sheet 卡、verdict 统计 |
+| `netx__listBizMonitorReds` | 红单 + **evidence** |
+| `netx__getBizMonitorDiffs` | run 明细（可滤 color=red） |
+| `netx__getBizCollectBatch` | 某次采集：commands / metrics |
+| `netx__getBizCollectCommandRaw` | 单命令全量 show 输出 |
+
+交叉验证真障时再用 ops：`netx__execManagedNe` / 拓扑路径。
+
+## 关键约定（必守）
+
+- **`old_key` / `new_key`**：设备采集原文 **A/B**（大屏与结论用这个）
+- **`match_*` / evidence.iface.normalized|map_***：内部配对，**不要**把映射后的 BB 说成两侧端口
+- **evidence.*.command.raw_command**：实际 show 命令
+- **evidence.*.device / collect**：哪台设备、何时采的
+
+## 推荐顺序
+
+1. `getBizMonitorContext(project_id)` — 弄清盯什么  
+2. `getBizMonitorBoard(batch_id)` — 进度 / missing / skipped  
+3. `listBizMonitorReds` 或 `getBizMonitorDiffs(color=red)`  
+4. 看 evidence：parse 失败？current_missing？映射 miss？归一化误伤？  
+5. 需要原文 → `getBizCollectCommandRaw`  
+6. 像真障 → `execManagedNe` 现场核对  
+
+## Verdict 速查（skill 解释，工具不硬编码）
+
+| verdict | 含义（窗口内） |
+|---------|----------------|
+| migrated | expect 项已迁到新侧 |
+| anomaly | 异常（多为红） |
+| unfinished | expect 未完成（验收常红） |
+| migrating / expected / ok | 过程态 / 正常 |
+| lost / not_involved | 丢失或无关 |
+
+## 误报优先查
+
+1. `parse_status` 非 ok / 行数为 0  
+2. board：`current_missing` / `collect_skipped`  
+3. 端口映射漏配、归一化前后不一致导致假 anomaly  
+4. 再谈真实业务问题  
+
+配置整改与关红单由人做；本 skill **只读分析**。