hansjone/netx
1
0
Fork 0
mirror of https://github.com/hansjone/netx.git synced 2026-10-09 00:50:46 +08:00
Code Issues Projects Releases 1 Packages Wiki Activity Actions 2

Document listBizMonitors as the biz-monitor catalog entry before project_id tools.

Browse source 
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
oliver 2026-09-20 15:04:14 +08:00
parent ac4f115ee8
commit e1bae6a14a
2 changed files with 15 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

2
docs/MCP.md
View file

@ -140,7 +140,7 @@ pip install "git+https://github.com/hansjone/netx.git#subdirectory=packages/netx
参数优先 `nms_ne_id` / `nms_ne_ids`（保留 `ume_*` 别名）。拓扑 Fabric / 画布工具在 **[`netx-topology-mcp`](./MCP_TOPOLOGY.md)**。oclaw 中名称带前缀：`mcp__netx__<toolName>`；DSH：`netx__<toolName>`。
**业务监控 / 割接分析**：不走 netx-mcp。DSH **netxops** 宿主工具组 `bizMonitor`（`netx__getBizMonitorContext` 等）直连 netx REST（`/v1/biz-migration/*`、`/v1/biz-state/*`，需 token scope `biz-monitor:read`）。
**业务监控 / 割接分析**：不走 netx-mcp。DSH **netxops** 宿主工具组 `bizMonitor`（`netx__listBizMonitors` / `netx__getBizMonitorContext` 等）直连 netx REST（`/v1/biz-migration/*`、`/v1/biz-state/*`，需 token scope `biz-monitor:read`）。
---

25
skills/biz-monitor/netx-biz-monitor/SKILL.md
View file

@ -2,20 +2,22 @@
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__listBizMonitors / netx__getBizMonitor*). List projects/tasks first
when no id is given; then 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）做归因。
人配好监控与任务；AI 当晚做归因。
工具在 **netxops**（`netx__*`），直连 netx REST，**不是** netx-mcp。
## 工具（能力组 `bizMonitor`）
| 工具 | 用途 |
|------|------|
| `netx__listBizMonitors` | **入口目录**：列出割接/监控对比项目 + 业务监控任务（**无需** project_id） |
| `netx__getBizMonitorContext` | 任务定义：项目、监控/对比模板、归一化规则、端口映射、关联任务与命令项 |
| `netx__getBizMonitorBoard` | 批次进度、evaluate run、sheet 卡、verdict 统计 |
| `netx__listBizMonitorReds` | 红单 + **evidence** |
@ -25,7 +27,7 @@ description: >-
交叉验证真障时再用 ops：`netx__execManagedNe` / 拓扑路径。
## 关键约定（必守）
## 字段约定（必守）
- **`old_key` / `new_key`**：设备采集原文 **A/B**（大屏与结论用这个）
- **`match_*` / evidence.iface.normalized|map_***：内部配对，**不要**把映射后的 BB 说成两侧端口
@ -34,12 +36,13 @@ description: >-
## 推荐顺序
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` 现场核对
1. 无 id → `listBizMonitors`（`kind=projects|tasks|all`，可加 `q` / `purpose`）
2. `getBizMonitorContext(project_id)` — 弄清盯什么
3. `getBizMonitorBoard(batch_id)` — 进度 / missing / skipped
4. `listBizMonitorReds` 或 `getBizMonitorDiffs(color=red)`
5. 看 evidence：parse 失败？current_missing？映射 miss？归一化误伤？
6. 需要原文 → `getBizCollectCommandRaw`
7. 像真障 → `execManagedNe` 现场核对
## Verdict 速查（skill 解释，工具不硬编码）