关于 superset-doctor
用于诊断 Superset 服务、认证、主机和版本问题的技能，会先检查再提出修复。执行状态变更前需获同意，并可携带诊断证据升级未解决的问题。
主要功能
- 01只读健康状态与版本检查
- 02匹配已知错误特征
- 03状态变更前征求同意
- 04每次修复后验证
- 05基于证据升级问题
适用场景
- 01诊断 Superset 登录失败
- 02排查无法连接的主机
- 03处理服务或版本不匹配
安装
复制下面的命令，在终端中运行。
$
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