roblox-triage

Roblox のトリアージ

スライスやバグ報告を小さなステートマシンで進め、「ビルド準備完了」とマークされたものが、すべて1回の集中した作業でビルドできるほど十分に仕様化され、完了後にプレイテストできる状態になるようにします。

トラッカーの場所とラベルの語彙は、CLAUDE.md / docs/agents/ に記載されているはずです。記載がない場合は、setup-roblox-skills を実行してください。トラッカーが GitHub の場合は、AI が作成するコメントの先頭に > *Generated by AI during triage.* を付けてください。

参考資料

• BUILD-BRIEF.md — ready-to-build スライス向けの、長期的に使えるビルドブリーフの書き方。

ロール

カテゴリロールは2つです。

• bug — ゲーム内の何かが壊れています。
• enhancement — 新しいスライス／機能です。

状態ロールは5つです。

• needs-triage — まだ評価されていません。
• needs-info — 判断や詳細についてユーザーからの回答を待っています。
• ready-to-build — 仕様が完全で、不足している情報なしにエージェントが1回の作業でビルドできます。
• needs-human — ユーザーによる対応（Studioでの操作、デザイン上の判断、バランスの評価、購入テスト）が必要です。
• wontfix — 対応しません。

トリアージ済みの各項目には、カテゴリロールが1つ、状態ロールが1つだけ割り当てられます。これらは標準の名前です。実際のラベル／ステータス文字列は docs/agents/triage-labels.md に記載されています。

通常のフロー：needs-triage →（needs-info ↔ needs-triage）→ ready-to-build / needs-human / wontfix。ユーザーは上書きできます。通常と異なる点があればフラグを立て、まず確認してください。

UI デザインのゲート

ユーザー向け UI を変更するスライスは、承認済みのRoblox UI デザイン成果物が用意されるまで ready-to-build にできません（成果物に含める内容については roblox-game-ux を参照してください。レイアウト、状態、モバイル／タブレット／デスクトップでの動作が含まれ、Status: approved と記載されている必要があります）。成果物がない場合、またはまだドラフトの場合は、まず UI デザインの工程が必要である旨を記載し、スライスを needs-human にします。

呼び出し方

ユーザーは「次に何をビルドすべき？」「このバグをトリアージして」「このスライスは準備できてる？」「coin-pickup スライスをビルド準備完了にして」のような自然言語で呼び出します。意図を解釈して対応してください。

対応が必要な項目を表示する

古いものから順に、次の3つのバケットを提示します。未トリアージ、needs-triage、新しいユーザー入力がある needs-info。各項目の概要を1行で示し、ユーザーに選んでもらいます。

1つの項目をトリアージする

1. コンテキストを集めます。 項目の全文と、同じ質問を繰り返さないよう過去のトリアージノートを読みます。roblox-studio-workflow 経由で接続し、関連するスクリプトやインスタンスを調べます。UI 項目ではデザイン成果物を確認します。
2. 推奨を提示します。 推奨するカテゴリと状態、その理由、および関連するゲームの状態の簡潔な概要を伝えます。指示を待ちます。
3. 再現します（バグのみ）。 それ以外の作業に入る前に、Studio のプレイテストで再現を試み、get_console_output を読みます。（失敗するコードパスを確認できた）再現が確認できれば、より強力なビルドブリーフを作成できます。再現できない場合は、needs-info とする強い根拠になります。難易度の高いバグは roblox-debugging-bugfix に引き継ぎます。
4. 明確化します（必要な場合）。 項目が曖昧な場合は、短い質問を重ねる工程を実行し（roblox-game-ideas の質問モードを参照）、判断に必要な点を絞り込みます。
5. 結果を適用します。
   • ready-to-build — ビルドブリーフを投稿します（BUILD-BRIEF.md）。UI の場合は、承認済み成果物のパスを記載します。
   • needs-human — 同じ構成で、委任できない理由を記載します。
   • needs-info — 確認できたことと、未解決の具体的な質問をトリアージノートとして投稿します。
   • wontfix — 理由を簡潔に記載します。エンハンスメントの場合は、再提案されないよう、対応しない理由も記載します。

クイック上書き

ユーザーが「X をビルド準備完了にして」と言った場合は、競合する状態ロールと UI デザインのゲートを確認したうえで、その指示を信頼して適用します。UI 成果物がない場合は、不足しているものを具体的に伝え、ready-to-build にする前に明示的な上書きの指示を求めてください。

次のステップ

ready-to-build スライスを、そのフェーズの専門家（roblox-luau-architecture、roblox-combat-systems、roblox-ui-implementation、roblox-datastore-persistence など）とともに構築し、その後、roblox-playtest-qa と roblox-mobile-playtest で検証します。バグのトリアージが済んでいる場合は、roblox-debugging-bugfix に引き継ぎます。次のスライスを選ぶため、roblox-game-development-lifecycle に戻ります。