net

Q: What does the net skill do?

嵌入式网络调试工具，用于发现接口、抓包、分析 pcap/pcapng、做连通性测试、端口扫描和流量统计。 当用户提到 Wireshark、tshark、Npcap、抓包、网络联调、端口扫描、连通性排查、pcap 分析、 网络接口、ping 测试、traceroute、流量统计、Modbus TCP、EtherNet/IP 等网络协议调试时自动触发， 也兼容 /net 显式调用。即使用户只是说"抓个包看看"、"扫一下端口"、"网络通不通"或"分析一下这个 pcap"， 只要上下文中出现具体工具名（tshark、Wireshark、Npcap）、协议名（Modbus TCP、EtherNet/IP、ICMP 等）、 调试动作（抓包、端口扫描、连通性测试、ping、traceroute、流量统计、pcap 分析）或网络接口操作，就应触发此 skill。

Q: How do I install net?

Run npx skills add https://github.com/zhinkgit/embeddedskills --skill net in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/net/ (personal) or .claude/skills/net/ (project).

by zhinkgit

嵌入式网络调试工具，用于发现接口、抓包、分析 pcap/pcapng、做连通性测试、端口扫描和流量统计。当用户提到 Wireshark、tshark、Npcap、抓包、网络联调、端口扫描、连通性排查、pcap 分析、网络接口、ping 测试、traceroute、流量统计、Modbus TCP、EtherNet/IP 等网络协议调试时自动触发，也兼容 /net 显式调用。即使用户只是说"抓个包看看"、"扫一下端口"、"网络通不通"或"分析一下这个 pcap"，只要上下文中出现具体工具名（tshark、Wireshark、Npcap）、协议名（Modbus TCP、EtherNet/IP、ICMP 等）、调试动作（抓包、端口扫描、连通性测试、ping、traceroute、流量统计、pcap 分析）或网络接口操作，就应触发此 skill。

Installs: 635
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/zhinkgit/embeddedskills --skill net

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads net automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Net Debug Skill

嵌入式网络通信调试工具，统一封装接口发现、抓包、离线分析、连通性测试、端口扫描和流量统计能力。

脚本与配置路径

脚本目录: <skill-dir>/scripts/
环境级配置: <skill-dir>/config.json（仅工具路径）
工程级配置: <workspace>/.embeddedskills/config.json（网络参数）
协议参考: <skill-dir>/references/common_protocols.json

依赖

tshark (随 Wireshark 安装，需加入 PATH)
dumpcap (随 Wireshark 安装)
可选: capinfos
Windows 自带: ipconfig、ping、tracert、netstat、arp、nslookup
Linux 接口枚举 / ICMP ping / 路由追踪分别需要 iproute2（ip）、iputils-ping（ping）、traceroute；这三项功能仅支持 Windows / Linux
Python 3.x (仅标准库)
抓包需要 Npcap 驱动，部分环境需管理员权限

配置

环境级配置 (`skill/config.json`)

仅保留工具路径相关的环境级配置：

{
  "tshark_exe": "tshark",
  "capinfos_exe": "capinfos"
}

工程级配置 (`.embeddedskills/config.json`)

工作区下的 .embeddedskills/config.json 存放工程级网络配置：

{
  "net": {
    "interface": "",
    "target": "",
    "capture_filter": "",
    "display_filter": "",
    "duration": 30,
    "timeout_ms": 1000,
    "scan_ports": "",
    "capture_format": "pcapng",
    "log_dir": ".embeddedskills/logs/net"
  }
}

参数解析优先级

CLI 参数 (--interface, --target 等) - 最高优先级
工程级配置 (.embeddedskills/config.json 中的 net 部分)
状态文件 (.embeddedskills/state.json 中的历史记录)
默认值 - 最低优先级

连接和采集参数按优先级解析，脚本通过 CLI 参数接收覆盖值。若配置缺少必要项或连接失败，询问用户并引导修改配置。

执行流程

检查 tshark 是否可用；若不可用，提示用户安装 Wireshark（含 tshark）并确认已加入 PATH；若需要抓包，还需提示安装 Npcap 驱动；依赖缺失时终止执行并输出 status: error 及安装指引
按优先级解析参数：CLI > 工程级配置 > 状态文件 > 默认值；若多个来源对同一参数均有值，以更高优先级来源为准，并在输出 summary 中注明被覆盖的来源
若无子命令，默认执行 iface（列出网络接口）
成功执行后，将确认的参数写回工程配置
运行对应脚本并输出结构化 JSON 结果
失败时优先提示权限、Npcap、过滤器、接口选择等问题

