bandwidth-management - SKILL.md Agent Skill

name: bandwidth-management description: 带宽管理技能。当用户咨询专线带宽相关问题（扩容、缩容、线路查询、流量分析、邮件申请）时加载此技能。触发词：带宽、扩容、缩容、线路、专线、流量、P95。也适用于用户提供流量报表或监控数据的场景。

带宽管理技能

概述

此技能指导你完成带宽策略分析的完整流程：从数据入库、查询分析、到 P95 计算和扩缩容判断，最终生成邮件草稿。

数据流：HTML 日报 → data-manager 解析 21 列表格 → JSON 文件（共享 volume）→ ensure_bandwidth_data 入库 SQLite → bandwidth_check 查询 + P95 计算 + 扩缩容判断 → bandwidth_report 生成邮件。

触发条件

当用户输入包含以下任何一种情况时，立即加载此技能：

提到"带宽"、"专线"、"线路"、"流量"、"扩容"、"缩容"
提到具体带宽值如"10M"、"20M"、"5Mbps"
提到两端站点如"亦庄到西藏"、"西五环到山东"
粘贴流量监控数据或报表
询问带宽相关操作流程
提到"基线"、"对比"、"偏离"、"趋势分析"、"线路日报"
提到"P95"、"利用率"、"带宽评估"
提到"线路数据"、"这几天数据"、"当前有几天数据"、"所有字段对比"

可用工具

核心带宽工具

工具	用途	数据源
`ensure_bandwidth_data`	扫描 JSON 文件入库线路带宽数据	SQLite (bandwidth_lines 表)
`bandwidth_records_query`	查询原始带宽记录，支持日期、线路组、峰值利用率阈值过滤	SQLite (bandwidth_lines 表)
`bandwidth_check`	查询线路数据，计算 P95，判断扩缩容	SQLite (bandwidth_lines 表)
`bandwidth_report`	根据检查结果生成邮件内容（3种模板）	bandwidth_check 结果

辅助工具（不得替代核心带宽流程）

工具	用途	数据源
`line_info_query`	查询专线基础信息	MySQL (iteams_db)
`bandwidth_assess`	处理用户给出的单条线路、单个流量值	SQLite
`policy_search`	搜索带宽策略文档	ChromaDB RAG
`bandwidth_stats`	查询带宽档位统计	SQLite + MySQL
`email_generate`	生成邮件草稿	代码模板

禁止错用的旧工具

ensure_line_status_data、line_status_compare、line_status_history 只服务“线路状态日报”的实际值与基线对比，不用于带宽 P95、扩容、缩容、40% 阈值、带宽线路清单查询，也不用于“线路数据”“所有字段对比”。

只要用户问题中出现“带宽”“P95”“扩容”“缩容”“峰值利用率超过40%”“哪些线路超过40%”“线路数据”“所有字段对比”，必须先调用 ensure_bandwidth_data，不得调用 line_status_*。

其中：

查询某一天的原始记录、返回所有字段、筛选“峰值利用率超过 40%” → 使用 bandwidth_records_query
计算 P95、判断扩容/缩容、生成操作建议 → 使用 bandwidth_check

工作流程

流程 A：原始带宽记录查询

当用户要求“查看某天数据”“当前有几天数据”“对比这几天数据”“哪些线路超过40%”“返回所有字段”“原始记录”时使用。

确保数据已入库：调用 ensure_bandwidth_data
```
ensure_bandwidth_data()
```
查询原始记录：调用 bandwidth_records_query
```
bandwidth_records_query(date="2026-05-22", min_peak_util_pct=40)
```
不指定日期时，bandwidth_records_query() 返回当前已入库日期范围内的原始记录，并在 available_dates 中列出日期。用户说“库内所有日期”时，不要反问时间范围，直接不传日期或使用 available_dates 覆盖范围。用户给多个线路编号时，可以把多个 long_distance_no 用空格、逗号或分号传入；工具支持短编号模糊匹配，例如 ETN2419NP ETN2420NP 可匹配 北京南京ETN2419NP、北京南京ETN2420NP。
回复用户：
- 直接基于 records 返回结果
- 用户要求“所有字段”时，按记录原字段名输出，不得改名、合并或省略
- max_peak_util_pct 和 max_peak_direction 是工具额外计算字段，可用于解释筛选依据

流程 B：自动带宽评估

当用户要求"评估带宽"、"看看要不要扩容"、"检查线路"等时使用。

确保数据已入库：调用 ensure_bandwidth_data
```
ensure_bandwidth_data()
```

查询并评估：调用 bandwidth_check

