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

Add one-shot UME alarm Excel delivery for WhatsApp ops.

Browse source 
Collapse query+xlsx+deliverable into ume_alarm_xlsx_report, allow write_xlsx(deliverable=true), and accept run_command aliases to cut multi-tool loops.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
oliver 2026-08-10 22:36:14 +08:00
parent aff11c1eae
commit e03c90fb35
10 changed files with 564 additions and 27 deletions
Download patch file Download diff file Expand all files Collapse all files

11
skills/_workspace/ops/ops-netx-ume-playbook/SKILL.md
View file

@ -58,14 +58,15 @@ description: 面向 ops 专家的 netx UME 运维作业手册。覆盖告警查
| 用户说法（例） | 配方 |
|----------------|------|
| 断纤 / fiber cut / LOS / 光缆中断 | ① `queryUmeAlarmsRaw(keyword=LOS\|fiber\|断纤\|光缆, field_preset=evidence, page_size=50)` 或 `keyword`+severity；② 摘要表；若要文件：`write_xlsx`→`save_deliverable_attachment` |
| 离线 / 单板离线 / offline NE | ① `queryUmeAlarms`/`Raw` + keyword `离线`/`offline`/`通信中断`；② 按 `alarm_host_name` 去重列清单；要文件同上 |
| Critical Top / 告警统计 | ① `aggregateUmeAlarms(severity=critical, top_ne=20)` 或 `group_by=alarm_host_name`；② 结论；要 xlsx 再写表 |
| 断纤 / fiber cut / LOS / 光缆中断 | **优先** `ume_alarm_xlsx_report(mode=fiber_cut)`（一键 xlsx+投递）；或 `queryUmeAlarmsRaw` 后摘要 |
| 离线 / 单板离线 / offline NE | **优先** `ume_alarm_xlsx_report(mode=offline)` |
| Critical Top / 告警统计 | ① `aggregateUmeAlarms(severity=critical, top_ne=20)`；要文件：`ume_alarm_xlsx_report(mode=aggregate_by_host, severity=critical)` |
| 当前告警有多少 / tally | ① `runUmeDiagnostics` 或 `aggregateUmeAlarms`；② 直接报 by_severity + freshness |
| 导出 Excel / 发我表格 | 先查再 `write_xlsx(sheets=[…])`（可顶层 headers+rows）→ **必须** `save_deliverable_attachment(attachment_id=…)` |
| 导出 Excel / 发我表格 | `ume_alarm_xlsx_report` **或** `write_xlsx(..., deliverable=true)`；勿再拆成 3 步 |
交付约定：
- `write_xlsx` 只入库，不发出；WhatsApp 要文件时最后一步必须 `save_deliverable_attachment`。
- `ume_alarm_xlsx_report` 默认 `deliverable=true`，WhatsApp 可直接收文件。
- 通用表格：`write_xlsx(..., deliverable=true)` 可跳过 `save_deliverable_attachment`。
- 禁止用 `run_command`+openpyxl 造 xlsx。
- 确认类短句（YES / confirm / 继续）：承接上一任务继续，勿重新开查。

6
skills/_workspace/ops/ops-netx-ume-playbook/reference.md
View file

@ -30,9 +30,9 @@
| 意图 | 调用 |
|------|------|
| Critical Top | `aggregateUmeAlarms(severity=critical, top_ne=20)` |
| 按 host 统计 | `aggregateUmeAlarms(group_by=alarm_host_name, limit=50)` |
| 断纤/离线清单 | `queryUmeAlarmsRaw(keyword=…, field_preset=evidence)` → 可选 `write_xlsx` + `save_deliverable_attachment` |
| 发 Excel | `write_xlsx`（sheets 或顶层 headers+rows）→ `save_deliverable_attachment` |
| 按 host 统计+Excel | `ume_alarm_xlsx_report(mode=aggregate_by_host, severity=critical)` |
| 断纤/离线清单+Excel | `ume_alarm_xlsx_report(mode=fiber_cut\|offline)` |
| 发 Excel（已有表数据） | `write_xlsx(..., deliverable=true)` |
## 4) 诊断

8
skills/_workspace/public/channel-file-delivery/SKILL.md
View file

@ -44,11 +44,13 @@ description: "在 WhatsApp/微信等渠道会话中，把生成的附件发回
**Excel（xlsx）— 优先：**
```text
1. write_xlsx(sheets=[...], name="report.xlsx") → 得到 attachment_id
2. 若用户要求发文件：save_deliverable_attachment(attachment_id="...")
3. 文字回复摘要
1. write_xlsx(sheets=[...], name="report.xlsx", deliverable=true) # 一键投递
# 或仍分两步：write_xlsx → save_deliverable_attachment(attachment_id=...)
2. 文字回复摘要
```
告警类 WhatsApp 短句优先用 ops 工具 **`ume_alarm_xlsx_report`**（查询+xlsx+投递一条完成）。
**文本文件（CSV/TXT）：**
```text