mcpField
S
setup-roblox-skills

setup-roblox-skills

github.com/ashexplainedエージェントワークフロー3896 回インストール17 週間前に更新
リポジトリ

setup-roblox-skills について

setup-roblox-skills は、プロンプト駆動型のセットアップスキルです。Roblox スキルパックをゲームプロジェクトに合わせ、ライフサイクル案内、スキルのルーティング、トラッカー、トリアージラベル、UI デザイン資料の配置を設定します。

主な機能

  1. 01既存のプロジェクト規約を確認
  2. 02ライフサイクルとスキル一覧を設定
  3. 03次に使うスキルの案内を設定
  4. 04トラッカーとトリアージ設定を作成
  5. 05UI デザイン資料の構成を定義

活用シーン

  1. 01既存ゲームに Roblox スキルを接続
  2. 02ローカルまたは GitHub のトラッカーを選択
  3. 03プロジェクト固有のトリアージラベルを記録
  4. 04UI デザインブリーフの保存先を設定

インストール

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

$npx skills add https://github.com/ashexplained/roblox-skills --skill setup-roblox-skills

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

claude-block.md
design-artifacts.md
tracker-github.md
tracker-local.md
triage-labels.md

詳細

Roblox スキルのセットアップ

Roblox スキルパックを特定のゲームプロジェクトに組み込み、すべてのスキルがライフサイクルや関連するスキル、このプロジェクトで作業を追跡する場所を把握できるようにします。また、各スキルの最後に、次に実行するものを提案するようにします。

これはプロンプト駆動型のスキルであり、スクリプトではありません。調査し、いくつか簡単な質問をし、確認してから書き込みます。

トラッカーは計画用であり、コード用ではありません。 ゲームの Luau コードとインスタンスは Roblox クラウドのエクスペリエンスにあり、Studio MCP(roblox-studio-workflow)を通じて編集します。Git には決してコミットしません。Git/トラッカーに置くのは、ROADMAP.md、PRD、スライス、UI デザインブリーフなどの計画成果物のみです。セットアップ時にこの点を明確にしてください。

書き込む内容

  1. プロジェクトの CLAUDE.md に ## Roblox Skills ブロックを追加します。このブロックには次の内容が含まれます。
    • ゲーム開発のライフサイクルマップ(フェーズごとに実行するスキル)
    • スキルカタログ — 各スキルの一行の目的、「使用する場面」、トリガーワード
    • 次のスキルへのルーティングに関する規約:任意のスキルの最後に、次に実行するスキルをユーザーに伝えます。 正式なブロックは claude-block.md にあります。このプロジェクトにインストールされていないスキルフォルダーは除外し、ブロックをそのまま挿入してください。
  2. docs/agents/ の設定ファイル:トラッカー、トリアージラベル、UI デザイン成果物のレイアウト。

手順

1. 調査

既存の内容を確認してください。決めつけてはいけません。

  • git remote -v — このゲームプロジェクトは GitHub リポジトリですか?
  • ルートの CLAUDE.md — 存在しますか?すでに ## Roblox Skills ブロックがありますか?
  • ROADMAP.md、roadmap/、.roblox/ — ローカルのロードマップ/トラッカーの規約はすでに使われていますか?
  • docs/agents/ — 前回の実行ですでに設定が書き込まれていますか?
  • design/ — UI デザインブリーフはすでにありますか?
2. 質問(1つずつ)

ユーザーは初めてかもしれないと想定してください。一行で説明してから、選択肢とデフォルトを示します。

A — 作業の追跡場所は? roblox-to-issues のスライスと roblox-triage のバグには、保存先が必要です。

  • ローカルロードマップ(デフォルト、Studio 優先) — インデックスとして ROADMAP.md を使い、roadmap/<feature-slug>/ の下に Markdown ファイルを置きます。Git リモートがない環境で Studio を使って開発する個人開発者に最適です。tracker-local.md を元に作成します。
  • GitHub Issues — gh CLI を使って、プロジェクトの GitHub リポジトリに Issue を作成します。GitHub リモートがある場合は、こちらを提案してください。tracker-github.md を元に作成します。
  • その他(Trello、Notion など)— ユーザーに一文で説明してもらい、その内容を文章として記録します。

B — トリアージラベル。 標準の5つの状態(needs-triage、needs-info、ready-to-build、needs-human、wontfix)に、カテゴリ(bug、enhancement)を加えます。デフォルト値はそれぞれの名前です。ユーザーがすでに異なる文字列を使っている場合に限り、質問してください。triage-labels.md を元に作成します。

C — UI デザイン成果物。 承認済みのデザインブリーフができるまで、UI スライスは実装できません(roblox-game-ux を参照)。レイアウトを確認してください(デフォルト:design/features/<feature-slug>/ の下に Markdown のブリーフを置き、必要に応じて参考画像/スクリーンショットを添付します。Roblox UI は Studio で構築するため、これらは仕様書であり、HTML のスタイルキットではありません)。design-artifacts.md を元に作成します。

3. 確認

## Roblox Skills ブロックと docs/agents/*.md ファイルのドラフトをユーザーに提示します。書き込む前に編集できるようにしてください。

4. 書き込み
  • CLAUDE.md が存在する場合は編集します。存在しない場合は、作成する前に確認してください(ユーザーが AGENTS.md を希望する場合は、そちらを選んで編集し、両方は作成しません)。
  • ## Roblox Skills ブロックがすでに存在する場合は、その場で更新します。重複して追記したり、前後のセクションを上書きしたりしないでください。
  • claude-block.md のブロックを挿入します。ここにインストールされていないスキルフォルダーは、作り上げずに除外してください。
  • 選択したシードファイルを元に、docs/agents/tracker.md、docs/agents/triage-labels.md、docs/agents/design.md を作成します。
5. 完了

セットアップが完了したこと、今後はすべての Roblox スキルがライフサイクルとルーティングのためにこのブロックを参照すること、また、このスキルを再実行しなくても後から docs/agents/*.md を編集できることをユーザーに伝えます。

次のステップ

roblox-game-development-lifecycle でゲームを開始(または再開)します。このスキルは、このブロックを読み取って現在のフェーズを確認し、適切な専門スキルへ案内します。まったく新しいゲームの場合は、roblox-game-ideas に進みます。

コメント