mcpField
S
superset-contribute

superset-contribute

github.com/paradevai開発7105 回インストール14 週間前に更新
リポジトリ

superset-contribute について

superset-contributeは、Supersetリポジトリへの貢献について、作業範囲の判断からワークスペースの準備、プルリクエストの作成まで案内するスキルです。リポジトリ固有の指示を優先し、マージ可能な変更に必要なチェックと証拠を示します。

主な機能

  1. 01変更の規模に応じた進め方の判断
  2. 02フォーク、クローン、ワークスペースの設定
  3. 03Lint、型チェック、テストの実行
  4. 04プルリクエストの準備と提出

活用シーン

  1. 01Supersetの不具合やドキュメントの修正
  2. 02方針を合意してからの機能開発
  3. 03リポジトリのルールに沿った貢献の準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/paradevai/skills --skill superset-contribute

インストール後、Claude Code で/superset-contributeを入力して読み込まれたか確認します。

詳細

Superset への貢献

「Superset で X を修正/構築したい」というユーザーの意向を、リポジトリのルールに従ったマージ可能な PR につなげます。チェックアウトしたリポジトリに CONTRIBUTING.md/DEVELOPMENT.md/AGENTS.md がある場合は、それらが正式な指針です。内容を確認し、この概要よりも優先してください。

1. まず変更の範囲を決める

  • バグ修正、ドキュメント、小規模な改善 → そのまま PR を作成します。Issue は不要です
  • 新機能や大規模な変更 → 実装に着手する前に https://github.com/superset-sh/superset/issues/new/choose で Issue を作成し、方針について合意します
  • 質問 → Issue ではなく Superset の Discord で尋ねてください

2. セットアップする

  1. gh auth status を実行し、フォークしてクローンします:gh repo fork superset-sh/superset --clone(または、既存のクローンにフォークのリモートを追加します)
  2. 最適な開発環境として、クローンを Superset アプリのプロジェクトに追加し、変更ごとにワークスペースを作成します。コントリビューションは管理対象のワークツリー内で開発します
  3. 新しいワークスペース/ワークツリーで ./.superset/setup.local.sh を一度実行します(ワークスペースごとのポート、アプリの識別情報、ローカルサービス、シード済みの開発アカウントを設定します。外部の認証情報は不要です)。その後、bun run dev を実行します
  4. Bun のみを使用してください。npm/yarn/pnpm は使用しないでください。ルートの AGENTS.md を読み、その指示に従います。

3. マージ可能な状態にする

  • main からブランチを作成します。1 つの PR につき 1 つの変更とし、無関係な修正は 2 つ目の PR に分けてください
  • プッシュする前に bun run lint:fix を実行し、続いて bun run lint がクリーンに終了すること(CI は警告でも失敗します)、bun run typecheck、bun run test を確認します
  • PR のタイトルは Conventional Commits 形式にします(feat(desktop): ...、fix(web): ...)。PR はタイトルをコミットメッセージとしてスカッシュマージされます
  • 動作することを示す証拠を含めます。ユーザーに見える変更にはスクリーンショットまたは録画を、修正には変更前/変更後を添えてください。開発用デスクトップアプリでは、きれいにキャプチャするための CDP を利用できます。CONTRIBUTING.md の「Capturing screenshots via CDP」を参照してください
  • 「Allow edits from maintainers」にチェックを入れ、重要な変更では Issue へのリンクを追加します

4. PR を作成する

superset-sh/superset の main に対して gh pr create を実行し、PR テンプレートに正確に記入します(実行した内容、クリックした箇所、テストでカバーした内容)。その後、PR の URL をユーザーに伝えます

コメント