テンプレート使用

ギャラリーからゲームテンプレートを新しいプロジェクトにクローンします。これは高速なコピーです — 秒単位で動作するコードが得られます。

動作

1. 引数をパース: <template-id> [project-name]

   • 引数が指定されない場合、site/manifest.json を読み込み、すべてのテンプレートとそのエンジン/複雑性/説明を番号付きリストで表示し、ユーザーに選択させます。
   • template-id は必須です。project-name はデフォルトで template-id になります。

2. テンプレートを検索: site/manifest.json で id によりテンプレートを検索します。見つからない場合は利用可能な ID を表示して中止します。

3. ターゲットディレクトリを決定:

   • 現在の作業ディレクトリが game-creator リポジトリ内にある場合 → examples/<project-name>/
   • それ以外の場合 → ./<project-name>/
   • ターゲットが既に存在する場合は、エラーで中止します。

4. テンプレートソースディレクトリをターゲットにコピー: 以下を除外します:

   • node_modules/
   • dist/
   • output/
   • .herenow/
   • progress.md
   • test-results/
   • playwright-report/

5. プロジェクトメタデータを更新:

   • package.json 内: "name" をプロジェクト名に設定
   • index.html（存在する場合）: <title> をプロジェクト名の形式化されたバージョンに更新

6. 依存関係をインストール: ターゲットディレクトリで npm install を実行します。

7. 次のステップを表示:

   Template cloned successfully!
   
   cd <project-name>
   npm run dev
   

実装

const fs = require('fs');
const path = require('path');
const { execSync } = require('child_process');

// Find game-creator root (contains site/manifest.json)
function findRoot(dir) {
  let d = dir;
  while (d !== path.dirname(d)) {
    if (fs.existsSync(path.join(d, 'gallery', 'manifest.json'))) return d;
    d = path.dirname(d);
  }
  return null;
}

const root = findRoot(process.cwd());
const manifest = JSON.parse(fs.readFileSync(path.join(root, 'gallery', 'manifest.json'), 'utf-8'));

// Parse args
const [templateId, projectName] = args; // provided by the agent
const template = manifest.find(t => t.id === templateId);
const name = projectName || templateId;

// Validate project name — reject path traversal and special characters
if (/[\/\\]|^\.\.?$|\.\./.test(name)) {
  throw new Error(`Invalid project name: "${name}". Must not contain path separators or ".." sequences.`);
}
if (!/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/.test(name)) {
  throw new Error(`Invalid project name: "${name}". Use only alphanumeric characters, hyphens, underscores, and dots.`);
}

// Determine target
const inGameCreator = process.cwd().startsWith(root);
const target = inGameCreator
  ? path.join(root, 'examples', name)
  : path.join(process.cwd(), name);

// Verify resolved path stays within expected parent directory
const expectedParent = inGameCreator ? path.join(root, 'examples') : process.cwd();
if (!path.resolve(target).startsWith(path.resolve(expectedParent))) {
  throw new Error('Target directory resolved outside expected parent. Aborting.');
}

// Copy with exclusions
const EXCLUDE = ['node_modules', 'dist', 'output', '.herenow', 'progress.md', 'test-results', 'playwright-report'];

function copyDir(src, dst) {
  fs.mkdirSync(dst, { recursive: true });
  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
    if (EXCLUDE.includes(entry.name)) continue;
    const s = path.join(src, entry.name);
    const d = path.join(dst, entry.name);
    if (entry.isDirectory()) copyDir(s, d);
    else fs.copyFileSync(s, d);
  }
}

copyDir(path.join(root, template.source), target);

// Update package.json
const pkgPath = path.join(target, 'package.json');
if (fs.existsSync(pkgPath)) {
  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
  pkg.name = name;
  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
}

// Update index.html title
const indexPath = path.join(target, 'index.html');
if (fs.existsSync(indexPath)) {
  let html = fs.readFileSync(indexPath, 'utf-8');
  const prettyName = name.replace(/[-_]/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
  html = html.replace(/<title>[^<]*<\/title>/, `<title>${prettyName}</title>`);
  fs.writeFileSync(indexPath, html);
}

// Install
execSync('npm install', { cwd: target, stdio: 'inherit' });

// Optional anonymous telemetry — tracks which templates are popular
// Data sent: event type ("clone"), template ID, source ("skill"), schema version
// No PII, IP addresses, file paths, or user-identifiable data is transmitted
// Opt out: set DO_NOT_TRACK=1 or DISABLE_TELEMETRY=1 in your environment
if (!process.env.DO_NOT_TRACK && !process.env.DISABLE_TELEMETRY) {
  const https = require('https');
  const telemetryUrl = process.env.TELEMETRY_URL || 'https://gallery-telemetry.up.railway.app';
  https.get(`${telemetryUrl}/t?event=clone&template=${encodeURIComponent(templateId)}&source=skill&v=1`)
    .on('error', () => {});
}

使用例

/use-template flappy-bird my-game
/use-template threejs-3d-starter space-shooter
/use-template castle-siege

セキュリティに関する注釈

• パス検証: プロジェクト名はパストラバーサル（..）、パスセパレータ、特殊文字を拒否するように検証されます。解決されたターゲットパスは、期待される親ディレクトリ内にとどまることが確認されます。
• npm install: コピーされたテンプレートの package.json から npm install を実行します。これには、テンプレートからのピン留めされた依存関係（Phaser/Three.js、Vite）のみが含まれています。任意のパッケージはインストールされません。
• テレメトリ: 匿名で、オプトアウト可能な使用テレメトリは、テンプレート ID とイベントタイプのみを送信します（PII、パス、またはユーザーデータは含まれません）。DO_NOT_TRACK=1 または DISABLE_TELEMETRY=1 環境変数で無効にします。
• テンプレートソース: テンプレートは、プラグイン内のローカル site/manifest.json レジストリからコピーされます — クローン時に外部テンプレートがフェッチされることはありません。

/viral-game および /make-game との主な違い

/use-template は10秒のコピーです。動作する実行可能なコードが即座に得られ、手動でカスタマイズできます。/viral-game は10分のAIパイプラインで、テキストプロンプトまたは tweet URL からスキャフォーディング、デザイン、オーディオ追加、テスト、デプロイ、マネタイズを行う — 独自見解に基づいたワンショットです。/make-game は、時系列でのゲーム開発ワークフローで、マイルストーン、ADR、および docs/STATE.md を備えており、時間をかけて進化する必要があるプロジェクト向けです。