后端服务将通过tjwater-cli形式访问

.opencode/skills/workflow/SKILL.md

@@ -1,19 +1,70 @@
----
-name: tjwater-workflow
-description: 负责分析类工作流能力。
-version: 1.0.0
----
-
-# Workflow Domain Skill
-
-## 简介
-负责分析场景下的工作流组织与调用入口能力。
-
-## 使用策略
-
-- 当用户问题明显属于“多接口 + 本地分析 + 综合结论”的分析任务时，优先从本目录查找固定 workflow。
-- 如果找到合适 workflow，应先按 workflow 执行主路径，再补充缺少的原子 skill。
-- 如果没有匹配 workflow，或现有 workflow 缺少关键步骤、接口或输出约束，再回到其他 domain/scenario/action skills 组合能力。
-
-## 子模块索引 (渐进式引导)
-- **bottleneck-analysis**: 见 `./bottleneck-analysis/SKILL.md`
+---
+name: tjwater-workflow
+description: 分析类工作流技能。所有工作流遵循 "CLI 获取 → 本地分析 → 报告输出" 模式。
+version: 3.0.0
+---
+
+# Workflow Domain Skill
+
+## 简介
+负责分析场景下的工作流组织与调用入口。前端工具仅用于渲染。
+
+## 使用策略
+
+1. **优先匹配固定工作流** — 用户问题属于已有覆盖场景时，直接走 workflow
+2. **按需升级** — 浅层工作流满足不了时，沿升级路径进入深层工作流
+3. **缺少 workflow 时** — Agent 自行组合 CLI 命令 + Python 脚本
+
+---
+
+## 工作流决策树
+
+```
+用户请求
+   │
+   ├─ 含"服务范围/供水分区/水源范围/分区渲染"？
+   │    └─ 是 → 走 source-service-area-analysis
+   │
+   ├─ 含"改管径/瓶颈/扩容"？
+   │    └─ 是 → 直接走 bottleneck-analysis
+   │
+   └─ 否 → 走 simulation-diagnosis（快速诊断）
+            │
+            ├─ 全局异常？（断流/未收敛/系统性低压）
+            │    └─ 直接输出针对性诊断，结束
+            │
+            ├─ 少量告警、无紧急项？
+            │    └─ 输出报告，结束
+            │
+            └─ ≥5 条紧急超速 或 存在多维度交叉异常？
+                 └─ 输出快速诊断报告 + 建议升级 bottleneck-analysis
+                    + 传递 TOP 问题管段 ID 列表
+```
+
+---
+
+## 工作流清单
+
+| 工作流 | 数据需求 | 典型步骤 |
+|--------|---------|---------|
+| **simulation-diagnosis** | `simulation run` + `data timeseries realtime links/nodes` | 1-2 次 CLI + 诊断脚本 |
+| **bottleneck-analysis** | 模拟结果 + `network get-link-properties` 逐管道查询 | 多次 CLI + 合并分析脚本 |
+| **source-service-area-analysis** | 模拟结果 + 管道拓扑 + 水库列表 | 多次 CLI + 图遍历脚本 |
+
+---
+
+## 衔接规则
+
+`simulation-diagnosis` → `bottleneck-analysis` 升级条件：
+
+| 信号 | 阈值 |
+|------|------|
+| 紧急超速管段数 | ≥ 5 条流速 > 1.5 m/s |
+| 多维度交叉异常 | 同一管段同时满足高速 + 高水损 + 大流量 |
+| 高水损地理聚集 | TOP 水损管段集中在同一区域 |
+
+## 子模块索引
+
+- **source-service-area-analysis**: `./source-service-area-analysis/SKILL.md`
+- **simulation-diagnosis**: `./simulation-diagnosis/SKILL.md`
+- **bottleneck-analysis**: `./bottleneck-analysis/SKILL.md`