用途：该技能用于诊断并恢复 Codex Slides 在插件、MCP、浏览器交接、本地运行时、持久化运行、项目恢复、渲染、Design Files 与导出等环节出现的已知错误。核心原则是先对失败分类再重试，保留同一 project id 与 run id，不因浏览器标签关闭或等待超时就重建演示文稿。
运行时与安装：插件版本契约失败时，.codex-plugin/plugin.json 必须以根 package.json 的精确版本加 +codex. 开头，桌面包须使用同一产品版本。应用不可达时检查 CODEX_SLIDES_URL 与 CODEX_SLIDES_LOG，本地 MCP 启动器可能需要准备依赖或独立构建。已安装技能或工具清单陈旧时，重装或升级插件并新建 Codex 任务以刷新带版本的插件缓存。
持久化运行：有其他运行处于活动状态时，用 get_project_run 检查，等待、显式取消，或让 Deck Agent 请求留在可见队列中。等待超时不代表运行被取消，可继续 wait_project_run 或重新打开其 browserHandoff。完成后缺少 run id 说明运行时过旧、没有终端 runHistory，需先刷新插件或运行时。运行正在停止时不要启动冲突渲染，轮询至其变为 cancelled 再继续。
浏览器交接与项目恢复：使用返回的精确 browserHandoff.url，不要自行重建项目 URL；保留 slide、panel、version、mode、checkpoint、conversation、run 等全部焦点参数。clarify/research 项目可能经 /?resume=<id> 路由，续接查询须在该重定向后保留。演示者模式的第二个窗口需要用户手势，演示者深链会在正确幻灯片处打开 Play 菜单，而非绕过弹窗保护。
渲染与项目状态：部分渲染或暂停的演示文稿可恢复，读取项目并为现有项目启动持久化渲染运行。Codex 状态与浏览器状态不一致时，以 /runs/get_project 作为权威快照，再重新加载同一浏览器交接。状态为 error 或持久化图像无法加载的幻灯片不得报告成功。
Design Files 与导出：通过 list_design_files 解析 Design Files，绝不猜测绝对路径；项目文件与暂存材料须区分。仅在视觉验证后导出当前或明确选定的不可变版本；演讲者备注虽在画布外，但必须保留在 PPTX 中。