Menu
网络设备运维自动化技能。此技能应在需要对网络设备（华为、H3C、思科、锐捷等）进行运维操作时使用，包括SSH/Telnet/串口连接、配置管理、故障诊断、健康巡检、批量操作等场景。支持交互式输入连接信息，适用于日常运维、批量管理、故障应急处理和自动化巡检任务。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | network-device-automation |
| description | 网络设备运维自动化技能。此技能应在需要对网络设备（华为、H3C、思科、锐捷等）进行运维操作时使用，包括SSH/Telnet/串口连接、配置管理、故障诊断、健康巡检、批量操作等场景。支持交互式输入连接信息，适用于日常运维、批量管理、故障应急处理和自动化巡检任务。 |
本技能提供网络设备自动化运维能力，支持主流网络设备厂商的统一管理。
本技能用于网络设备的自动化运维操作，包括但不限于：
scripts/
├── 【核心层】基础组件
│ ├── base_executor.py # 执行器基类（命令帮助查询）
│ ├── asset_manager.py # 资产台账管理器
│ └── experience_manager.py # 经验库管理器
│
├── 【执行层】厂商专属执行器
│ ├── h3c_executor.py # H3C设备执行器
│ ├── huawei_executor.py # 华为设备执行器
│ ├── cisco_executor.py # 思科设备执行器
│ └── ruijie_executor.py # 锐捷设备执行器
│
└── 【应用层】业务功能
├── config_backup.py # 配置备份/恢复
├── health_check.py # 健康检查/巡检
└── batch_manager.py # 批量操作
本技能集成了资产台账功能，支持提前录入设备信息，使用时自动查找匹配，大幅节省token。
使用资产管理器管理设备资产：
python scripts/asset_manager.py <命令> [参数...]
可用命令:
| 命令 | 说明 | 示例 |
|---|---|---|
list [分组] [标签] | 列出所有设备 | list core |
find <IP|名称> | 查找设备 | find 192.168.1.1 |
add | 添加新设备（交互式） | add |
update <设备ID> | 更新设备信息 | update core-sw-01 |
delete <设备ID> | 删除设备 | delete core-sw-01 |
export [文件] | 导出为JSON | export backup.json |
import <文件> | 从JSON导入 | import backup.json |
groups | 列出所有分组 | groups |
资产台账支持多字段智能匹配：
host 字段host 字段name 字段name 或 description 字段资产台账文件位置: assets/inventory.yaml
devices:
core-sw-01:
name: "核心交换机-01"
host: "192.168.1.1"
device_type: "hp_comware"
vendor: "H3C"
model: "S6850"
username: "admin"
password: "" # base64编码，留空则交互式输入
port: 22
enable_password: ""
group: "core"
description: "核心交换机-机房A"
location: "机房A-机柜01"
contact: "张三"
tags: ["core", "production"]
created_at: "2025-01-17"
updated_at: "2025-01-17"
每个厂商都有专属的执行器，负责连接设备并执行命令。执行器自动集成经验库，处理已知问题。
# 优先使用资产台账查找（推荐，节省token）
python scripts/<vendor>_executor.py --device <设备标识> --commands "<命令1>" "<命令2>"
# 降级使用显式连接参数
python scripts/<vendor>_executor.py --host <IP> --username <用户> --password <密码> --commands "<命令1>"
# 从资产台账查找
python scripts/h3c_executor.py --device 192.168.56.3 --commands "display version" "display vlan"
# 显式连接参数
python scripts/h3c_executor.py --host 192.168.56.3 --username admin --password xxx --commands "display version"
# 从JSON文件读取命令
echo '["display version", "display vlan"]' | python scripts/h3c_executor.py --device 192.168.56.3 --commands-json -
# 保存结果到文件
python scripts/h3c_executor.py --device 192.168.56.3 --commands "display version" --output result.json
# 查询命令帮助
python scripts/h3c_executor.py --host 10.0.254.2 --username admin --password xxx \
--query-help "undo nat server protocol tcp global current-interface"
# 命令失败时自动查询帮助
python scripts/h3c_executor.py --host 10.0.254.2 --username admin --password xxx \
--commands "display version" --auto-help
H3C执行器特点：
invoke_shell 模式（更稳定）---- More ----）save 命令（添加 force 参数）--query-help 查询语法，--auto-help 失败时自动查询）# 执行命令
python scripts/huawei_executor.py --device 192.168.1.1 --commands "display version" "display vlan"
# 查询命令帮助
python scripts/huawei_executor.py --host 192.168.1.1 --username admin --password xxx \
--query-help "undo nat"
# 命令失败时自动查询帮助
python scripts/huawei_executor.py --device 192.168.1.1 --commands "display version" --auto-help
华为执行器特点：
invoke_shell 模式---- More ----）--query-help / --auto-help）# 执行命令
python scripts/cisco_executor.py --device 192.168.1.1 --commands "show version" "show vlan brief"
# 查询命令帮助
python scripts/cisco_executor.py --host 192.168.1.1 --username admin --password xxx \
--query-help "no ip nat"
# 命令失败时自动查询帮助
python scripts/cisco_executor.py --device 192.168.1.1 --commands "show version" --auto-help
思科执行器特点：
invoke_shell 模式--More--）enable 密码show vs display）--query-help / --auto-help）# 执行命令
python scripts/ruijie_executor.py --device 192.168.1.1 --commands "show version" "show vlan"
# 查询命令帮助
python scripts/ruijie_executor.py --host 192.168.1.1 --username admin --password xxx \
--query-help "no ip nat"
# 命令失败时自动查询帮助
python scripts/ruijie_executor.py --device 192.168.1.1 --commands "show version" --auto-help
锐捷执行器特点：
invoke_shell 模式--More-- / ---- More ----）--query-help / --auto-help）# 直接指定串口
python scripts/serial_executor.py --port COM3 --commands "display version" "display interface brief"
# 从资产台账查找串口设备
python scripts/serial_executor.py --device sw-console --commands "show running-config"
# 指定波特率 + 多厂商命令（华为/思科/H3C 通用）
python scripts/serial_executor.py --port COM3 --baud 9600 --commands "show ip route"
# 遇错中断（默认每条都执行）
python scripts/serial_executor.py --port COM3 --commands "show version" --stop-on-error
串口执行器特点：
---- More ----、思科 --More--[Y/N]、支持多行命令（\n 自动转 \r\n）--device/--commands，返回 JSON）device_type: serial、port: COM3、baud_rate: 9600Error/Invalid/Unrecognized 等标记 error 字段）资产台账串口设备示例：
devices:
sw-console:
name: "S220-console"
device_type: serial
port: COM3
baud_rate: 9600
vendor: huawei
description: "S220 交换机 console 口"
所有执行器统一返回JSON格式：
{
"success": true,
"executed": 2,
"total": 3,
"failed_at": null,
"results": [
{
"command": "display version",
"success": true,
"output": "H3C Comware Software...",
"error": null,
"help": null
},
{
"command": "display vlan",
"success": false,
"output": "% Error: Unrecognized command",
"error": "命令执行错误: Unrecognized command",
"help": "display vlan ?\r\n vpn-instance Specify a VPN instance\r\n..."
}
]
}
字段说明：
command: 执行的命令success: 是否成功output: 命令输出error: 错误信息（如有）help: 帮助信息（使用 --auto-help 时自动获取）用户需求
│
▼
大模型生成命令列表
│
▼
根据设备类型选择对应厂商执行器
│
▼
执行器逐条执行命令
│
├─ 成功 → 继续下一条
│
└─ 失败 → 中断，返回错误
│
▼
是否启用 auto-help？
│
┌─────┴─────┐
▼ ▼
是 否
│ │
▼ ▼
自动查询帮助 直接返回错误
│ │
└─────┬─────┘
▼
大模型接收错误/帮助
│
▼
查询经验库处理方法
│
┌─────┴─────┐
▼ ▼
有经验 无经验
│ │
▼ ▼
应用方案 尝试解决
│ │
└─────┬─────┘
▼
修改命令后重试
│
▼
如果是脚本问题
│
▼
修改执行器代码
执行器支持智能查找设备信息：
用户调用: --device 192.168.56.3
│
▼
查询资产台账
│
├─ 找到设备 ─────────────────────────────────┐
│ │ │
│ ▼ │
│ 检查密码是否存储 │
│ │ │
│ ├─ 已存储 ─────────────────────────────┐ │
│ │ │ │
│ └─ 未存储 → 交互式输入密码 │ │
│ │ │
└─ 未找到 → 提示用户选择: │ │
1. 添加到台账 │ │
2. 使用显式参数(--host/--username) │ │
│ │
┌────────────────────────────────────────┘ │
│ │
▼ ▼
使用台账信息连接 使用显式参数连接
备份、恢复或对比设备配置：
python scripts/config_backup.py
功能：
执行设备健康检查和自动巡检：
python scripts/health_check.py
检查项目包括：
巡检结果输出为结构化报告，支持JSON和Markdown格式。
对多台设备执行相同操作：
python scripts/batch_manager.py
使用场景：
经验库记录实际遇到的问题和解决方案，执行器会自动应用相关经验。
experiences/
├── index.json # 经验索引
├── 001_command_execution.json # H3C使用exec_command超时
├── 002_pagination.json # 分页处理
├── 003_encoding.json # Windows编码问题
└── 004_script_error.json # save命令force参数
# 查看所有经验
python scripts/experience_manager.py
# 搜索经验
python scripts/experience_manager.py --search "timeout"
# 添加新经验（交互式）
python scripts/experience_manager.py --add
# 导出为Markdown
python scripts/experience_manager.py --export experiences.md
| ID | 问题 | 解决方案 |
|---|---|---|
| 001 | H3C使用exec_command超时 | 使用invoke_shell() |
| 002 | 配置显示不完整 | 自动处理分页 |
| 003 | Windows编码错误 | 使用errors='ignore' |
| 004 | save命令执行失败 | 自动添加force参数 |
查看 references/vendor_commands.md 获取：
查看 references/troubleshooting_guide.md 获取：
查看 references/inspection_checklist.md 获取：
用户: 添加一台新的核心交换机到资产台账
操作: python scripts/asset_manager.py add
交互式输入设备信息（IP、类型、用户名等）
系统自动保存到 assets/inventory.yaml
用户: 查询H3C核心交换机的版本信息
操作: python scripts/h3c_executor.py --device 核心交换机-01 --commands "display version"
系统自动从资产台账查找并获取连接信息
直接建立连接并执行命令
用户: 查询交换机192.168.1.1的所有接口状态
操作: python scripts/huawei_executor.py --device 192.168.1.1 --commands "display interface brief"
系统从台账自动匹配设备并连接
执行命令并返回结果
用户: 对核心交换机进行健康检查
操作: python scripts/health_check.py
连接设备后执行全面检查
生成巡检报告
用户: 备份所有核心分组交换机配置
操作: python scripts/batch_manager.py core
批量执行config_backup.py
按日期归档备份文件
用户: 查找所有位于机房A的设备
操作: python scripts/asset_manager.py find 机房A
用户: 核心链路中断，快速诊断问题
操作: python scripts/h3c_executor.py --device 核心交换机-01 --commands "display interface brief" "display ip routing-table"
使用troubleshooting_guide.md指导排查流程
逐层检查物理链路→接口状态→路由→邻居关系
用户: 不确定如何正确删除NAT映射
操作: python scripts/h3c_executor.py --host 10.0.254.2 --username admin --password xxx \
--query-help "undo nat server protocol tcp global current-interface"
返回命令语法和可选参数，帮助生成正确的命令
用户: 执行可能出错的命令，需要自动获取帮助信息
操作: python scripts/h3c_executor.py --host 10.0.254.2 --username admin --password xxx \
--commands "display nat xxxx" --auto-help
命令失败时自动查询帮助，在返回结果的 help 字段中包含语法提示
所有脚本依赖以下Python库：
安装依赖：
pip install paramiko pyyaml rich
安全性
可靠性
show run/display current-configuration 备份可追溯性
错误处理