From 9f2dba7a236e70f6efea39b1ec2f68a149569a0a Mon Sep 17 00:00:00 2001 From: oliver Date: Wed, 29 Jul 2026 11:18:28 +0800 Subject: [PATCH] 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 --- .../zte/04_历史故障案例库/README.md | 9 +++ .../zte/07_现场真实案例库/README.md | 45 +++++++++++++ .../zte/07_现场真实案例库/_TEMPLATE.md | 65 +++++++++++++++++++ runtime/workspaces/ops/ROLE_SYSTEM.en.md | 2 +- runtime/workspaces/ops/ROLE_SYSTEM.md | 2 +- .../ops/ops-ip-knowledge-playbook/SKILL.md | 26 ++++---- .../ops-ip-knowledge-playbook/reference.md | 43 ++++++------ 7 files changed, 160 insertions(+), 32 deletions(-) create mode 100644 docs/ip-knowledge-base/zte/04_历史故障案例库/README.md create mode 100644 docs/ip-knowledge-base/zte/07_现场真实案例库/README.md create mode 100644 docs/ip-knowledge-base/zte/07_现场真实案例库/_TEMPLATE.md diff --git a/docs/ip-knowledge-base/zte/04_历史故障案例库/README.md b/docs/ip-knowledge-base/zte/04_历史故障案例库/README.md new file mode 100644 index 00000000..a57a96a2 --- /dev/null +++ b/docs/ip-knowledge-base/zte/04_历史故障案例库/README.md @@ -0,0 +1,9 @@ +# 04 历史故障案例库（教材化） + +> **定位**：脱敏后的、可复用的案例骨架与根因链，供专家推理与培训。 +> **不是**现场报告原文存放处。 + +新的现场 PPT/PDF、值班闭环、客户侧细节 → 写入 **`07_现场真实案例库`**。 +从 `07` 提炼出的稳定模式，再整理进本目录（少客户私有信息）。 + +现有示例：`BGP/标签与LDP类/BGP_跨域下一跳NULL_LDP策略与下一跳修复_20260720.md` diff --git a/docs/ip-knowledge-base/zte/07_现场真实案例库/README.md b/docs/ip-knowledge-base/zte/07_现场真实案例库/README.md new file mode 100644 index 00000000..c383f94a --- /dev/null +++ b/docs/ip-knowledge-base/zte/07_现场真实案例库/README.md @@ -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 在**当前**网元验证，不得直接套用历史配置 diff --git a/docs/ip-knowledge-base/zte/07_现场真实案例库/_TEMPLATE.md b/docs/ip-knowledge-base/zte/07_现场真实案例库/_TEMPLATE.md new file mode 100644 index 00000000..80c10f9f --- /dev/null +++ b/docs/ip-knowledge-base/zte/07_现场真实案例库/_TEMPLATE.md @@ -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_历史故障案例库`（脱敏教材版） diff --git a/runtime/workspaces/ops/ROLE_SYSTEM.en.md b/runtime/workspaces/ops/ROLE_SYSTEM.en.md index 695bed42..1ce70ff6 100644 --- a/runtime/workspaces/ops/ROLE_SYSTEM.en.md +++ b/runtime/workspaces/ops/ROLE_SYSTEM.en.md @@ -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. diff --git a/runtime/workspaces/ops/ROLE_SYSTEM.md b/runtime/workspaces/ops/ROLE_SYSTEM.md index 28e7e8fd..71339142 100644 --- a/runtime/workspaces/ops/ROLE_SYSTEM.md +++ b/runtime/workspaces/ops/ROLE_SYSTEM.md @@ -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`，禁止切换为其它安装路径。 diff --git a/skills/_workspace/ops/ops-ip-knowledge-playbook/SKILL.md b/skills/_workspace/ops/ops-ip-knowledge-playbook/SKILL.md index 6bd633b0..ef97e0ef 100644 --- a/skills/_workspace/ops/ops-ip-knowledge-playbook/SKILL.md +++ b/skills/_workspace/ops/ops-ip-knowledge-playbook/SKILL.md @@ -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、速查、命令探索 | diff --git a/skills/_workspace/ops/ops-ip-knowledge-playbook/reference.md b/skills/_workspace/ops/ops-ip-knowledge-playbook/reference.md index 7a2fafdb..fd219714 100644 --- a/skills/_workspace/ops/ops-ip-knowledge-playbook/reference.md +++ b/skills/_workspace/ops/ops-ip-knowledge-playbook/reference.md @@ -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。