用途：spark-diagnostics-cli 是针对 Microsoft Fabric Spark 的只读诊断技能，用于排查已有作业失败、监控 Livy 会话健康、分析性能瓶颈。它不做新建 notebook、运行新作业或交互式 PySpark 分析（分别由 spark-authoring-cli 和 spark-consumption-cli 负责）。
主要能力：通过 Fabric 控制平面 REST API 与 CLI 查询工作区与项、作业实例历史、失败原因；读取 Livy 会话状态与资源；借助监控 API（无需活动会话）查看 Spark 应用、阶段、执行器、驱动/执行器日志、Livy 日志、Spark Advisor 与资源使用；提供失败分类、会话闲置/僵尸检测、性能反模式与优化建议。
用法：首次会话需先运行 check-updates 技能或用 package.json 对比本地与远程版本。使用 az login 获取令牌，必须传 --resource https://api.fabric.microsoft.com，用 JMESPath 过滤响应；不硬编码工作区或项 ID，先列工作区/项再定位。诊断前先查作业/会话状态与 Spark Advisor，优先用监控 API，轮询间隔 10–30 秒，超 30 分钟超时。
适用场景：作业失败分诊、会话卡住或泄漏清理、作业变慢与回归对比、OOM 与性能瓶颈定位、容量节流检查。
限制：仅覆盖资料所列 Fabric REST API 与 CLI 路径；具体环境变量、URL、认证流程及更新检查方式依赖 COMMON-CLI.md、COMMON-CORE.md 等未展开文档，此处暂未提供；避免在会话忙碌时提交诊断语句，也不要在未检查活动语句时终止会话。