用途：面向 cmux 终端用户的诊断技能，用于排查钩子、通知、会话恢复、设置、浏览器自动化、socket 访问、CLI 控制和智能体恢复等问题，默认只做只读检查。
主要能力与用法：先运行内置只读脚本，安装路径任选其一——skills/cmux-diagnostics/scripts/cmux-diagnostics（cmux 检出目录）、~/.agents/skills/cmux-diagnostics/scripts/cmux-diagnostics 或 ~/.codex/skills/cmux-diagnostics/scripts/cmux-diagnostics；仅在需要工作区名、cwd 路径与当前 cmux 标识符时加 --include-context。检查 CLI 与 socket：command -v cmux、cmux ping、cmux capabilities --json。检查设置：cmux-settings validate 与 cmux-settings get terminal.autoResumeAgentSessions。检查钩子：cmux hooks setup --agent codex、--agent opencode 或不带参数的 cmux hooks setup。检查会话恢复：ls -lh ~/.cmuxterm/*-hook-sessions.json 2>/dev/null。通知测试：cmux notify "cmux diagnostic test"，需用户同意后才发可见通知。安装或卸载命令须用户同意后执行。
结果解读：找不到 cmux 说明 CLI 未安装或不在 PATH；ping 失败可能是应用关闭、socket 路径不可达或自动化被禁用；缺少 CMUX_WORKSPACE_ID 或 CMUX_SURFACE_ID 说明在 cmux 终端之外运行；有钩子配置但无会话存储，可在安装钩子后在 cmux 内运行一次受支持智能体；有会话存储但恢复时无智能体，检查 terminal.autoResumeAgentSessions 与保存的可执行文件是否仍在 PATH；设置校验失败应先修配置，否则后续症状会误导判断。
限制：修好前保持只读；绝不打印原始钩子文件、会话 JSON、提示日志、shell 历史、令牌或 API 密钥，只汇总文件存在性、大小、修改时间与标记；优先用窄修复如 cmux hooks setup --agent codex，而非重装所有集成；修复后重跑诊断脚本并报告变化行。其他细节暂未提供。