mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-09 00:40:45 +08:00
Add private layer 07 for field real cases in IP knowledge base.
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>
This commit is contained in:
parent
07002caeb8
commit
9f2dba7a23
7 changed files with 160 additions and 32 deletions
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
name: ops-ip-knowledge-playbook
|
||||
description: 面向 ops 专家的 IP 运维知识库作业手册。覆盖协议排障、配置规范、历史案例检索,并与 netx 实时证据联动验证。
|
||||
description: 面向 ops 专家的 IP 运维知识库作业手册。覆盖协议排障、配置规范、教材化案例与私有现场案例库检索,并与 netx 实时证据联动验证。
|
||||
---
|
||||
|
||||
# Ops IP 知识库作业手册
|
||||
|
|
@ -12,7 +12,7 @@ description: 面向 ops 专家的 IP 运维知识库作业手册。覆盖协议
|
|||
- 协议排障思路(BGP/OSPF/IS-IS/MPLS/LDP/VPN 等):「为什么」「怎么查」「下一步看什么」
|
||||
- 配置规范与基线:「应该怎么配」「标准模板」「避坑」
|
||||
- 产品/平台特性:不认识的 CLI、版本 Bug、与友商对接差异
|
||||
- 历史故障案例:类似现象是否出现过、已知根因与修复
|
||||
- 历史/现场故障案例:类似现象是否出现过、已知根因与修复(含私有现场案例库)
|
||||
- 监控阈值与 SOP:什么算异常、标准命令组合
|
||||
|
||||
**不触发本技能**(改用对应 netx playbook):
|
||||
|
|
@ -27,14 +27,17 @@ description: 面向 ops 专家的 IP 运维知识库作业手册。覆盖协议
|
|||
```
|
||||
docs/ip-knowledge-base/
|
||||
└── zte/ # 厂商分区(当前仅 zte)
|
||||
├── 01_协议排障逻辑树/ # If...Then 决策树
|
||||
├── 02_产品平台特性/ # 设备/版本特有知识(优先级最高)
|
||||
├── 03_配置规范与基线/ # 标准配置模板
|
||||
├── 04_历史故障案例库/ # 真实案例 + 推理链
|
||||
├── 05_监控指标与告警阈值/ # 量化异常标准
|
||||
└── 06_标准SOP与工具脚本/ # 命令速查与探索方法
|
||||
├── 01_协议排障逻辑树/ # If...Then 决策树(通用总结)
|
||||
├── 02_产品平台特性/ # 设备/版本特有知识(通用总结)
|
||||
├── 03_配置规范与基线/ # 标准配置模板(通用总结)
|
||||
├── 04_历史故障案例库/ # 脱敏/教材化案例骨架(通用复用)
|
||||
├── 05_监控指标与告警阈值/ # 量化异常标准(通用总结)
|
||||
├── 06_标准SOP与工具脚本/ # 命令速查与探索方法(通用总结)
|
||||
└── 07_现场真实案例库/ # 私有:现场报告/值班真实案例(一事一记)
|
||||
```
|
||||
|
||||
**分层原则**:`01`–`06` 放总结后的通用网络知识;**`07` 专放私有现场真实案例**(可含项目侧信息,引用时注意脱敏表述)。
|
||||
|
||||
## 检索工具与顺序
|
||||
|
||||
ops 专家可用 `search_files`、`read_file`、`list_directory`(路径相对于仓库根 `PROJECT_ROOT`)。
|
||||
|
|
@ -47,7 +50,8 @@ ops 专家可用 `search_files`、`read_file`、`list_directory`(路径相对
|
|||
- 同时搜中文与英文缩写(如 `下一跳NULL`、`next-hop-self`、`access-fec`)
|
||||
3. **精读命中文件**:
|
||||
- `read_file(path=docs/ip-knowledge-base/zte/...)`,大文件分段读(`offset`/`limit`)
|
||||
- 优先读:`04_历史故障案例库` → `01_协议排障逻辑树` → `06_标准SOP` → `03_配置规范` → `02_产品平台特性`
|
||||
- 优先读:`07_现场真实案例库`(私有现场)→ `04_历史故障案例库`(教材化)→ `01_协议排障逻辑树` → `06_标准SOP` → `03_配置规范` → `02_产品平台特性`
|
||||
- `07` 仅引用状态为 `reviewed` 的案例;`draft` / `_staging` 不得当正式依据
|
||||
4. **现场验证**(强制,不可跳过):
|
||||
- 知识库给出的是「检查什么、期望什么」;**必须用 netx MCP 在真实网元上验证**
|
||||
- 纳管设备:`ops-netx-managed-ne-playbook` → `mcp__netx__execManagedNe`
|
||||
|
|
@ -58,7 +62,7 @@ ops 专家可用 `search_files`、`read_file`、`list_directory`(路径相对
|
|||
|
||||
- 明确告知「知识库暂无命中」,不得编造案例编号或根因
|
||||
- 改用 `06_标准SOP与工具脚本/命令探索方法论.md` 指导现场 `?` 探索
|
||||
- 排障闭环后,建议用户将案例沉淀到 `04_历史故障案例库`(勿擅自写入,除非用户明确要求)
|
||||
- 排障闭环后,建议用户将**现场真实记录**沉淀到 `07_现场真实案例库`;稳定规律再提炼进 `01`–`06` / `04`(勿擅自写入,除非用户明确要求)
|
||||
|
||||
## 层级速查
|
||||
|
||||
|
|
@ -67,7 +71,7 @@ ops 专家可用 `search_files`、`read_file`、`list_directory`(路径相对
|
|||
| 怎么排查 / 为什么这样 | `01_协议排障逻辑树/` | 邻居、标签、NULL、选路、泄露 |
|
||||
| 命令不认识 / 版本差异 | `02_产品平台特性/` | access-fec、5800、ReleaseNotes |
|
||||
| 应该怎么配 | `03_配置规范与基线/` | 基线、规范、Option-B、模板 |
|
||||
| 以前遇到过吗 / 根因是什么 | `04_历史故障案例库/` | 案例编号、故障日期、关键词标签 |
|
||||
| 以前遇到过吗 / 根因是什么 | 先 `07_现场真实案例库/`,再 `04_历史故障案例库/` | 案例编号、故障日期、关键词标签、源报告 |
|
||||
| 多少算异常 / 要不要告警 | `05_监控指标与告警阈值/` | 阈值、超限、震荡 |
|
||||
| 具体敲什么命令 | `06_标准SOP与工具脚本/` | SOP、速查、命令探索 |
|
||||
|
||||
|
|
|
|||
|
|
@ -32,16 +32,17 @@
|
|||
}
|
||||
```
|
||||
|
||||
## 2) 六层目录职责
|
||||
## 2) 目录职责(01–06 通用总结 + 07 私有现场)
|
||||
|
||||
| 目录 | 回答的问题 | RAG 优先级(排障场景) |
|
||||
|------|------------|------------------------|
|
||||
| `01_协议排障逻辑树` | 怎么想 | 高(决策顺序) |
|
||||
| `02_产品平台特性` | 设备特有行为 | 最高(模型不知道) |
|
||||
| `03_配置规范与基线` | 应该怎么配 | 中 |
|
||||
| `04_历史故障案例库` | 真实发生过什么 | 高(根因链) |
|
||||
| `05_监控指标与告警阈值` | 什么算异常 | 中(告警解读) |
|
||||
| `06_标准SOP与工具脚本` | 敲什么命令 | 高(操作动作) |
|
||||
| 目录 | 内容性质 | 回答的问题 | RAG 优先级(排障场景) |
|
||||
|------|----------|------------|------------------------|
|
||||
| `01_协议排障逻辑树` | 通用总结 | 怎么想 | 高(决策顺序) |
|
||||
| `02_产品平台特性` | 通用总结 | 设备特有行为 | 最高(模型不知道) |
|
||||
| `03_配置规范与基线` | 通用总结 | 应该怎么配 | 中 |
|
||||
| `04_历史故障案例库` | 通用总结(脱敏教材版) | 可复用的根因链模式 | 高 |
|
||||
| `05_监控指标与告警阈值` | 通用总结 | 什么算异常 | 中(告警解读) |
|
||||
| `06_标准SOP与工具脚本` | 通用总结 | 敲什么命令 | 高(操作动作) |
|
||||
| `07_现场真实案例库` | **私有现场** | 本项目/本客户真实发生过什么 | 最高(现场相似度) |
|
||||
|
||||
## 3) 当前已收录文档(截至维护时)
|
||||
|
||||
|
|
@ -58,7 +59,7 @@
|
|||
- `zte/03_配置规范与基线/LDP_配置基线.md`
|
||||
- `zte/03_配置规范与基线/BGP_跨域配置规范.md`
|
||||
|
||||
### 04 历史故障案例库
|
||||
### 04 历史故障案例库(教材化)
|
||||
|
||||
- `zte/04_历史故障案例库/BGP/标签与LDP类/BGP_跨域下一跳NULL_LDP策略与下一跳修复_20260720.md`
|
||||
- 案例编号:`BGP-CROSS-DOMAIN-001`
|
||||
|
|
@ -73,11 +74,17 @@
|
|||
- `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跨域` | 01 + 04 + 03 |
|
||||
| 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 |
|
||||
|
|
@ -104,13 +111,11 @@
|
|||
|
||||
## 7) 知识沉淀(闭环后)
|
||||
|
||||
排障结束且用户同意记录时,新案例建议结构(写入 `04_历史故障案例库/`):
|
||||
排障结束且用户同意记录时:
|
||||
|
||||
- 案例元数据表(编号、协议、关键词、日期、等级)
|
||||
- §1 现象特征(含命令输出)
|
||||
- §2 理论锚点(简短,不抄 RFC)
|
||||
- §3 根因推理表(层层递进)
|
||||
- §4 修复与验证
|
||||
- 维护者 + netx 实测网元
|
||||
1. **现场原貌** → 写入 `07_现场真实案例库/`(用 `_TEMPLATE.md`;先 `draft`,过审改 `reviewed`)
|
||||
2. **稳定规律** → 再提炼进 `01`/`02`/`03`/`06`,或脱敏后写入 `04_历史故障案例库/`
|
||||
|
||||
配套产出:从案例拆 `01` 逻辑树节点 + `06` 三五步速查。
|
||||
`07` 案例建议字段:元数据(含源报告路径)、现象、排查过程表、根因、修复验证、可沉淀勾选。
|
||||
|
||||
配套产出:从 `07` 拆 `01` 逻辑树节点 + `06` 三五步速查;勿把未脱敏客户细节写进 01–06。
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue