netx/skills/biz-monitor/netx-biz-monitor/SKILL.md
oliver c1b1c0f75d 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>
2026-09-19 22:48:37 +08:00

2.5 KiB
Raw Blame History

name description
netx-biz-monitor 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 只读分析。