MapStage は何をしますか？

MapStageシーンを構築またはチューニングする際にこのスキルを使用します。地図/地球儀投影法、衛星画像、標高段彩図、Mapterhorn地形、地域分離、CSSカラーグレーディング、JSONエクスポートに対応します。

使用するタイミング

ライブのMapStageチューナーが必要な場合（地図 vs 地球儀、衛星画像 vs 標高段彩図、分離表示）。
ペイント / CSS / カメラを固定し、JSONを他のホストにエクスポートする必要がある場合。
階層化された集落（capital / large / medium / small / pass / station / ordos）が必要な場合。

チューナーページを最終的なレンダリングホストとして 使用しないでください。

モード	目的
プロダクションスタック	MapStageをアプリに埋め込みます。オプションで衛星画像/ラスター + Mapterhorn DEM（`encoding: 'terrarium'`）+ 陰影図 + OpenFreeMapベクター水系 + CSSフィルター + 都市の押出し。外観はエクスポートされたJSONで制御します。
チューナー	`tuner/` ディレクトリ下のローカルHTTPページ。スライダー、投影法、分離表示、プリセットのロード/エクスポートを行います。

チューナーを起動: cd tuner && python -m http.server 8765 → http://localhost:8765/
タイル: デフォルトは EOX Sentinel-2 cloudless + Mapterhorn（tuner/map-tiles.config.js）。gitignoreされた map-tiles.config.local.js で上書き可能。
デフォルトプリセット tuner/preset-antique-default.json を適用（tuner/presets/antique-default.json と同じ）。
投影法 / 衛星画像 / 標高段彩図 / 分離表示 / CSS / 都市を調整し、見た目を確定させます。
チューナーから JSONをエクスポート します（コピーまたはダウンロード）。
ペイント + カメラ + CSSフィールドをプロダクションのMapStageシーンに移行します（リファレンスを参照）。
プロダクション環境では: jumpTo でカメラ移動; idle を待機; オプションでタイルを事前キャッシュ。録画フレームでは easeTo / flyTo を避けてください。
常にDEMを encoding: 'terrarium' で設定してください。エンコーディングが間違っていると陰影図/地形が壊れます。
最終フレームはプロダクションホストからレンダリングします — チューナーUIから ではありません。

タイルはバンドルされていません — MapStageは実行時に 設定された URLからのみDEMとベースマップを取得します。
使用が許可されているベースマップエンドポイントのみを使用してください — デフォルトは公開デモタイル（EOX）です。必要に応じて設定で切り替えてください。
地形ソースには encoding: 'terrarium' — 必須です。
録画されたプロダクションパスでは easeTo / flyTo は使用禁止。代わりに jumpTo + idle を推奨します。
最終レンダリングをチューナーでホストしないでください。
水系は組み込みのOpenFreeMap / OpenMapTilesベクターレイヤーです。tuner/assets/water-data.js を期待したりコミットしたりしないでください。

表示名/デフォルトプロンプトについては agents/openai.yaml を参照してください。