superset-doctor について
Superset のサービス、認証、ホスト、バージョンの問題を、変更前に診断するスキルです。状態を変更する修正には事前承認を求め、未解決時は収集した情報を添えてエスカレーションします。
主な機能
- 01読み取り専用の状態・バージョン確認
- 02既知のエラー特徴との照合
- 03状態変更前の承認確認
- 04修正ごとの検証
- 05証拠に基づく問題のエスカレーション
活用シーン
- 01Superset のサインイン失敗の診断
- 02接続できないホストの調査
- 03サービスまたはバージョン不一致の解消
インストール
コマンドをコピーしてターミナルで実行します。
$
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 対応