默认取 15 天数据
用户指定时间范围时按用户要求取

bandwidth_check(days=15)
# 或指定范围：
bandwidth_check(start_date="2025-05-01", end_date="2025-05-15")
# 或指定线路组：
bandwidth_check(days=15, line_group="VPDN终端专线")

生成邮件（如有扩缩容建议）：调用 bandwidth_report
- report_type: "expand"（常态化扩容）、"emergency"（应急扩容）、"shrink"（缩容）
```
bandwidth_report(check_result=<bandwidth_check返回的JSON字符串>, report_type="expand")
```
回复用户：整合检查结果和邮件内容

流程 B 的返回要求

若用户要求“所有字段”，必须按 bandwidth_check 原始字段名返回，不得改名、合并、丢字段。
筛选线路时必须基于 bandwidth_check 返回的 groups[].lines[]，不要凭上下文手工补记。
需要说明筛选条件时，明确写出使用的是 p95_in_util、p95_out_util 还是 p95_traffic。

流程 C：自然语言输入（一句话）

示例："亦庄到西藏数据端带宽使用到了5M，应该怎么办？"

理解意图：提取站点、用途、流量值
查线路信息：line_info_query(description="亦庄到西藏数据端")
评估策略：bandwidth_assess(current_bw_mbps=<带宽>, current_traffic_mbps=<流量>)
查操作流程：policy_search(query="扩容操作流程")
生成邮件：email_generate(action=<评估结果>, ...)

流程 D：统计查询

bandwidth_stats(bandwidth="10M")

流程 E：策略咨询

policy_search(query="<用户问题>")

扩缩容判断规则

场景	条件	操作
扩容	P95 利用率 > 40%	升至下一档位
缩容	P95 流量 < 下一档 × 35%	降至下一档位
维持	不满足上述条件	保持现状

带宽档位：2, 4, 6, 8, 10, 20, 30, 40, 50 Mbps

bandwidth_check 返回结构

{
  "period": {"start": "2025-05-07", "end": "2025-05-21"},
  "total_groups": 6,
  "groups": [
    {
      "group_name": "VPDN终端专线",
      "group_p95_traffic_sum": 45.2,
      "line_count": 3,
      "lines": [
        {
          "long_distance_no": "XX-XXX",
          "bandwidth_mbps": 10,
          "p95_in_util": 42.5,
          "p95_out_util": 38.1,
          "p95_traffic": 4.25,
          "action": "expand",
          "target_bandwidth": 20,
          "province": "西藏",
          "carrier": "电信",
          "usage": "数据端"
        }
      ]
    }
  ]
}

action 值："expand"（需扩容）、"shrink"（可缩容）、"stable"（维持现状）

bandwidth_records_query 返回结构

{
  "query": {
    "date": "2026-05-22",
    "start_date": "2026-05-22",
    "end_date": "2026-05-22",
    "line_group": "",
    "long_distance_no": "",
    "min_peak_util_pct": 40,
    "limit": 200
  },
  "total_matched": 11,
  "returned": 11,
  "records": [
    {
      "id": 1,
      "report_date": "2026-05-22",
      "line_group": "VPDN终端专线",
      "line_no": 51,
      "province": "浙江",
      "carrier": "电信",
      "usage": "数据端",
      "bandwidth_mbps": 8,
      "long_distance_no": "浙江51",
      "in_peak_mbps": 5.517,
      "in_avg_mbps": 1.23,
      "in_peak_util_pct": 68.96,
      "in_peak_time": "10:05",
      "out_peak_mbps": 0.8,
      "out_avg_mbps": 0.2,
      "out_peak_util_pct": 10.0,
      "out_peak_time": "11:20",
      "latency_avg_ms": 24.3,
      "bw_peak_baseline_mbps": 4.0,
      "bw_util_threshold_pct": 40,
      "latency_baseline_ms": 30,
      "latency_threshold_ms": 50,
      "created_at": "2026-05-23 10:00:00",
      "max_peak_util_pct": 68.96,
      "max_peak_direction": "in"
    }
  ]
}

注意事项

data-manager 只负责解析并保存 JSON，入库由 ensure_bandwidth_data 扫描共享目录后写入 SQLite
用户要求“库内所有日期”且目标线路数量很少时，直接查全部可用日期，不要以“数据量可能过大”为由拒绝。
P95 计算在 MCP 工具层完成，skill 不需要自行计算
邮件模板在 MCP 工具层处理，支持 3 种类型
操作流程详情通过 policy_search 获取
给出评估结果后，检查调整后是否仍不符合策略，需迭代评估直到符合