用途：该技能用于将图形代码移植到 Metal 后出现的各类渲染与性能问题做系统化诊断，覆盖黑屏、着色器编译失败、颜色或坐标错误、性能回退、渲染伪影、GPU 工作期间崩溃等场景。
主要能力：按症状给出决策树式排查路径与常见修复方向。黑屏方面检查渲染通道描述符、drawable、管线状态、绘制调用、资源绑定、顶点数据、NDC 坐标范围与清除色；着色器编译方面对比 GLSL 与 MSL 差异，如 texture() 改为 tex.sample()、mod 改为 fmod、atan 改为 atan2、inversesqrt 改为 rsqrt，以及类型 vec4→float4 等；颜色与坐标方面处理 Y 轴翻转、镜像、红蓝通道互换、sRGB 与线性色彩、Z 范围由 [-1,1] 变为 [0,1]、透明混合状态；性能方面排查逐帧创建资源或管线、绘制调用过多、CPU-GPU 同步停顿、缓冲更新低效、存储模式不当，并给出三缓冲模式；崩溃方面处理资源提前释放、GPU 超时、验证消息、着色器越界与设备重启。
必要用法：任何调试前先在 Xcode 的 Edit Scheme → Run → Diagnostics 中启用 Metal API Validation、Metal Shader Validation 与 GPU Frame Capture (Metal)。随后使用 GPU Frame Capture（Cmd+Opt+Shift+G）检查缓冲内容、纹理与绘制调用顺序，用 Instruments 的 Metal System Trace 分析 GPU/CPU 时间线与同步停顿，用着色器调试器逐像素或逐顶点检查变量。验证消息通常直接说明错误资源与期望值，应完整阅读。
适用场景与限制：适用于 iOS 12+、macOS 10.14+、tvOS 12+ 上的 Metal 移植诊断。资料同时提示，验证会带来约 30% 性能开销，发布构建应关闭；文中时间估算为解决参考，并非保证。其余具体实现细节以资料所述为准。