hansjone/oclaw
1
0
Fork 0
mirror of https://github.com/hansjone/oclaw.git synced 2026-10-08 23:33:16 +08:00
Code Issues Projects Releases Packages Wiki Activity Actions

Add private layer 07 for field real cases in IP knowledge base.

Browse source 
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:
oliver 2026-07-29 11:18:28 +08:00
parent 07002caeb8
commit 9f2dba7a23
7 changed files with 160 additions and 32 deletions
Download patch file Download diff file Expand all files Collapse all files

9
docs/ip-knowledge-base/zte/04_历史故障案例库/README.md Normal file
View file

@ -0,0 +1,9 @@
# 04 历史故障案例库（教材化）
> **定位**：脱敏后的、可复用的案例骨架与根因链，供专家推理与培训。
> **不是**现场报告原文存放处。
新的现场 PPT/PDF、值班闭环、客户侧细节 → 写入 **`07_现场真实案例库`**。
从 `07` 提炼出的稳定模式，再整理进本目录（少客户私有信息）。
现有示例：`BGP/标签与LDP类/BGP_跨域下一跳NULL_LDP策略与下一跳修复_20260720.md`

45
docs/ip-knowledge-base/zte/07_现场真实案例库/README.md Normal file
View file

@ -0,0 +1,45 @@
# 07 现场真实案例库（私有）
> **定位**：存放**本项目/本客户现场**真实故障与处置记录（PPT/PDF 报告提炼、值班闭环沉淀等）。
> **属性**：私有经验，可含现场拓扑指称、客户侧约定、内部编号；**不是**通用教材。
## 与 01–06 的关系
| 层级 | 内容性质 | 用途 |
|------|----------|------|
| `01`–`06` | **总结后的通用/可复用网络知识**（逻辑树、产品特性、基线、教材化案例模式、阈值、SOP） | 给排障「怎么想、怎么配、敲什么」 |
| **`07`（本目录）** | **现场私有真实案例**（一事一记，可追溯源报告） | 给「我们现场是否遇到过、当时怎么查的」 |
从 `07` 提炼出的稳定规律，应再写入 `01`/`02`/`03`/`06`（或写入 `04` 的教材化案例）；**不要**把未脱敏的客户细节写进 01–06。
`04_历史故障案例库`：保留**已总结、可公开给专家推理复用**的案例骨架（少客户私有信息）。
新的现场报告与值班沉淀，**优先写入本目录 `07`**。
## 建议子目录
按协议/主题分，勿按「第几份 PPT」分：
```text
07_现场真实案例库/
├── README.md # 本说明
├── _TEMPLATE.md # 入库模板
├── BGP/
├── OSPF/
├── MPLS_LDP/
├── 光与传输/
└── _staging/ # 可选：模型草稿，未过审勿当正式知识引用
```
## 入库约定
1. 一案一文件 Markdown；文件名：`协议_现象关键词_YYYYMMDD.md`
2. 必填：现象、排查步骤、根因、修复、关键词、**源报告路径/页码**
3. 敏感信息：客户全名、公网 IP、账号口令等按需脱敏；保留排障所需的网元角色与命令输出
4. 状态：`draft`（未过审）/ `reviewed`（可被 playbook 正式引用）
5. 原 PPT/PDF 建议放 `_raw/` 或不进 git 的对象存储，md 内只留相对路径索引
## 检索提示（给 ops）
- 「以前现场有没有类似的」→ 优先 `search_files` 本目录 `07_现场真实案例库`
- 「标准怎么查/怎么配」→ 仍用 `01`–`06`
- 命中 `07` 后仍须用 netx 在**当前**网元验证，不得直接套用历史配置

65
docs/ip-knowledge-base/zte/07_现场真实案例库/_TEMPLATE.md Normal file
View file

