mirror of https://github.com/hansjone/oclaw.git synced 2026-10-09 03:30:48 +08:00

oliver 9f2dba7a23 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>

2026-07-29 11:18:28 +08:00

5.9 KiB

Raw Blame History

name	description
ops-ip-knowledge-playbook	面向 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）。

标准流程（每次排障/配置咨询必走）

定位层级：根据用户问题选目标目录（见下节「层级速查」）
关键词搜索：
- search_files(pattern=<协议/现象关键词>, root=docs/ip-knowledge-base, file_glob=**/*.md, regex=false)
- 同时搜中文与英文缩写（如 下一跳NULL、next-hop-self、access-fec）
精读命中文件：
- read_file(path=docs/ip-knowledge-base/zte/...)，大文件分段读（offset/limit）
- 优先读：07_现场真实案例库（私有现场）→ 04_历史故障案例库（教材化）→ 01_协议排障逻辑树 → 06_标准SOP → 03_配置规范 → 02_产品平台特性
- 07 仅引用状态为 reviewed 的案例；draft / _staging 不得当正式依据
现场验证（强制，不可跳过）：
- 知识库给出的是「检查什么、期望什么」；必须用 netx MCP 在真实网元上验证
- 纳管设备：ops-netx-managed-ne-playbook → mcp__netx__execManagedNe
- 告警关联：ops-netx-ume-playbook → 查相关网元/告警上下文
输出：结论 + 知识库引用路径 + 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 的协作原则（证据优先）

用户问题
  ├─ 需要当前设备状态？ → 先/并行 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
命令在线探索：docs/ip-knowledge-base/zte/06_标准SOP与工具脚本/命令探索方法论.md

5.9 KiB Raw Blame History Unescape Escape