# wind-hazard-diagnosis（风速风量监测与隐患判识 skill）

通用 AI Agent skill：查询一通三防管控平台测风装置实时数据，结合云通防知识库判识**风速超限 / 风量不足 / 重大隐患**，输出**固定格式** md 分析报告。

## 触发方式

用户提到以下意图时自动调用：
- 「查询当前风速风量数据及是否存在问题/隐患」
- 「测风数据判识」「风速风量有没有问题/隐患」
- 手动：`/wind-hazard-diagnosis` 或 `run_skill({name: "wind-hazard-diagnosis"})`

## 依赖环境

| 依赖 | 说明 |
|---|---|
| MCP 服务器 `tf_mcp` | 一通三防管控平台数据接口（`query_device_info` / `query_device_data_by_id` / `get_needq_all_data` / `execute_sql_query` 等） |
| 云通防知识库 | `http://39.97.59.228:8067`（Obsidian Vault Knowledge Service，`/api/search`、`/api/retrieve`） |

缺少任一依赖时，skill 会明确提示缺失环节，不静默降级。

## 执行流程（9 步）

1. 获取测风装置全量清单（`device` 表 `windrect` 大类，标注测试/模拟设备）
2. 逐台获取实时数据（`query_device_data_by_id`，含模拟数据识别）
3. 判定巷道类型（**绑定信息优先** + 名称关键词推断）→ 确定风速上下限
4. 云通防知识库佐证限值（《煤矿安全规程》2025版 表6 / AQ1028-2006 表2）
5. 风速超限判定（超速 / 欠速 / 接近上限）
6. **需风量关联对比**（巷道ID精确 → 名称模糊匹配 → 未匹配明示），回复逐条写明"监测风量 → 需风量位置/数值/关联依据"供人工排查
7. 重大隐患比对（《煤矿重大事故隐患判定标准》第八条：供风量 < 需风量 × 75%）
8. 输出整体结论（总览 + 🔴🟠🟡 分级 + 重大隐患三选一）
9. `ask` 询问是否生成 md 报告，同意则按**固定格式**输出

## 安装

将 `SKILL.md` 放入 Agent 的 skills 目录（如 `~/.reasonix/skills/wind-hazard-diagnosis/SKILL.md` 或项目 `.reasonix/skills/`），或通过 `install_skill` / `/wind-hazard-diagnosis` 安装。

## 报告固定格式

生成的报告文件名：`测风装置实时数据分析报告_YYYY-MM-DD.md`（同日覆盖）。

固定 9 章节结构（0 报告元信息 → 一 判识框架 → 二 总体结论 → 三 逐台判识明细(13列) → 四 需风量关联明细(7列) → 五 需风量数据全表(6列) → 六 隐患分级清单 → 七 整改建议 → 八 判识依据出处 → 尾部声明），表格列、判定用语（正常/接近上限/超速/欠速/疑似超速/无法判识；一致/不符/严重不符；构成/不构成/数据不足无法判定）均为固定词表，任何一次生成格式一致。

## 维护

- 判识依据：云通防知识库（更新限值/条款时同步知识库即可，skill 每次运行实时检索佐证）
- 报告模板变更：需同步修改 SKILL.md「固定报告格式」章节
