review-game

パフォーマンスに関する注意事項

• 時間をかけて、丁寧に作業してください
• 速度より品質を重視してください
• 検証手順を省略しないでください

レビューゲーム

既存のゲームコードベースを分析し、構造化されたレビューを提供します。これはパイプラインの最終ステップです。すべてが正しく連携しているかを確認し、品質スコアを算出します。

手順

$ARGUMENTS で指定されたゲーム（パスが指定されていない場合は現在のディレクトリ）を分析します。

ステップ 1：ゲームを特定する

• エンジンを検出します（Three.js、Phaser、その他）
• package.json の依存関係とスクリプトを確認します
• メインのエントリーポイントと index.html を確認します
• ゲームのコンセプトとジャンルを特定します

ステップ 2：アーキテクチャレビュー

以下の必須パターンを確認し、準拠状況を報告します。

• EventBus：一元化されたイベントシステムはありますか？モジュールは疎結合になっていますか？
• GameState：一元化された状態のシングルトンはありますか？
• 定数：設定値は一元管理されていますか、それともマジックナンバーとして散在していますか？
• オーケストレーター：すべてを初期化するメインの Game クラスはありますか？
• ディレクトリ構造：コードは core/systems/gameplay/ui/level の各レイヤーに整理されていますか？
• イベント定数：イベントは名前付き定数として定義されていますか、それとも生の文字列ですか？

ステップ 3：パフォーマンスレビュー

よくある問題を確認します。

• デルタ時間の上限設定：デススパイラルを防ぐため、getDelta() に上限が設定されていますか？
• オブジェクトプーリング：頻繁に実行されるループ内で一時オブジェクトを再利用していますか？
• リソースの破棄：Three.js のジオメトリ／マテリアル／テクスチャは破棄されていますか？
• イベントのクリーンアップ：シーン遷移時にイベントリスナーはクリーンアップされていますか？
• アセットの読み込み：アセットは進捗表示とともに事前読み込みされていますか？

ステップ 4：コード品質

• 循環依存なし：モジュール間の依存関係は一方向です
• 単一責任：各モジュールの役割は明確に 1 つです
• エラーハンドリング：イベントハンドラーは try/catch で囲まれています
• 一貫した命名規則：イベント名には domain:action を使用し、ファイル名には PascalCase を使用しています

ステップ 5：収益化への準備状況

• ポイントシステム：スコア／ポイントの仕組みはありますか？
• セッション追跡：ゲームセッションを識別できますか？
• チート対策の可能性：スコアはサーバー側で検証されていますか？少なくとも、検証に対応できる構造になっていますか？
• Play.fun との連携：既存の SDK 連携はありますか？

出力形式

以下を含む構造化されたレポートを提示します。

1. ゲームの概要 - ゲームの内容、技術スタック、ゲームループ
2. アーキテクチャスコア（6 項目中）
3. パフォーマンススコア（5 項目中）
4. コード品質スコア（4 項目中）
5. 収益化への準備状況（4 項目中）
6. 主な推奨事項 - 優先順位を付けた改善案と、平易な言葉での説明
7. うまく機能している点 - 良い点

使用例

/review-game examples/flappy-bird

結果：アーキテクチャ 6/6、パフォーマンス 4/5、コード品質 4/4、収益化 2/4 → 主な推奨事項：Play.fun SDK を追加する、パイプ用のオブジェクトプーリングを追加する、デルタ時間に上限を設定する。良い点：EventBus の使い方が整理されている、GameState が適切にリセットされている、ディレクトリ構造がよく整理されている。

次のステップ

ユーザーに次のように伝えてください。

ゲームがパイプライン全体を通過しました！現在の状況は次のとおりです。

• アーキテクチャのスキャフォールド（/viral-game）
• ビジュアルのブラッシュアップ（/design-game）
• 音楽と効果音（/add-audio）
• 自動テスト（/qa-game）
• アーキテクチャレビュー（/review-game）

（これは /viral-game のワンショットパイプラインの状況を示しています。/make-game を順に進めている場合は、「スキャフォールドフェーズの完了後、最初の開発マイルストーンをリリース済み」に相当します。）

次は何をしますか？

• /game-creator:add-feature [description] で新しいゲームプレイ機能を追加する
• ウェブにデプロイする — 即時ホスティングには npm run build && ~/.agents/skills/here-now/scripts/publish.sh dist/ を実行するか、GitHub Pages、Vercel、Netlify、itch.io を利用する
• 開発を続けましょう！変更後はいつでも /design-game、/add-audio、または /review-game を再実行できます。