这个 Skill 能做什么，适合哪些场景？
cmux-diagnostics 是随 manaflow-ai/cmux 仓库发布的一个技能，用于在 cmux（一款基于 Ghostty 的 macOS 终端）出现故障时做健康检查。它默认只读运行，先执行打包的诊断脚本，再逐项检查 CLI 与 socket、设置、钩子安装和会话恢复证据。它明确禁止输出钩子配置、会话 JSON、令牌等敏感内容，因此产出的报告可以安全地贴给支持团队。修复类操作（如安装钩子）只有在用户明确同意后才会执行。
- 从 cmux checkout 或已安装路径运行只读脚本 skills/cmux-diagnostics/scripts/cmux-diagnostics，可加 --include-context 输出工作区名和路径
- 检查 CLI 与 socket：command -v cmux、cmux ping、cmux capabilities --
- 用 cmux-settings validate 和读取 terminal.autoResumeAgentSessions 验证设置健康
- 检查钩子安装（cmux hooks setup --agent codex 等）和 ~/.cmuxterm/*-hook-sessions. 是否存在
- 在用户同意后发送 cmux notify 测试通知路径
- 按症状表解读结果，并在修复后重跑脚本对比变化
- 在 cmux 终端里使用 Claude Code/Codex 的开发者，发现重启后 agent 会话没有被自动恢复
- 配置了通知钩子但面板和桌面通知一直不出现的用户，需要判断钩子是否装好、socket 是否可达
- 向 cmux 支持团队提交问题前，想生成一份不含令牌和会话内容的支持安全调试摘要
- 怀疑 ~/.config/cmux/cmux. 设置损坏导致各种怪现象的用户，先验证设置再排查其他症状
- 用 skills.sh 只为 Codex 安装了技能的用户，从 ~/.codex/skills/ 路径运行诊断
- Linux 或 Windows 用户：cmux 本身只支持 macOS，没有 cmux 就没有可诊断的对象
- 想诊断 cmux 之外其他终端（如纯 tmux/zellij）问题的人，此技能只覆盖 cmux 及其钩子、通知、设置和会话恢复
如何安装这个 Skill？
- 引用的捆绑脚本 skills/cmux-diagnostics/scripts/cmux-diagnostics 未随证据提供，其只读性与安全性无法静态核验，使用前建议人工审阅脚本内容。
- 仓库许可元数据为 NOASSERTION，且主仓库存在 GPL/BUSL 混合许可，企业合规使用前需确认该技能文件的许可归属。
- 技能核心依赖 cmux CLI 与 macOS 应用，且文档与发布渠道（cmux.com、GitHub Releases）在国内网络可能不可达，中文支持未声明。
- 所有评分基于静态源码阅读（置信度：低），未执行任何脚本或命令。
- Shell / 命令行
- 本地文件系统
cmux CLI (macOS app installed and running)cmux-settings skill scripts
该技能随 cmux 仓库的 skills/ 目录分发；将仓库克隆后，SKILL.md 位于 skills/cmux-diagnostics/。对于通过 skills.sh 的 Codex 专用安装，脚本会位于 ~/.codex/skills/cmux-diagnostics/scripts/；通用已安装路径为 ~/.agents/skills/cmux-diagnostics/scripts/。源文档未给出具体的安装命令，未记载的步骤不应臆造。
git clone https://github.com/manaflow-ai/cmux.git
cd cmux
ls skills/cmux-diagnostics/如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 我的 cmux 钩子装了但通知一直不弹，帮我做个 cmux 健康检查
- 重启 cmux 后 Codex 会话没有恢复，跑一下 cmux doctor 报告
- 生成一份支持安全的 cmux 调试摘要，不要包含任何密钥，我要发给官方支持
- cmux ping 失败了，帮我排查是 socket 还是设置的问题
当用户提到 cmux 钩子、通知、会话恢复、设置、浏览器自动化、socket、CLI 控制或 agent 恢复不工作，或要求健康检查/doctor 报告时，技能会被触发。流程：先运行诊断脚本，必要时加 --include-context；然后按检查清单逐项排查（CLI/socket、设置、钩子、会话存储文件、通知）。规则是保持只读，直到用户要求修复；修复后重跑脚本并报告变化的行。
skills/cmux-diagnostics/scripts/cmux-diagnostics
~/.agents/skills/cmux-diagnostics/scripts/cmux-diagnostics --include-context
cmux hooks setup --agent codex这个 Skill 有哪些优点和局限？
- 默认只读，明确禁止打印令牌、会话 JSON 和钩子原始文件，报告可安全外发
- 自带诊断脚本和症状解读表，从现象到原因有明确映射
- 检查项覆盖 cmux 最常见的故障面：CLI/socket、设置、钩子、会话恢复、通知
- 只能在装好并运行 cmux 的 macOS 环境中使用，依赖 cmux CLI 和配套 cmux-settings 技能脚本
- 会话存储缺失只给出可能原因（未在 cmux 内运行过、钩子禁用、不支持恢复），无法直接区分
- 测试通知需要用户在场可见，不适用于无人值守环境
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux 诊断 本页 | 51 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 工作区操作技能 | 64 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 共享行为规则 | 48 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 设置管理技能（cmux-settings） | 58 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux-browser：cmux 内置浏览器自动化技能 | 60 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
源材料中没有针对诊断工具的直接竞品对比；它与 tmux 的关系在 README 中被描述为：tmux 是任意终端内的复用器，而 cmux 是带 GUI、socket API 的原生 macOS 应用，本技能只诊断后者。
FollowSkills 如何评估这个 Skill？
技能明确默认只读，禁止输出 hook 配置、会话 JSON、令牌与密钥，修复类命令（hooks setup/uninstall）要求用户同意后才执行，数据流披露较好。扣分点：引用的捆绑脚本 cmux-diagnostics 本体未在证据中提供，无法核验其是否真正只读；发布者未经验证，许可元数据为 NOASSERTION，归属与外部影响核验不完整。
SKILL.md 指令自洽，提供了三个安装路径的回退、逐项检查步骤和较系统的解读表（找不到 CLI、ping 失败、无环境变量等异常的成因与处置），失败反馈质量高于平均。扣分点：脚本本身未提供、无测试或复现证据，静态评审下按锚点不能超过 10；多路径回退在环境不符时行为未完全定义。
frontmatter 描述清晰列出了触发场景（hooks、通知、会话恢复、设置、CLI 不工作、健康检查），触发语义较精确；明确目标为 macOS + cmux 终端用户。扣分点：非适用边界（如非 cmux 终端环境仅部分说明）、中文支持与国内网络可达性（依赖 cmux.com 文档、GitHub 发布下载）未见声明。
文档结构清晰（快速报告→检查项→解读→规则），有渐进式披露和 agent 元数据文件。扣分点：技能级无独立版本/变更记录，许可元数据为 NOASSERTION，捆绑脚本无注释或维护说明，故障排查依赖主仓库 README 而非技能内 FAQ。
技能以只读诊断脚本加解读规则完成核心任务，输出为支持安全摘要，相对手动逐条排查有边际价值。扣分点：静态评审无法验证脚本实际输出格式与可用性，脚本文件缺失使核心交付物不可核验，收益证据限于文档自述。
仓库含真实 CI 工作流与测试，但均针对应用本体而非该技能的关键路径；技能的声明（脚本只读、检查命令存在）无一手可审计材料。扣分点：无技能级测试、复现记录或第三方佐证，事实与推断未分离标注。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →