Add ops IP knowledge playbook for protocol troubleshooting.

Give the ops specialist a skill to search docs/ip-knowledge-base and verify findings via netx before concluding.

Co-authored-by: Cursor <cursoragent@cursor.com>

skills/_workspace/ops/ops-ip-knowledge-playbook/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: ops-ip-knowledge-playbook
+description: 面向 ops 专家的 IP 运维知识库作业手册。覆盖协议排障、配置规范、历史案例检索，并与 netx 实时证据联动验证。
+---
+
+# Ops IP 知识库作业手册
+
+## 强制使用范围
+
+凡是涉及以下主题的 ops 请求，**必须先加载并遵循本技能**，再下结论或给修复步骤：
+
+- 协议排障思路（BGP/OSPF/IS-IS/MPLS/LDP/VPN 等）：「为什么」「怎么查」「下一步看什么」
+- 配置规范与基线：「应该怎么配」「标准模板」「避坑」
+- 产品/平台特性：不认识的 CLI、版本 Bug、与友商对接差异
+- 历史故障案例：类似现象是否出现过、已知根因与修复
+- 监控阈值与 SOP：什么算异常、标准命令组合
+
+**不触发本技能**（改用对应 netx playbook）：
+
+- 仅查 UME 当前告警/网元清单 → `ops-netx-ume-playbook`
+- 仅需登录纳管设备执行 show/display → `ops-netx-managed-ne-playbook`
+
+可与上述 playbook **叠加使用**：知识库给假设与检查顺序，netx 给现场证据。
+
+## 知识库根路径
+
+```
+docs/ip-knowledge-base/
+└── zte/                          # 厂商分区（当前仅 zte）
+    ├── 01_协议排障逻辑树/         # If...Then 决策树
+    ├── 02_产品平台特性/           # 设备/版本特有知识（优先级最高）
+    ├── 03_配置规范与基线/         # 标准配置模板
+    ├── 04_历史故障案例库/         # 真实案例 + 推理链
+    ├── 05_监控指标与告警阈值/     # 量化异常标准
+    └── 06_标准SOP与工具脚本/      # 命令速查与探索方法
+```
+
+## 检索工具与顺序
+
+ops 专家可用 `search_files`、`read_file`、`list_directory`（路径相对于仓库根 `PROJECT_ROOT`）。
+
+### 标准流程（每次排障/配置咨询必走）
+
+1. **定位层级**：根据用户问题选目标目录（见下节「层级速查」）
+2. **关键词搜索**：
+   - `search_files(pattern=<协议/现象关键词>, root=docs/ip-knowledge-base, file_glob=**/*.md, regex=false)`
+   - 同时搜中文与英文缩写（如 `下一跳NULL`、`next-hop-self`、`access-fec`）
+3. **精读命中文件**：
+   - `read_file(path=docs/ip-knowledge-base/zte/...)`，大文件分段读（`offset`/`limit`）
+   - 优先读：`04_历史故障案例库` → `01_协议排障逻辑树` → `06_标准SOP` → `03_配置规范` → `02_产品平台特性`
+4. **现场验证**（强制，不可跳过）：
+   - 知识库给出的是「检查什么、期望什么」；**必须用 netx MCP 在真实网元上验证**
+   - 纳管设备：`ops-netx-managed-ne-playbook` → `mcp__netx__execManagedNe`
+   - 告警关联：`ops-netx-ume-playbook` → 查相关网元/告警上下文
+5. **输出**：结论 + **知识库引用路径** + **CLI/MCP 证据摘录** + 最小修复步骤
+
+### 检索失败时
+
+- 明确告知「知识库暂无命中」，不得编造案例编号或根因
+- 改用 `06_标准SOP与工具脚本/命令探索方法论.md` 指导现场 `?` 探索
+- 排障闭环后，建议用户将案例沉淀到 `04_历史故障案例库`（勿擅自写入，除非用户明确要求）
+
+## 层级速查
+
+| 用户意图 | 优先目录 | 典型关键词 |
+|----------|----------|------------|
+| 怎么排查 / 为什么这样 | `01_协议排障逻辑树/` | 邻居、标签、NULL、选路、泄露 |
+| 命令不认识 / 版本差异 | `02_产品平台特性/` | access-fec、5800、ReleaseNotes |
+| 应该怎么配 | `03_配置规范与基线/` | 基线、规范、Option-B、模板 |
+| 以前遇到过吗 / 根因是什么 | `04_历史故障案例库/` | 案例编号、故障日期、关键词标签 |
+| 多少算异常 / 要不要告警 | `05_监控指标与告警阈值/` | 阈值、超限、震荡 |
+| 具体敲什么命令 | `06_标准SOP与工具脚本/` | SOP、速查、命令探索 |
+
+## 与 netx 的协作原则（证据优先）
+
+```text
+用户问题
+  ├─ 需要当前设备状态？ → 先/并行 netx MCP（ROLE_SYSTEM：证据优先）
+  ├─ 需要排障思路或历史经验？ → 本技能检索 ip-knowledge-base
+  ├─ KB 命中逻辑树/案例？ → 按树逐步 exec CLI 验证每一步
+  └─ KB 无命中？ → 命令探索方法论 + 现场采集 → 建议沉淀案例
+```
+
+**禁止**：仅凭知识库或模型常识下结论，而不调 netx 拿证据。
+
+**禁止**：把 RFC/教科书大段复述给用户；知识库价值在于「本公司设备上的 If→Then 与实测案例」。
+
+## 输出约定
+
+- 必须包含：
+  - **结论**（一句话）
+  - **知识库依据**（文件相对路径，如 `docs/ip-knowledge-base/zte/04_.../BGP_跨域....md`）
+  - **现场证据**（netx 工具返回摘录；无证据时标明「未验证」）
+  - **下一步**（可执行的最小步骤）
+- 引用案例时带上案例元数据中的 `案例编号`、`关键词标签`（若有）
+- 修复步骤涉及配置变更：先说明影响范围与回滚，再给出命令（ROLE_SYSTEM 变更安全）
+- **用户用英文提问时**：回复不得含汉字；知识库中文内容须译成英文后再写入正文
+
+## 参考
+
+- 目录索引与检索示例：[reference.md](reference.md)
+- 命令在线探索：`docs/ip-knowledge-base/zte/06_标准SOP与工具脚本/命令探索方法论.md`