oclaw/skills/_workspace/ops/ops-knowledge-capture/SKILL.md
oliver 1bdbfc3b85 Require ops to persist field general knowledge to Wiki, not chat memory.
Add ops-knowledge-capture routing and harden ROLE/wiki topic hints for short WhatsApp threads.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-12 23:41:15 +08:00

4.7 KiB
Raw Blame History

name description
ops-knowledge-capture WhatsApp/现场短会话下的知识沉淀手册。识别用户强调的通用约定,按层写入 Wiki / IP KB / playbook;不做对话记忆。

Ops 知识捕获(非对话记忆)

定位

现场多数是 WhatsApp、有效对话 ≤10 轮。本技能不追求记住整段对话;核心义务是:用户给出的通用知识必须写入记忆(Wiki/KB),不能只口头应承。

实时告警/CLI/网元状态 → 永远用 netx 取证,禁止当记忆存。

强制触发(命中即本轮必须写回)

出现任一情况时加载本技能,并在本轮完成 memory_wiki_search →(确认若需要)→ memory_wiki_apply(或按路由写 IP KB):

  • 用户说「以后 / 每次 / 记住 / 别再 / 标准是 / always / prefer / from now on / don't … again」
  • 纠正绰号、区域前缀、报告格式、CLI 命令偏好(即使没说“记住”,纠正本身就是通用知识)
  • 同类现场纠偏出现 ≥2 次
  • 排障闭环后需要沉淀案例(用户明确要求或你主动建议)

硬规则:只说 “Noted / 记住了” 而不调用写工具 = 失败。终稿可照常 Result/Evidence;写 Wiki 是后台必做步骤。

不触发:纯查告警、纯跑 CLI、一次性工单过程、群闲聊。

强调词 → 写入层(路由表)

用户强调的内容 写入层 路径 / 动作 置信度
站点/区域绰号 → host_name Wiki experts/ops/site-aliases.md 原话即规则 → 直接写;含糊 → 一句确认
报告/语言/终稿格式约定 Wiki experts/ops/report-conventions.md 同上
厂商 CLI 纠正(命令顺序、可用 show) Wiki experts/ops/field-cli-corrections.md 现场验证过 → 直接写
复发工具流程(batch、配方误用) Skill 改对应 playbook(ume / managed-ne) 仅用户要求改 skill,或稳定复现 ≥2 次后提议
协议排障规律、配置基线、教材化案例 IP KB docs/ip-knowledge-base/zte/01–06 勿擅自大改;用户要求或提炼自多案例
单次真实故障闭环 IP KB docs/ip-knowledge-base/zte/07_现场真实案例库/(先 draft) 须用户同意写入;reviewed 才可作依据
密钥、密码、整段 CLI dump、当轮告警表 不写 — —

读路径(答前)

涉及绰号、区域叫法、CLI「应该敲什么」、报告格式时:

  1. memory_wiki_search(关键词:绰号 / host / optical / 区域码;limit=5~8)
  2. 命中则 memory_wiki_get 取 experts/ops/*.md
  3. 协议/案例类仍走 ops-ip-knowledge-playbook(KB + netx 验证)
  4. 无命中不编造;用 inventory/queryUmeNeInventory 解析,并标记为潜在新知识

写路径(捕获 — 强制)

  1. 识别:是否「稳定数天 + 影响后续决策」?否 → 不写。是 → 必须写,不可拖到下轮。
  2. 分流:查上表;先 memory_wiki_search 防重复(已有则更新 Last-Confirmed / 增量 append)。
  3. 写入 Wiki(memory_wiki_apply append/write):
## [Knowledge] <短标题>
- Confidence: high | medium
- Source: user_direct | repeated_field_correction | confirmed
- First-Seen: YYYY-MM-DD
- Last-Confirmed: YYYY-MM-DD
- Applies-To: <范围,如 PLG area / ZTE EN / WhatsApp en>

<一句事实>

### Notes
<可选:来源对话要点,脱敏>
  1. 中低置信:用户可见一句短确认(英文现场用英文),确认后再 apply。
  2. 案例:按 07_现场真实案例库/_TEMPLATE.md;状态 draft,不得当正式依据。
  3. 禁止:把当轮 UME 结果/CLI 全文塞进 Wiki;禁止存凭据。

WhatsApp 行为约束

  • 捕获是后台动作:终稿仍用 Result/Evidence 壳;不要写成「我已记住」长篇。
  • 可选一行:Next: saved alias SEMBAWA→… to wiki(仅在确实写入后)。
  • 群聊默认不写向量记忆;Wiki 只写通用约定,不写发言人私聊八卦。
  • 英文会话:Wiki 条目可用中英对照标题,但对用户回复仍零汉字。

与其它技能关系

技能 关系
ops-netx-ume-playbook / ops-netx-managed-ne-playbook 干活;本技能只在强调/纠偏时叠加
ops-ip-knowledge-playbook 协议/案例读写;本技能负责把「该进 KB」的强调导过去
wiki-first-autonomy 通用 Wiki 习惯;ops 以本技能路由表为准

成功标准

  • 短会话不堆对话记忆,但绰号/CLI 纠偏跨会话可搜到
  • 用户少重复「我说过以后…」
  • Wiki 条目短、原子、可检索;IP KB 与 playbook 不被聊天噪声污染