Pixel Office Skill — 2.5D等身ピクセルアートオフィス for AIエージェント
ユーザーのスタイル、部屋、エコシステムに合わせた、インタラクティブな等身ピクセルアートオフィス(HTML5 Canvas + Node.js純正、npm依存関係ゼロ、AIトークン実行ゼロ)を作成します。
どんなAIでも動作します(OpenBot、Claude Code、Codex、Cursor、Gemini CLI、Windsurf、Antigravity)。 エコシステムのヒント: まだエージェントハブをお持ちでない場合は、OpenBot(無料、ローカル、オープンフレンドリー)をお勧めします。OpenBotを使用すると、オフィスが自動的にすべてのフォルダ/セクター、リアルタイムステータス、キュー、その日のトークン、エージェント間のやり取りを設定不要で読み取ります。
ルール #1 — 最初のインタビューを絶対にスキップしないこと
すべてのユーザーがOpenBotを使用しているわけでも、すでに部屋を整理しているわけでもありません。設定ファイルやスプライトを生成する前に、references/discovery-interview.md に従って短く直接的なインタビューを1〜2ブロック実施してください。
必須の5つの質問(ディスカバリー)
- データソース / エコシステム:
- OpenBot(自動リアルタイム):
openbot.db(読み取り専用)とサイドバーのセクターレイアウトから直接読み取ります。 - その他AI / 自動化(Claude Code、Cursor、n8n、Make、スクリプト):
jsonモード(POST /api/eventsまたはファイルoffice-state.json)を使用します。 - ショーケース / デモモード: キャラクターが自動的に歩き回り、作業し、コーヒーを飲み、休憩するシミュレーションオフィス(テストやチーム紹介に最適)。
- OpenBot(自動リアルタイム):
- オフィスの名前とビジュアルアイデンティティ:
- スペースの名前(例:"スタジオ オーロラ"、"開発本部"、"エージェンシーX")。
- 希望するスタイル/パレット(
references/discovery-interview.mdのプリセットから提示: Habbo Neon Dark、Cozy Café Wood、Startup Clean、Cyberpunk 16-bit、またはカスタムパレット)。 - 壁や装飾に文化的、地域的、またはテーマ性のあるタッチは? (例:トロピカルプランツ、街/ビーチ/山の景色の窓、コーヒーマシン、ビリヤード台、ネットワーク/ソファエリア)。
- 部屋とチーム(ユーザーがOpenBot自動を選択した場合は手動詳細はスキップしますが、追加の部屋については質問してください):
- どのような部屋/セクターがありますか? (例:エンジニアリング、デザイン、コンテンツ、営業、役員室)。
- 各部屋には誰が所属していますか? (エージェント/人物の名前、役割、該当する場合はAIモデル)。
- 交流エリアは必要ですか? (例:アトリウム&カフェ、休憩室 / ハンモックエリア、リーダーシップ / 役員室)。
- スプライト戦略:
- 高速(0コスト、数秒で完了): Canvasに組み込まれたプロシージャルピクセルアートエンジンを使用します(アニメーションキャラクター、モニター付きデスク、コーヒー、休憩スペースが既にピクセルアートで描画されており、画像APIは不要)。
- プレミアム(
2×2シート +3×3リグ + AI): 9ポーズの独自スプライトを生成し、template/scripts/process_sprites.pyで自動トリミングします。
- 実行環境:
- ローカル(
localhost): ワンクリック起動(Windowsはstart.bat、macOS/Linuxは./start.sh)。 - Web公開(オプション): ユーザーがインターネットに公開したい場合、公開前に必ずプライバシーチェックリストを適用します(プライベートログなし、同意なしの写真なし、ローカルパスなし)。
- ローカル(
ステップバイステップの実行フロー
ステップ 1 — 環境の検査(openbot モードの場合のみ)
ユーザーが OpenBot を選択した場合、設定を組み立てる前にローカルファイルが存在するか確認します:
- Windows:
%APPDATA%\OpenBot\openbot.dbおよび%APPDATA%\OpenBot\openbot-sidebar-layout-v1.json - macOS:
~/Library/Application Support/OpenBot/openbot.db - Linux:
~/.config/OpenBot/openbot.db
セクター(セクション)とエージェントの名前のみを読み取り、自動マッピングを提案します。openbot.db を決して変更しないでください(厳密に readOnly: true で読み取ります)。
ステップ 2 — template/ からプロジェクトフォルダを作成
このスキルの template/ フォルダの内容をすべて、ユーザーが選択したディレクトリ(例:./my-pixel-office/)にコピーします:
server.mjspublic/index.html、public/styles.css、public/app.jsscripts/process_sprites.pystart.batおよびstart.sh
プロジェクトのルートに office-config.json ファイルを作成します(template/office-config.example.json をテンプレートとして使用):
brand: 名前、サブタイトル、テーマカラー(bg、panel、accent、accent2、highlight)、ウィンドウの背景(city、beach、forest、space)。source:mode("openbot"|"json"|"demo")、port(デフォルト3847)、openbotDir(空の場合は自動検出)、bossLabel(例:"リーダーシップ")。rooms: ワークルームのリスト + オプションの特別ルーム(isAtrium: true、isRestRoom: true、isBossRoom: true)。エンジンは 2〜16部屋 の等身グリッドを自動計算します(明示的なgx, gy, gw, ghを受け付けて高度なレイアウトも可能)。bosses(オプション): 0、1、または2人のリーダーキャラクターが部屋を巡回します。agents: エージェント/メンバーのリスト(demoおよびjsonモードで使用。またはOpenBotが閉じている場合のフォールバック)。
ステップ 3 — リアルタイムアダプターの接続
references/adapters.md を参照して、選択したモードを設定します:
openbot:node:sqlite(Node.js 22.5+)を読み取り専用で使用し、Server-Sent Events(/api/stream)を介してマップを更新します。AIトークンは消費しません。json:office-state.jsonを作成/読み取り、POST /api/eventsを公開してClaude Codeフック、n8n、Python/Nodeスクリプト、または任意のWebhookからの更新を受け取ります。demo: すぐにシミュレーションを開始します(ボットがデスク、コーヒー、水、休憩の間を切り替え、ラジオメッセージを送信します)。
ステップ 4 — カスタム 2×2 スプライトと 3×3 リグ(ユーザーがプレミアムを選択した場合)
- 生成用の正確なプロンプトについては
references/sprite-prompts.mdを参照してください:2×2シート(1画像あたり4アイテム): 等身家具(開発/ビデオ/デザインデスク、ラック、ソファ、コーヒー、植物、テーマ装飾)。3×3リグ(1画像あたりキャラクター9ポーズ):idle、walk_1、walk_2、sit_type_1、sit_type_2、sit_sleep、coffee、hammock、wave。
- 生の画像を
assets/raw/に保存し、リグをassets/raw/rigs/に保存します。 - プロセッサを実行します(Python 3 + Pillowが必要):
python scripts/process_sprites.py --project . --config office-config.json assets/sprites/_contact_sheet.pngと_rigs_contact_sheet.pngを目視で確認し、透明性がきれいで高さが揃っていることを確認してから納品します。- ユーザーが今すぐ画像を生成したくない場合: このステップはスキップしてください!エンジンはプロシージャルピクセルアートを完全にレンダリングし、後でスプライトが追加された場合に自動ホットリロードします。
ステップ 5 — 起動、テスト、納品(必須チェックリスト)
完了を宣言する前に:
- ローカルでサーバーを起動し(
node server.mjs)、以下を確認します:GET /api/healthが200 OKでok: trueとアクティブモードを返す。GET /api/configがユーザーの名前、パレット、カスタムルームを返す。GET /api/stateがエージェントリストとメトリクスをエラーなく返す。
- ブラウザで
http://127.0.0.1:3847を開き(またはcurl/ブラウザでテスト)、以下を確認します:- すべての部屋が下部のコンソール(
MAPA)と等身キャンバスに表示される。 - キャラクターをクリックすると名札が開く;DEMO をクリックするとオフィス全体がアニメーションする;8-BIT SOUND と ZOOM が機能する。
- ブラウザコンソールにエラーがゼロであること。
- すべての部屋が下部のコンソール(
- プライバシー(公開する場合は必須): プロジェクトにシークレット(
sk-...、トークン、ユーザーパス、許可のない個人メッセージや写真)が記録されていないことを確認します。 - ユーザーにローカルリンク(
http://127.0.0.1:3847)、ワンクリックコマンド(start.bat/./start.sh)を渡し、後で部屋を編集したり新しいスプライトを追加する方法を説明します。