mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-08 23:33:16 +08:00
feat(ops): add netx managed NE query and exec tools
Add ops specialist tools to list/get managed NEs and execute read-only CLI via netx. Document the new managed-NE workflow in role prompts, env example, and a dedicated ops skill with tests. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
parent
8233db93db
commit
bbd7b0300f
6 changed files with 266 additions and 3 deletions
41
skills/_workspace/ops/ops-netx-managed-ne-playbook/SKILL.md
Normal file
41
skills/_workspace/ops/ops-netx-managed-ne-playbook/SKILL.md
Normal file
|
|
@ -0,0 +1,41 @@
|
|||
---
|
||||
name: ops-netx-managed-ne-playbook
|
||||
description: 面向 ops 专家的 netx 纳管网元(网元管理)作业手册。覆盖设备清单、连通状态、经 netx 登录设备执行只读 CLI。
|
||||
---
|
||||
|
||||
# Ops Netx 纳管网元作业手册
|
||||
|
||||
## 强制使用范围
|
||||
|
||||
凡是需要在 **netx 网元管理** 中已录入的设备上**登录并查询**(show/display/ping 等)时,必须加载并遵循本技能。
|
||||
|
||||
与 UME 网元清单(`ops-netx-ume-playbook`)不同:本手册针对 **SSH/Telnet 纳管设备**(含 ZTE/华为/思科跳板),不是 UME REST 同步清单。
|
||||
|
||||
## 工具选择顺序
|
||||
|
||||
1. **定位设备**
|
||||
- `netx_list_managed_ne`:`keyword`(名称/IP)、`connect_status=pass` 过滤
|
||||
- `netx_get_managed_ne`:单条详情、`connect_detail`(连通失败排障)
|
||||
2. **登录查信息**
|
||||
- `netx_exec_managed_ne`:`ne_id` + `commands`(最多 5 条只读命令)
|
||||
|
||||
## CLI 约束(服务端强制)
|
||||
|
||||
- 允许前缀:`show `、`display `、`get `、`ping `、`traceroute `、`terminal length `、`?`
|
||||
- 禁止:`|`、`;`、换行拼接、改配置类(configure/write/copy/reload/delete 等)
|
||||
- 示例:
|
||||
- 思科:`show version`、`show configuration | include hostname` **不可**(含 `|`)→ 改用 `show configuration` 或连通测试已解析的 hostname
|
||||
- 华为:`display version`、`display interface brief`
|
||||
- ZTE:`show version`、`show interface`
|
||||
|
||||
## 排障流程
|
||||
|
||||
1. `connect_status` 为 `fail`:先 `netx_get_managed_ne` 阅读 `connect_detail`,勿反复盲 exec
|
||||
2. 设备经跳板:详情中确认 `hop_enabled`、`hop_vendor`、模板是否正确
|
||||
3. 超时:对慢命令提高 `read_timeout_sec`(最大 120),或减少单次命令条数
|
||||
|
||||
## 输出约定
|
||||
|
||||
- 结论 + **工具返回 output 摘录**(勿编造 CLI 结果)
|
||||
- 标明 `ip_address`、`name`、`ne_id`(对用户展示优先 name/IP,ne_id 作关联键)
|
||||
- 英文会话:用户可见回复不得含汉字(CLI 原文可摘录但需说明为设备原文)
|
||||
Loading…
Add table
Add a link
Reference in a new issue