docs(ops): align netx exec limits and CLI allowlist with server

Mirror NETX_NE_EXEC_MAX_COMMANDS and updated show/ping/traceroute/pipe rules in builtin tool and playbook.

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

runtime/tools/experts/network_ops/netx_tools.py

@@ -738,8 +738,18 @@ def netx_get_managed_ne_tool() -> ToolSpec:
     )
 
 
+def _netx_exec_max_commands() -> int:
+    """Mirror netx NETX_NE_EXEC_MAX_COMMANDS (default 5, hard cap 50)."""
+    try:
+        raw = int(os.getenv("NETX_NE_EXEC_MAX_COMMANDS") or 5)
+    except ValueError:
+        raw = 5
+    return max(1, min(50, raw))
+
+
 def netx_exec_managed_ne_tool() -> ToolSpec:
     """Run read-only CLI on a managed NE via netx."""
+    max_cmds = _netx_exec_max_commands()
 
     def handler(args: dict[str, Any]) -> dict[str, Any]:
         ne_id = str(args.get("ne_id") or "").strip()
@@ -751,7 +761,7 @@ def netx_exec_managed_ne_tool() -> ToolSpec:
         commands = [str(c).strip() for c in raw_cmds if str(c).strip()]
         if not commands:
             return {"ok": False, "error": "commands_required", "error_code": "commands_required"}
-        if len(commands) > 5:
+        if len(commands) > _netx_exec_max_commands():
             return {"ok": False, "error": "too_many_commands", "error_code": "too_many_commands"}
         body: dict[str, Any] = {"ne_id": ne_id, "commands": commands}
         rts = args.get("read_timeout_sec")
@@ -769,8 +779,9 @@ def netx_exec_managed_ne_tool() -> ToolSpec:
         name="netx_exec_managed_ne",
         description=(
             "经 netx 登录「网元管理」中的设备并执行只读 CLI（POST /v1/managed-ne/exec）。"
-            "每条命令须以 show / display / ping / ping6 开头（只读查询与连通探测，禁止 get/traceroute/改配置等）；"
-            "禁止管道符、分号及改配置类命令；单次最多 5 条；默认读超时 60s。"
+            "每条命令须以 show / display / ping / ping6 / traceroute / tracert / trace / trace6 开头；"
+            f"允许白名单管道过滤；禁止分号及改配置类命令；单次最多 {max_cmds} 条"
+            "（NETX_NE_EXEC_MAX_COMMANDS，硬上限 50）；默认读超时 60s。"
             "返回合并输出（含命令回显）；失败时含 error/detail。"
             "先 netx_list_managed_ne 解析 ne_id；若 connect_status 非 pass 可先 netx_get_managed_ne 看 connect_detail。"
         ),
@@ -782,7 +793,7 @@ def netx_exec_managed_ne_tool() -> ToolSpec:
                     "type": "array",
                     "items": {"type": "string"},
                     "minItems": 1,
-                    "maxItems": 5,
+                    "maxItems": max_cmds,
                     "description": "只读 CLI 列表，如 show version、display interface brief",
                 },
                 "read_timeout_sec": {

skills/_workspace/ops/ops-netx-managed-ne-playbook/SKILL.md

@@ -20,17 +20,18 @@ description: 面向 ops 专家的 netx 纳管网元（网元管理）作业手
    - `mcp__netx__getManagedNe`：单条详情、`connect_detail`
    - **UME 清单（无需逐台纳管）**：`mcp__netx__listCliTargets`（`source=ume`）或 `queryUmeNeInventory` 取 `ne_id`，再用 `ume_ne_id` 执行 CLI（需先在 netx **UME → CLI 连接** 配置统一凭据/跳板）
 2. **登录查信息**
-   - `mcp__netx__execManagedNe`：`ne_id` **或** `ume_ne_id` + `commands`（最多 5 条只读命令）
+   - `mcp__netx__execManagedNe`：`ne_id` **或** `ume_ne_id` + `commands`（默认最多 5 条，可由 `NETX_NE_EXEC_MAX_COMMANDS` 调高，硬上限 50）
 
 ## CLI 约束（服务端强制）
 
-- 允许前缀：`show `、`display `、`ping `、`ping6 `（服务端强制）
-- 禁止：`|`、`;`、换行拼接、改配置类（configure/write/copy/reload/delete 等）
+- 允许前缀：`show `、`display `、`ping `、`ping6 `、`traceroute `、`tracert `、`trace `、`trace6 `
+- 管道：仅白名单过滤（`include`/`exclude`/`begin`/`section`/`count`/`match`/`grep`/`one-line`/`no-more`）；禁止 `redirect`/`append`/`tee`/`send`
+- 禁止：`;`、换行拼接、改配置类（configure/write/copy/reload/delete 等）
 - 示例：
-  - 思科：`show version`、`show configuration | include hostname` **不可**（含 `|`）→ 改用 `show configuration` 或连通测试已解析的 hostname
-  - 华为：`display version`、`display interface brief`
+  - 思科：`show version`、`show configuration | include hostname`
+  - 华为：`display version`、`display current-configuration | include sysname`
   - ZTE：`show version`、`show interface`
-  - 连通：`ping 192.168.0.1`、`ping6 2001::db8::1`
+  - 连通：`ping 192.168.0.1`、`ping6 2001::db8::1`、`traceroute 10.0.0.1`
 
 ## 排障流程