mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-08 22:20:54 +08:00
Add ops-knowledge-capture routing and harden ROLE/wiki topic hints for short WhatsApp threads. Co-authored-by: Cursor <cursoragent@cursor.com>
4.7 KiB
4.7 KiB
| 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「应该敲什么」、报告格式时:
memory_wiki_search(关键词:绰号 / host / optical / 区域码;limit=5~8)- 命中则
memory_wiki_get取experts/ops/*.md - 协议/案例类仍走
ops-ip-knowledge-playbook(KB + netx 验证) - 无命中不编造;用 inventory/
queryUmeNeInventory解析,并标记为潜在新知识
写路径(捕获 — 强制)
- 识别:是否「稳定数天 + 影响后续决策」?否 → 不写。是 → 必须写,不可拖到下轮。
- 分流:查上表;先
memory_wiki_search防重复(已有则更新Last-Confirmed/ 增量 append)。 - 写入 Wiki(
memory_wiki_applyappend/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
<可选:来源对话要点,脱敏>
- 中低置信:用户可见一句短确认(英文现场用英文),确认后再
apply。 - 案例:按
07_现场真实案例库/_TEMPLATE.md;状态draft,不得当正式依据。 - 禁止:把当轮 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 不被聊天噪声污染