From e1bae6a14ad454809f97415bdeaacf8ae79ae198 Mon Sep 17 00:00:00 2001 From: oliver Date: Sun, 20 Sep 2026 15:04:14 +0800 Subject: [PATCH] Document listBizMonitors as the biz-monitor catalog entry before project_id tools. Co-authored-by: Cursor --- docs/MCP.md | 2 +- skills/biz-monitor/netx-biz-monitor/SKILL.md | 25 +++++++++++--------- 2 files changed, 15 insertions(+), 12 deletions(-) diff --git a/docs/MCP.md b/docs/MCP.md index 29899d3..a22fd4f 100644 --- a/docs/MCP.md +++ b/docs/MCP.md @@ -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__`；DSH：`netx__`。 -**业务监控 / 割接分析**：不走 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`）。 --- diff --git a/skills/biz-monitor/netx-biz-monitor/SKILL.md b/skills/biz-monitor/netx-biz-monitor/SKILL.md index 76dd1fd..e3fa593 100644 --- a/skills/biz-monitor/netx-biz-monitor/SKILL.md +++ b/skills/biz-monitor/netx-biz-monitor/SKILL.md @@ -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 解释，工具不硬编码）