子命令

iface — 列出网络接口

python <skill-dir>/scripts/net_iface.py [--filter <关键词>] [--tshark] [--json]

--tshark: 同时显示 tshark 抓包接口索引映射
--filter: 按关键词筛选接口
无副作用，可直接执行

capture — 抓包

python <skill-dir>/scripts/net_capture.py [--interface <接口>] [--duration <秒>] [--capture-filter <过滤器>] [--display-filter <过滤器>] [--output <文件路径>] [--format <pcapng|pcap>] [--decode-as <规则>] [--json]

接口、过滤器、时长按优先级解析
--interface: 抓包接口（覆盖配置）
--duration: 抓包时长（覆盖配置）
--capture-filter: BPF 抓包过滤器（覆盖配置）
--display-filter: Wireshark 显示过滤器（覆盖配置）
--output: 保存抓包文件路径
--json: 输出 JSON Lines 格式（基于 tshark -T ek）
--decode-as: 自定义解码规则
默认格式 pcapng，参数完整后直接执行

analyze — 分析 pcap 文件

python <skill-dir>/scripts/net_analyze.py <pcap_file> [--mode <summary|protocols|conversations|endpoints|io|anomalies|all>] [--filter <显示过滤器>] [--top <数量>] [--decode-as <规则>] [--export-fields <字段列表>] [--output <CSV路径>] [--json]

基于 tshark 和 capinfos 进行离线分析
--mode all 输出全部分析维度
无副作用，可直接执行

ping — 连通性测试

python <skill-dir>/scripts/net_ping.py [--target <目标>] [--tcp <端口>] [--count <次数>] [--traceroute] [--concurrent <线程数>] [--timeout <毫秒>] [--json]

目标按优先级解析
--target: 目标地址（覆盖配置）
--tcp: TCP 连通性测试（指定端口）
--traceroute: 执行路由追踪
--timeout: 超时毫秒数（覆盖配置）
参数完整后直接执行

scan — 端口扫描

python <skill-dir>/scripts/net_scan.py [--target <目标>] [--ports <端口范围>] [--timeout <毫秒>] [--banner] [--concurrent <线程数>] [--json]

目标和端口范围按优先级解析
--target: 目标地址（覆盖配置）
--ports: 端口范围，如 '80,443,8000-8100'（覆盖配置）
--banner: 尝试获取服务 Banner
默认收敛到嵌入式常用端口集
参数完整后直接执行

stats — 流量统计

python <skill-dir>/scripts/net_stats.py [--interface <接口>] [--duration <秒>] [--display-filter <过滤器>] [--interval <秒>] [--mode <overview|protocol|endpoint|port>] [--json]

接口和时长按优先级解析
--interface: 抓包接口（覆盖配置）
--duration: 统计时长（覆盖配置）
--display-filter: Wireshark 显示过滤器（覆盖配置）
默认输出按时段汇总的 JSON
无副作用，可直接执行

输出格式

所有脚本输出统一的 JSON 结构:

{
  "status": "ok",
  "action": "<子命令名>",
  "summary": "<简要描述>",
  "details": { ... }
}

错误时:

{
  "status": "error",
  "action": "<子命令名>",
  "error": {
    "code": "<错误码>",
    "message": "<错误描述>"
  }
}

capture --json 输出 JSON Lines，进度信息写入 stderr。

交互策略

按优先级解析参数：CLI > 工程级配置 > 状态文件 > 默认值
优先用解析后的参数直接执行，不额外询问
连接失败时再询问用户并引导修改配置
成功执行后，确认的参数自动写回 .embeddedskills/config.json
未给扫描范围时默认收敛到单主机、小范围端口
结果中明确回显目标范围、过滤器和持续时间
抓包结果优先总结异常协议、重传、RST 等
抓包失败优先提示权限和 Npcap 问题

协议参考

需要查询嵌入式常用端口和协议映射时，读取 references/common_protocols.json。

FAQ

What does the net skill do?

How do I install net?

Run npx skills add https://github.com/zhinkgit/embeddedskills --skill net in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/net/ (personal) or .claude/skills/net/ (project).

Which AI agents can use net?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is net safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains net?

It is published by zhinkgit in zhinkgit/embeddedskills. It has 635 recorded installs.

More from zhinkgit/embeddedskills

View all →

keil

zhinkgit/embeddedskills

