关于 superset-doctor
superset-doctor 是用于排查 Superset 服务、身份验证、主机和版本问题的技能。它先执行只读检查，运行会改变状态的修复前征求同意，并在升级处理前验证结果、收集证据。
主要功能
- 01并行执行只读健康检查
- 02按症状匹配已知修复方法
- 03变更状态前征求同意
- 04验证修复并收集升级处理证据
适用场景
- 01排查 Superset 身份验证失败
- 02调查主机离线或服务未运行
- 03检查 CLI 与桌面应用版本不匹配
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/superset-doctor确认已加载。
详细介绍
Superset 诊断
先诊断，每次只更改一项，并在每次更改后验证。
1. 获取快照（只读，并行运行，容忍失败）
superset status— 主机服务健康状态superset auth whoami— 身份验证和当前组织superset hosts list— 主机可达性superset --version
2. 匹配已知特征
| 特征 | 修复方法 |
|---|---|
whoami 失败 / 会话已过期 | superset auth login |
| 主机显示为离线 | superset hosts wake <id>；确认机器已唤醒且处于在线状态 |
| 主机服务未运行 | superset start |
| CLI 与桌面应用版本不匹配，或 CLI 版本过旧 | superset update |
| 应用端行为异常（macOS） | 查看 ~/Library/Logs/Superset/main.log 中最新的错误记录 |
提出对应的修复方案，并在执行任何会更改状态的操作前征得用户同意。绝不要以删除数据作为“修复”方式。
3. 验证
重新执行最初失败的操作。如果成功，明确说明具体问题及修复方法。
4. 提供证据并升级处理
如果问题仍未解决，可提出通过 superset:feedback 技能提交反馈 — 附上已收集的诊断信息（版本、状态输出和相关日志摘录），以便报告在提交时就已完成初步分类。纳入任何日志内容前都要先征求同意；日志可能包含路径和项目名称。
评论
支持 Markdown