create-ai-game-research

create-ai-game-research は、日本の小学生が自由研究で「生成AIを使ったゲーム開発」を体験するためのスターターキットを作るCLIです。

Codexと一緒に、ゲームの企画、設計書づくり、HTMLゲーム実装、Playwrightでの確認、最後の自由研究レポート作成まで進めるための初期ファイルを生成します。

使い方

npm create ai-game-research my-game

公開後、またはローカルでリンクした状態では次の形でも使えます。

npx create-ai-game-research my-game

生成後は、作ったフォルダに移動して必要なセットアップを行います。

cd my-game
npm install
npm run setup:playwright
npm run test:e2e

このCLIは npm install、Playwrightブラウザ導入、git init を自動実行しません。子どもの作業環境や大人の確認タイミングに合わせて、手動で進める方針です。

生成されるプロジェクト

生成先には、主に次のファイルとフォルダが入ります。

• AGENTS.md: Codexに守ってほしい進め方
• README.md: 生成されたプロジェクト用の説明
• adult-guide.md / child-guide.md: 大人向け・子ども向けガイド
• game.html: ゲーム本体の初期プレースホルダー
• design.html: 実装前に確認する設計書
• report.html: 自由研究レポートの初期HTML
• assets/: 画像や素材の管理場所
• screenshots/: Playwrightなどで撮った画面保存場所
• tests/: PlaywrightのE2Eテスト
• tools/: スクリーンショット保存やライブラリ準備の補助ツール
• .agents/ / .codex/: Codex用のSkillやHook

ゲーム本体は、原則として game.html 単体で動くように作ります。画像が必要になった場合は assets/ も一緒にコピーすればChromebookで動かせる形を目指します。

画像生成について

画像生成はCLIやCodexから自動実行しません。必要な場合は、Codexが assets/image-prompts.md にChatGPT Images 2.0向けのプロンプトを作り、大人が手動で画像を生成して assets/images/ に保存します。

公開前のローカル確認

npm publish前に、ローカルでパッケージ内容を確認できます。

node bin/create-ai-game-research.js sample-game-local

npm pack --dry-run

実際の .tgz を作って試す場合は、次のように確認できます。

npm pack
npx ./create-ai-game-research-0.1.0.tgz sample-game

このリポジトリでは、まだ npm publish は行いません。

ライセンス

MIT Licenseです。詳しくは LICENSE を見てください。