Keil MDK 工程构建工具，用于扫描 .uvprojx/.uvproj/.uvmpw 工程、枚举 Target、执行 build/rebuild/clean 并解析构建日志，返回可供 jlink/openocd 复用的产物路径。 flash 子命令仅作为兼容入口保留。当用户提到 Keil、MDK、uVision、UV4、 Target 枚举、编译、重建、清理、烧录、下载固件、flash 时自动触发，也兼容 /keil 显式调用。即使用户只是说"编译一下"或"烧录到板子上"，只要上下文涉及嵌入式 Keil 工程就应触发此 skill。

870 installs

serial

zhinkgit/embeddedskills

嵌入式串口调试工具，用于扫描串口、实时监控、发送数据、记录日志和 Hex 查看。当用户提到串口、COM 口、UART、AT 命令调试、波特率、Hex 串流、串口抓日志、串口监控、查看 MCU 输出、二进制协议联调时自动触发，也兼容 /serial 显式调用。即使用户只是说"看看串口输出"、"发个 AT 命令"或"抓一下日志"，只要上下文涉及串口通信就应触发此 skill。

814 installs

can

zhinkgit/embeddedskills

嵌入式 CAN / CAN-FD 调试工具，用于扫描接口、监控报文、发送测试帧、记录日志、数据库文件解码和总线统计。当用户提到 CAN、CAN-FD、DBC 解码、总线抓包、USB-CAN 联调、报文发送、总线统计、 PCAN、Vector、slcan、CAN 接口扫描、CAN ID 过滤、ASC 日志、BLF 文件时自动触发，也兼容 /can 显式调用。即使用户只是说"看看 CAN 报文"、"发一帧试试"或"解码一下 DBC"，只要上下文明确提到 CAN 总线通信的操作或问题就应触发此 skill。

720 installs

jlink

zhinkgit/embeddedskills

J-Link 下载与在线调试工具，用于探测设备、烧录固件、读写内存、查看寄存器、复位目标、读取 RTT/SWO 日志，以及在线调试（暂停/恢复/单步/断点运行/调用栈/变量查看）。当用户提到 J-Link、JLink、RTT、烧录固件、写内存、读内存、寄存器查看、目标复位、探针连通性检查、在线调试、单步、断点、调用栈时自动触发，也兼容 /jlink 显式调用。即使用户只是说"烧录一下"、"看看 RTT 输出"或"调试一下"，只要上下文涉及 J-Link 探针就应触发此 skill。

683 installs

openocd

zhinkgit/embeddedskills

OpenOCD 下载与调试工具，用于探针探测、固件烧录、Flash 擦除、GDB Server 启动、目标复位控制、 Telnet 在线调试（halt/resume/step/寄存器/内存/断点）、GDB 源码级调试，以及 Semihosting/ITM 输出捕获和底层查询。当用户提到 OpenOCD、ST-Link、CMSIS-DAP、DAPLink、FTDI、烧录固件、擦除 Flash、GDB Server、 reset、interface/target/board 配置、openocd.cfg、在线调试、单步、断点、寄存器查看、内存读写、semihosting 时自动触发，也兼容 /openocd 显式调用。即使用户只是说"烧录一下"、"启动 GDB Server"、"擦除芯片"、"看看寄存器"、"单步调试" 或"抓一下 semihosting"，只要上下文涉及 OpenOCD 支持的开源调试器就应触发此 skill。

Backend & APIs673 installs

gcc

zhinkgit/embeddedskills

GCC 嵌入式工程构建工具（CMake + arm-none-eabi-gcc），用于扫描 CMake 型嵌入式工程、列出预设、配置、编译、重建、清理和分析 ELF 大小。当用户提到 GCC、arm-none-eabi、 CMake 嵌入式编译、Ninja 构建、ELF 大小分析、arm-gcc、交叉编译、cmake --build、 cmake --preset 时自动触发，也兼容 /gcc 显式调用。即使用户只是说"编译一下"或 "看看固件多大"，只要上下文涉及 CMake 嵌入式 GCC 工程就应触发此 skill。

667 installs

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs

net

Install

Install

Describe the task

Review the result

SKILL.md

Net Debug Skill

脚本与配置路径

依赖

配置

环境级配置 (skill/config.json)

工程级配置 (.embeddedskills/config.json)

参数解析优先级

执行流程

子命令

iface — 列出网络接口

capture — 抓包

analyze — 分析 pcap 文件

ping — 连通性测试

scan — 端口扫描

stats — 流量统计

输出格式

交互策略

协议参考

FAQ

More from zhinkgit/embeddedskills

Popular other skills

环境级配置 (`skill/config.json`)

工程级配置 (`.embeddedskills/config.json`)