oclaw/skills/_workspace/ops/ops-ip-knowledge-playbook/reference.md

Ops IP 知识库快速参考

1) 根路径与工具参数

项	值
根目录	docs/ip-knowledge-base
当前厂商分区	zte/
搜索工具	search_files
阅读工具	read_file
列目录	list_directory

search_files 推荐参数：

{
  "pattern": "下一跳 NULL",
  "root": "docs/ip-knowledge-base",
  "file_glob": "**/*.md",
  "regex": false,
  "max_matches": 50
}

read_file 分段阅读（逻辑树/案例较长时）：

{
  "path": "docs/ip-knowledge-base/zte/01_协议排障逻辑树/BGP/VPN跨域标签异常排查树.md",
  "offset": 1,
  "limit": 120
}

2) 目录职责（01–06 通用总结 + 07 私有现场）

目录	内容性质	回答的问题	RAG 优先级（排障场景）
01_协议排障逻辑树	通用总结	怎么想	高（决策顺序）
02_产品平台特性	通用总结	设备特有行为	最高（模型不知道）
03_配置规范与基线	通用总结	应该怎么配	中
04_历史故障案例库	通用总结（脱敏教材版）	可复用的根因链模式	高
05_监控指标与告警阈值	通用总结	什么算异常	中（告警解读）
06_标准SOP与工具脚本	通用总结	敲什么命令	高（操作动作）
07_现场真实案例库	私有现场	本项目/本客户真实发生过什么	最高（现场相似度）

3) 当前已收录文档（截至维护时）

01 协议排障逻辑树

• zte/01_协议排障逻辑树/BGP/VPN跨域标签异常排查树.md

02 产品平台特性

• （占位，见目录 README）

03 配置规范与基线

• zte/03_配置规范与基线/LDP_配置基线.md
• zte/03_配置规范与基线/BGP_跨域配置规范.md

04 历史故障案例库（教材化）

• zte/04_历史故障案例库/BGP/标签与LDP类/BGP_跨域下一跳NULL_LDP策略与下一跳修复_20260720.md
  • 案例编号：BGP-CROSS-DOMAIN-001
  • 关键词：#下一跳NULL #LDP标签分配 #access-fec #next-hop-self

05 监控指标与告警阈值

• （占位，见目录 README）

06 标准 SOP 与工具脚本

• zte/06_标准SOP与工具脚本/故障处理常用命令.md
• zte/06_标准SOP与工具脚本/命令探索方法论.md

07 现场真实案例库（私有）

• 说明与入库约定：zte/07_现场真实案例库/README.md
• 模板：zte/07_现场真实案例库/_TEMPLATE.md
• 正式案例：（待从现场 PPT/PDF / 值班沉淀入库，仅引用 reviewed）

4) 按场景的检索关键词

场景	建议 pattern（可多次搜索）	预期命中层
VPN 跨域不通 / 下一跳 NULL	下一跳NULL、access-fec、next-hop-self、VPN跨域	07 + 01 + 04 + 03
MPLS 标签缺失 / Interface NULL	标签、mpls forwarding、LDP	01 + 04 + 06
BGP 跨域怎么配	Option-B、跨域配置、next-hop-self	03
不认识 LDP 命令	access-fec、ldp instance	02 + 03
命令忘了怎么敲	show bgp、命令探索	06
告警是否严重	阈值、超限	05

5) BGP 跨域排障推荐阅读顺序（示例）

1. search_files → 命中案例 BGP_跨域下一跳NULL...
2. read_file 案例 §1 现象 + §3 根因表
3. read_file VPN跨域标签异常排查树.md 对应 If 分支
4. read_file BGP_跨域配置规范.md 检查清单（若涉及配置修复）
5. mcp__netx__execManagedNe 按树执行验证命令（只读）
6. 输出：结论 + 案例路径 + CLI 摘录

6) 与 UME 告警联动（可选）

当用户从告警切入排障：

1. ops-netx-ume-playbook：定位网元 host_name、告警 event_type/native_probable_cause
2. 将告警关键词代入 search_files（如 BGP、LDP、Fan）
3. 若 05_监控指标与告警阈值 有对应阈值文档，对照是否真异常
4. 需要设备侧确认时切 ops-netx-managed-ne-playbook

7) 知识沉淀（闭环后）

排障结束且用户同意记录时：

1. 现场原貌 → 写入 07_现场真实案例库/（用 _TEMPLATE.md；先 draft，过审改 reviewed）
2. 稳定规律 → 再提炼进 01/02/03/06，或脱敏后写入 04_历史故障案例库/

07 案例建议字段：元数据（含源报告路径）、现象、排查过程表、根因、修复验证、可沉淀勾选。

配套产出：从 07 拆 01 逻辑树节点 + 06 三五步速查；勿把未脱敏客户细节写进 01–06。