@ -0,0 +1,65 @@
# （标题：协议_现象关键词_YYYYMMDD）
> 状态：`draft` | `reviewed`
> 层级：`07_现场真实案例库`（私有现场案例）
## 案例元数据
| 项目 | 内容 |
|------|------|
| **案例编号** | 如 FIELD-BGP-001 |
| **适用产品/版本** | |
| **涉及协议** | |
| **关键词标签** | #标签1 #标签2 |
| **故障日期** | YYYY-MM-DD |
| **故障等级** | |
| **源报告** | 路径或文件名 + 关键页码 |
| **客户/项目（可脱敏）** | |
| **审核状态** | draft / reviewed |
---
## 1. 现象特征
### 业务影响
### 直接现象（告警 / CLI / 截图要点）
### 环境要点（拓扑角色、跨域/VPN 等）
---
## 2. 排查过程（有序）
| 步骤 | 动作 | 发现 | 判断 |
|------|------|------|------|
| 1 | | | |
| 2 | | | |
---
## 3. 根因
（一句话 + 关键证据；标明来自源报告哪一页）
---
## 4. 修复与验证
---
## 5. 易混淆点 / 经验
---
## 6. 可沉淀到通用层（可选）
- [ ] 已提炼进 `01_协议排障逻辑树`
- [ ] 已提炼进 `02_产品平台特性` / `03_配置规范` / `06_SOP`
- [ ] 已整理进 `04_历史故障案例库`（脱敏教材版）

2
runtime/workspaces/ops/ROLE_SYSTEM.en.md
View file

@ -35,7 +35,7 @@ You are the ops specialist (network operations expert).
## Required skills
- For every netx/UME **alarm or NE** request, load and follow skill: `ops-netx-ume-playbook` (skill text may be Chinese; **user-facing output must still match the user's language**).
- When logging into **netx managed NEs** (SSH/Telnet inventory under NE management) to run show/display CLI, load and follow: `ops-netx-managed-ne-playbook`.
- For **protocol troubleshooting, config baselines, historical cases, product-specific behavior, or IP ops SOPs** (e.g. how to triage BGP/MPLS/LDP/VPN, standard config, prior incidents), load and follow: `ops-ip-knowledge-playbook`; search `docs/ip-knowledge-base` first, then **verify with netx tools** — never conclude from the KB alone.
- For **protocol troubleshooting, config baselines, historical/field cases, product-specific behavior, or IP ops SOPs** (e.g. how to triage BGP/MPLS/LDP/VPN, standard config, prior incidents), load and follow: `ops-ip-knowledge-playbook`; search `docs/ip-knowledge-base` (including private `07_现场真实案例库`) first, then **verify with netx tools** — never conclude from the KB alone.
## Skill creation and installation constraints (mandatory)
- When the user asks to create/write/install a skill, use only `skill_auto_install`; do not switch to any other install path.

2
runtime/workspaces/ops/ROLE_SYSTEM.md
View file

@ -27,7 +27,7 @@
## 必须加载技能
- 每次处理 netx/UME **告警或网元** 问题时，必须加载并遵循技能：`ops-netx-ume-playbook`。
- 每次需要在 **netx 网元管理（纳管 SSH/Telnet 设备）** 上登录查配置/状态时，必须加载并遵循技能：`ops-netx-managed-ne-playbook`。
- 每次涉及 **协议排障、配置规范、历史案例、产品特性或 IP 运维 SOP**（如 BGP/MPLS/LDP/VPN 怎么查、应该怎么配、类似故障是否发生过）时，必须加载并遵循技能：`ops-ip-knowledge-playbook`；检索 `docs/ip-knowledge-base` 后仍须用 netx 工具验证，不得仅凭知识库下结论。
- 每次涉及 **协议排障、配置规范、历史/现场案例、产品特性或 IP 运维 SOP**（如 BGP/MPLS/LDP/VPN 怎么查、应该怎么配、类似故障是否发生过）时，必须加载并遵循技能：`ops-ip-knowledge-playbook`；检索 `docs/ip-knowledge-base`（含私有 `07_现场真实案例库`）后仍须用 netx 工具验证，不得仅凭知识库下结论。
## Skill 创建与安装约束（强制）
- 当用户要求“新建/编写/安装 skill”时，只能使用 `skill_auto_install`，禁止切换为其它安装路径。

26
skills/_workspace/ops/ops-ip-knowledge-playbook/SKILL.md
View file

@ -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、速查、命令探索 |

43
skills/_workspace/ops/ops-ip-knowledge-playbook/reference.md
View file

@ -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。