mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-15 22:13:23 +08:00
oliver
9f2dba7a23
Keep 01-06 as summarized general knowledge; route on-site reports into 07 and update the ops playbook retrieval order. Co-authored-by: Cursor <cursoragent@cursor.com>
106 lines
5.9 KiB
Markdown
106 lines
5.9 KiB
Markdown
---
|
||
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`
|