---
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与工具脚本/      # 命令速查与探索方法（通用总结）
    └── 07_现场真实案例库/         # 私有：现场报告/值班真实案例（一事一记）
```

**分层原则**：`01`–`06` 放总结后的通用网络知识；**`07` 专放私有现场真实案例**（可含项目侧信息，引用时注意脱敏表述）。

## 检索工具与顺序

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`）
   - 优先读：`07_现场真实案例库`（私有现场）→ `04_历史故障案例库`（教材化）→ `01_协议排障逻辑树` → `06_标准SOP` → `03_配置规范` → `02_产品平台特性`
   - `07` 仅引用状态为 `reviewed` 的案例；`draft` / `_staging` 不得当正式依据
4. **现场验证**（强制，不可跳过）：
   - 知识库给出的是「检查什么、期望什么」；**必须用 netx MCP 在真实网元上验证**
   - 纳管设备：`ops-netx-managed-ne-playbook` → `mcp__netx__execManagedNe`
   - 告警关联：`ops-netx-ume-playbook` → 查相关网元/告警上下文
5. **输出**：结论 + **知识库引用路径** + **CLI/MCP 证据摘录** + 最小修复步骤

### 检索失败时

- 明确告知「知识库暂无命中」，不得编造案例编号或根因
- 改用 `06_标准SOP与工具脚本/命令探索方法论.md` 指导现场 `?` 探索
- 排障闭环后，建议用户将**现场真实记录**沉淀到 `07_现场真实案例库`；稳定规律再提炼进 `01`–`06` / `04`（勿擅自写入，除非用户明确要求）

## 层级速查

| 用户意图 | 优先目录 | 典型关键词 |
|----------|----------|------------|
| 怎么排查 / 为什么这样 | `01_协议排障逻辑树/` | 邻居、标签、NULL、选路、泄露 |
| 命令不认识 / 版本差异 | `02_产品平台特性/` | access-fec、5800、ReleaseNotes |
| 应该怎么配 | `03_配置规范与基线/` | 基线、规范、Option-B、模板 |
| 以前遇到过吗 / 根因是什么 | 先 `07_现场真实案例库/`，再 `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`