vent_skills/vent-resistance-check

vent-resistance-check — 矿井通风系统阻力检查技能

计算回风系统关键（最大）阻力路线及总阻力，逐段核验后按固定模板输出报告，并结合云通防知识库做问题与隐患分析。已在布尔台（松定霍洛/明安木独）、保德（枣林/刘家堰）两矿四套回风系统实测验证。

• 版本：1.0（2026-08-18）
• 数据与单位规范：风量 m³/min（库值×60，保留 1 位小数）；阻力取整 Pa；风速 m/s

目录结构

vent-resistance-check/
├── SKILL.md                        # 主流程 + 技术红线（必读）
├── README.md                       # 本文件：安装与使用
├── references/
│   ├── capability-map.md           # 能力映射层：C1~C7 能力契约 + 跨环境适配 + 降级策略
│   ├── report-template.md          # 固定报告模板 + 成稿规则（终版报告必须干净）
│   └── hazard-checklist.md         # 隐患判据：规程条款 + 工程经验 B1~B8 + 数据治理核查
└── scripts/
    └── mcp_call.js                 # MCP 直连应急取数脚本（Node.js ≥18，会话失效时使用）

安装

ZCode：将整个 vent-resistance-check/ 文件夹放入用户技能目录 ~/.agents/skills/（Windows：C:\Users\<用户名>\.agents\skills\），新开会话即可触发；也可用 /vent-resistance-check 显式调用。

Claude Code / 其他支持 Agent Skills 规范的工具：放入其对应的 skills 目录（如 ~/.claude/skills/），规范相同（SKILL.md + references 渐进加载）。

Dify / Coze / 自研智能体等：将 SKILL.md 全文作为系统提示词或工作流指令注入；三个 references 文件按需一并注入（建议至少包含 report-template.md 与 capability-map.md）。

依赖与适配

• 首选：已接入 TF-MCP（通防管控平台 MCP，HTTP 传输）的环境，开箱即用。
• 无 TF-MCP 的环境：按 references/capability-map.md 的 C1~C7 能力清单映射等价工具（MCP/HTTP API/CLI/内部函数均可）。唯一不可降级的是 C4（最大阻力路线解算引擎）。

• 应急通道：MCP 客户端会话失效（"Session not found"）时，用 scripts/mcp_call.js 直连服务端取数：

  node scripts/mcp_call.js execute_sql_query "SELECT ..."
  node scripts/mcp_call.js get_out_shafts "model_id=2012326636757958658"
  node scripts/mcp_call.js get_max_resistance_path "model_id=2012326636757958658 node_id=3958"
  

  （脚本顶部 BASE 常量按实际部署修改端点）

使用示例

• “帮我计算松定霍洛回风系统的关键阻力路线及总阻力”
• “分析布尔台煤矿两个主通风机关键阻力路线和总阻力”（未指明系统时自动遍历全部回风系统）
• “帮我分析保德煤矿两回风系统关键阻力路线和总阻力”（按矿井名定位模型）

输出：对话内按固定模板展示（总体结论/路线走向/Top10/分段构成/注意事项/隐患分析），并在当前工作目录 vent-resistance-report/ 落盘带巷道明细附录的 Markdown 报告。

关键约束（详见 SKILL.md 技术红线）

1. 模型/巷道大整数 ID（>2^53）禁止经 JSON number 通道传输（字符串或 SQL 字面量）；
2. 回风井巷道 ID ≠ 节点 ID，解算终点取风硐 toId；
3. query_wind_by_tunid 不按模型过滤，报告数值一律以 nModelID 过滤的 SQL 为准；
4. Σ各段阻力与解算值偏差 ≤1% 才准出报告；段数取 path.length；
5. 风量 m³/min、阻力取整、报告为干净终稿（无修订痕迹/过程叙述/引用块）。