用途：诊断 Omni Gateway 错误与故障，支持日志输出、dump 文件、症状描述任意组合的排查场景。
主要能力：
- 按症状分诊，指出首个检查项与应调用的技能。例如所有请求 5xx 时检查上游连通性与 spec.address 绑定；认证/策略 4xx 时检查 PolicyBinding 定位与策略配置；网关不可达或端口无响应时检查监听地址（0.0.0.0 与 localhost 区别）与端口冲突；策略未生效时检查 PolicyBinding 到 ApiInstance 的交叉引用；上游连接被拒、TLS 握手失败、xDS 断开或控制面错误、从未进入 STARTED 状态、配置看似正常仍失败等情形也各有对应检查方向。
- 按可用产物分流：提供日志则调用 omni-gateway-logs；有 conf.d 目录则调用 omni-gateway-config；提供 dump 文件则调用 omni-gateway-dump；仅描述症状时先询问可用产物再继续。
- 升级判断：可自行解决的情形包括 PolicyBinding 目标引用错误、spec.address 用了 localhost、上游服务不可达（网关外部的网络/防火墙问题）、Anypoint 注册令牌过期或被吊销。需升级至网关团队的情形包括验证配置有效后仍反复出现 xDS 同步失败、Envoy 进程崩溃（崩溃循环、OOMKill）、注册有效且 conf.d 正确却始终未达 STARTED 状态、配置经确认有效后问题仍可复现。
- 提供升级材料清单：调试级别完整网关日志、诊断 dump 文件、省略机密信息的 conf.d 清单（仅文件名与 kind/name）、flexctl 版本输出、平台（Linux/Docker/Kubernetes/CloudHub）、可复现步骤或故障起始时间线。
相关技能：omni-gateway-logs 解析日志输出以暴露错误与异常；omni-gateway-config 对 conf.d 做结构与交叉引用校验；omni-gateway-dump 解读诊断 dump ZIP 以查看实时网关状态。具体命令与启用调试方法见各子技能，本文暂未提供。