netbox-reconcile 是一个网络源真值（Source of Truth）核对技能，用于将 NetBox 中记录的预期状态与设备上的真实运行状态进行比对。NetBox 可读写，但核对时差异会先上报并开票，未经人工明确批准绝不自动修正；授权后 NetClaw 可更新 NetBox。
主要能力：检测并分级记录差异。IP_DRIFT（严重）：设备 IP 与 NetBox 分配不一致；MISSING_INTERFACE（高）：接口仅在 NetBox 或设备一方存在；UNDOCUMENTED_LINK（高）：CDP/LLDP 发现的邻居连接未记录在 NetBox 线缆中；CABLE_MISMATCH（高）：NetBox 线缆端点与 CDP/LLDP 邻居数据不符；VLAN_MISMATCH（中）：设备 VLAN 分配与 NetBox 不同；STATUS_MISMATCH（中）：接口启用状态不一致；MTU_MISMATCH（低）：MTU 不同。严重级别顺序为 CRITICAL > HIGH > MEDIUM > LOW。
使用方式：通过 NetBox MCP 与 pyATS MCP 采集数据，命令形如 python3 $MCP_CALL "python3 -u $NETBOX_MCP_SCRIPT" netbox_get_objects '{"object_type":"dcim.devices","filters":{"status":"active"},"brief":true}'，以及 PYATS_TESTBED_PATH=$PYATS_TESTBED_PATH python3 $MCP_CALL "${PYATS_PYTHON:-python3} -u $PYATS_MCP_SCRIPT" pyats_run_show_command '{"device_name":"R1","command":"show ip interface brief"}'。流程为：采集 NetBox 意图与设备实况，跑差异引擎，生成按严重级别排序的报告，对 CRITICAL/HIGH 差异创建 ServiceNow 事件，生成 Markmap 漂移脑图，并记录到 GAIT 审计轨迹；可对清单内全部设备批量核对并汇总车队状态。
适用场景：定期源真值校验、变更后核对、故障排查、新设备上线核对、审计合规。
限制：NetBox 读写但核对不自动改；工具需认证，脚本路径与环境变量需正确设置；工具报错时如实报告，不猜测结果；对改变状态或发送消息的调用，超时不能判定失败，须先检查状态再重试并保留审批门槛。具体收费、价格与平台支持资料暂未提供。