superset-feedback について
Superset Feedbackは、Supersetへの意見を整理したレポートにし、チームへの非公開送信または公開GitHub issueとして提出するスキルです。下書きや任意の証拠、送信先の選択を案内し、提出前に確認を求めます。
主な機能
- 01バグ、要望、一般的な意見に分類
- 02タイトルと報告内容の下書き
- 03スクリーンショットと診断情報の任意添付
- 04非公開送信またはGitHubへの提出
- 05公開issueの重複を確認
活用シーン
- 01Supersetのバグ報告
- 02Supersetへの機能要望
- 03一般的なフィードバックの送信
- 04同意を得た診断情報の添付
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ superset-sh/ skills --skill superset-feedbackインストール後、Claude Code で/superset-feedbackを入力して読み込まれたか確認します。
詳細
Superset のフィードバック
ユーザーが Superset について書いたフィードバックを、適切な形式のレポートにまとめ、希望する宛先に送信できるようサポートします。コマンドの後に書かれた内容を、フィードバックの種として扱ってください。
1. コンテキストを収集する(可能な範囲で。処理を妨げないこと)
並行して実行し、失敗したものはスキップします。
- 環境情報の欄に記載するため、
superset --versionとuname -smを実行します - サインイン中のユーザー/組織を確認するため、
superset auth whoamiを実行します(非公開で送信する場合のみ)
ユーザーが尋ねられた際に明示的に同意しない限り、リポジトリの内容、ターミナルの出力、ログは含めないでください。
バグの場合は、以下についても提案します(決して前提としないでください)。
- スクリーンショット — バグが視覚的なもので、スクリーンショットを撮影できる場合は、添付を提案します。文章よりも証拠が有効です。
- 診断情報 —
--diagnosticsフラグを使って、診断バンドル(CLI のバージョン、OS、アプリの直近 200 行のログ)の添付を提案します。同意を得る前に、ログにはファイルパスやプロジェクト名が含まれる場合があることを伝えてください。
2. 分類して下書きを作成する
ユーザーの言葉から、バグ、機能リクエスト、一般的なフィードバックのいずれかに分類します。本当に曖昧な場合に限り、質問してください。続いて、以下を下書きします。
- タイトル — 命令形で、具体的な 1 行
- 発生したこと/希望すること — ユーザー自身の言葉で 2~5 文
- 再現手順 — バグの場合のみ。番号付き
- 環境 — Superset のバージョン、OS(バグの場合のみ)
3. 送信先を尋ねる
下書き全文を提示してから、以下の選択肢をそのまま使ってユーザーに尋ねます(利用できる場合は ask_user ツールを使い、それ以外の場合は通常の質問として尋ねます)。
- Superset チームに非公開で送信する
- 公開 GitHub issue を作成する
- 先に下書きを編集する
- キャンセルする
ユーザーが 1 または 2 を明示的に選ぶ前に、何も送信してはいけません。編集があれば、その都度繰り返します。
4. 送信する
非公開で送信する場合:
superset feedback --helpが終了コード 0 を返す場合は、標準入力から送信します(注意:--body-file=-のように等号を付けてください。スペースで区切った-はパーサーに拒否されます)。
手順 1 でユーザーが添付に同意した場合に限り、superset feedback submit --type bug --title "..." --body-file=- <<'EOF' <drafted report> EOF--attach /path/to/screenshot.png(カンマ区切りのパス、合計 10MB)や--diagnosticsを追加します。送信はユーザーの Superset アカウントから行われ、ユーザーにも CC でコピーが送られます。チームはユーザーのアカウントのメールアドレスに返信します。- CLI が見つからない場合、またはログインしていない場合(
superset auth whoamiが失敗する場合)は、まずsuperset auth loginを提案します。ユーザーが断った場合は、クリック可能な mailto リンク(mailto:[email protected]?subject=<url-encoded title>&body=<url-encoded body>)を提示し、コピーできるように下書きの生テキストも表示します。
公開する場合:
- まず重複を確認します:
gh search issues -R superset-sh/superset "<key terms>" --limit 5を実行します。該当する既存の issue が見つかった場合は、それを提示し、新しい issue を作成する代わりにそこへコメントする(gh issue comment)ことを提案します。ユーザーが既存の issue とは明確に異なると確認した場合に限り、新しい issue を作成します。 ghがインストールされていて、gh auth statusが成功する場合:gh issue create -R superset-sh/superset --title "..." --body "..."を実行します(heredoc または一時ファイルを使って本文を記述し、インラインでエスケープしないでください)。- それ以外の場合は、事前入力済みのフォームをブラウザーで開きます:
https://github.com/superset-sh/superset/issues/new?title=<url-encoded>&body=<url-encoded>
5. 確認する
issue の URL(公開の場合)、または送信した内容と送信先の確認(非公開の場合)を伝えます。処理に失敗した場合は、ユーザーの文章が失われないよう、下書きを表示します。
コメント
Markdown 対応