superset-doctor について
superset-doctorは、Supersetのサービス、認証、ホスト、バージョンの問題を診断するスキルです。まず読み取り専用の確認を行い、状態を変更する修正の前に承認を求め、結果を検証してから証拠を添えてエスカレーションします。
主な機能
- 01読み取り専用の並列ヘルスチェック
- 02症状に応じた既知の修正方法
- 03状態変更前の承認確認
- 04修正の検証とエスカレーション用証拠の収集
活用シーン
- 01Supersetの認証失敗の診断
- 02オフラインのホストや停止中サービスの調査
- 03CLIとデスクトップアプリのバージョン不一致の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/superset-doctorを入力して読み込まれたか確認します。
詳細
Superset の診断
まず診断し、変更は一度に 1 つだけ行い、変更のたびに確認します。
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 対応