前言¶

做弱电或运维的人大概率遇到过这类问题：客户说「画面卡」「晚上时好时坏」「录像机里找不到某一路」，现象分散在摄像头、交换机、供电、硬盘多个环节，靠经验逐段猜，很耗时间。这个 Skill 的价值在于把常见的排查路径整理成可复用的步骤，让 Agent 按链路顺序往下走，而不是凭感觉给建议。

下面介绍「监控系统排障向导」这个 Skill。

这是什么¶

监控系统排障向导（@user_7a5540f4/surveillance-troubleshooter）是一个社区维护的 Skill，版本 1.0.1，分类 it-ops-security，发布者为 user_7a5540f4，标签 requires_api_key=false，即不需要额外 API Key。

它定位为视频监控、安防报警、智能楼宇、网络视频录像的全场景排障手册，覆盖 NVR/VCR/DVR、网络交换机、电源、网线、光纤、硬盘、摄像头全链路。

一个值得注意的机制是：它优先连接 IMA 知识库《弱电智能化AI》做 RAG 推理，知识库未命中时才回退到通用知识。这意味着命中知识库时，结论有更具体的行业依据，而不是通用泛答。

核心功能¶

按官方简介，能力集中在以下几个方面：

• 设备覆盖：海康、大华、宇视等主流厂商设备，以及 ONVIF 协议、PoE 供电等通用接口与供电方式。
• 现象排查：画面卡顿、黑屏、丢帧、时好时坏等典型问题，逐项给出排查路径。
• 链路覆盖：从摄像头到录像机，中间经过网络交换机、网线、光纤、电源、硬盘，全链路都可作为排查节点。
• 知识来源：优先走 IMA 知识库《弱电智能化AI》的 RAG 推理，未命中再回退通识。

安装与启用¶

官方抓取资料中未给出具体的安装命令或配置字段，因此这里不臆造命令。Skill 以通用 SKILL.md 格式分发，获取与启用方式如下：

• 坐标：@user_7a5540f4/surveillance-troubleshooter
• 分类：it-ops-security
• 来源：community
• 标签：requires_api_key=false

在支持按坐标拉取 Skill 的 Agent 环境（如 Cursor、Codex CLI、Claude Code）中，用上述坐标引用即可。具体安装命令请以 SkillHub 页面为准；不同环境的命令可能有差异，资料未覆盖到的部分不做断言。

典型用法¶

官方简介没有提供逐字可复现的调用示例，下面按 Skill 的能力范围描述典型使用方式：

1、描述现象。例如「4 路画面偶尔黑屏，白天正常」，把设备型号、时间规律、影响范围一起给到 Agent。
2、让 Agent 按链路顺序排查。从摄像头供电（PoE 还是独立电源）开始，再到网线/光纤质量、交换机端口与带宽、NVR/DVR 的硬盘状态与编码配置，逐段确认。
3、针对厂商差异追问。海康、大华、宇视的配置入口和默认行为不同，向 Agent 明确厂商，避免拿到不适用的建议。
4、核对结论。命中知识库的推理结果通常会引用具体配置项，据此在设备上复核，而不是直接照做。

适用场景与注意¶

适合谁：弱电智能化工程师、安防运维人员，以及需要处理监控系统一线问题的 Agent 使用者。

注意点：

• 资料中显示安装数为 0，说明它还没有大规模实战验证，建议先把结论与厂商文档或现场实测对照。
• RAG 未命中时回退通识，通用建议不一定适用于具体项目，关键配置仍需以实际设备为准。
• 全链路排查涉及硬件层（供电、线缆、硬盘），Agent 只能给排查方向，现场测量和替换仍需人工执行。
• 涉及 ONVIF、PoE 等协议层时，注意网络环境与设备固件版本，协议行为与版本相关。

结尾¶

这个 Skill 的价值在于把监控系统排障从「凭经验猜」变成「按链路走」，并且用 IMA 知识库做优先推理来源，比纯通识回答更贴近现场。适合作为一线排查的起点，最终结论仍需与设备实测对照。

官方地址：https://www.skillhub.cn/skills/user_7a5540f4/surveillance-troubleshooter