By name: lightdash-metric-query description: 【高级】构造或调试 run_semantic_metric_query（Explorer metricQuery）与 run_metric_query（扁平）。由 lightdash-insight-router 在需要时遵循。
Lightdash Metric Query（高级）
与 router 的关系见 ../lightdash-insight-router/SKILL.md。本技能补 两种 MCP 工具 的用法与排障。
工具分工
| 工具 | 场景 |
|---|---|
run_semantic_metric_query |
Explorer 复制整段 JSON → 参数 metricQuery（默认） |
run_metric_query |
仅扁平：exploreName + dimensions[] + metrics[] |
规则以 MCP tools/list 里各工具的 description 为准（run_semantic_metric_query / run_metric_query），勿依赖仓库内 docs/mcp。
语义 query（强约束）
- 只传
metricQuery。 - 改筛选：只改
filters.dimensions.and[i].values。 - 422：改
metricQuery后重试。
扁平 query（强约束）
- 只传
exploreName、dimensions[]、metrics[]等顶层字段。 filters为对象；parameters为{}；context枚举（如mcp）。
排障顺序
fieldId/exploreName（find_fields、list_explores）- 是否用错工具（整段 JSON 必须
run_semantic_metric_query+metricQuery） parameters/filters/context类型- 运算符与枚举
values是否与 Explorer 一致 limit/sorts；PAT 与项目权限