Communitygithub.com

AI Blackhole ディレクター

AI Blackhole Studio のオンラインパノラマディレクターをローカルで使用・トラブルシューティングするための Codex スキルです。

AI Blackhole ディレクター とは?

このスキルは、AI Blackhole Studio のパノラマディレクターセッションをローカル環境で操作・トラブルシューティングするためのものです。主なユースケースは、ユーザーが指定したローカル画像を一時的なローカルディレクターセッションにインポートし、静的なローカルサーバーを起動して生成されたURLをブラウザで開くという一連のワークフローを自動化します。スキルには director パッケージ(assets/panorama-director-deploy-v1.2.zip)がバンドルされており、--web-dir が指定されない場合はこれを自動的に展開して使用します。パブリックサイトのURL(https://aiblackhole.net/panorama-viewer)は診断や共有の参照用に残しますが、本スキルのデフォルトパスとしては使用しません。ブラウザ制御が利用可能な場合は、ページの読み込み確認、画像名の表示確認、ビューモードの判定、主要操作(キャラクタ追加、オブジェクト追加、オクルーダー追加、選択変形、サイドバー表示切替、スクリーンショット保存)の動作確認も行います。トラブルシューティングは、ローカルサーバープロセスの状態、画像URLのHTTP応答、必要なアセットの存在、ポートの競合、ブラウザコンソールエラーの順にチェックします。

対応~Claude Code✓Codex CLI~Cursor
npx skills add AIBlackhole/aiblackhole-director-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

AI Blackhole ディレクター は何をしますか?

このスキルは、ユーザーがローカルの AI Blackhole Studio パノラマディレクターセッションを操作するのを支援します。

エントリポイント

デフォルトのワークフローはローカルです:

  1. scripts/local_import.py を使用して、ローカル画像を一時的なローカルディレクターセッションにコピーします。
  2. ローカル静的サーバーを起動します。
  3. 生成された http://127.0.0.1:<port>/panorama-viewer.html?image=... URL を開きます。

このスキルには、assets/panorama-director-deploy-v1.2.zip に director パッケージが含まれています。--web-dir が指定されない場合、ヘルパーはこのバンドルされたパッケージを展開して使用できます。

このスキルのデフォルトパスとして https://aiblackhole.net/panorama-viewer を使用しないでください。パブリックサイトは診断または共有の参照用として残すことができますが、ローカルデプロイが主要なモードです。

コアワークフロー

  1. ユーザーがローカル画像パスを指定した場合、references/local-import.md を読み、scripts/local_import.py を実行します。
  2. ブラウザ制御が利用可能な場合はヘルパー出力URLをブラウザで開き、利用できない場合はユーザーにURLを提供します。
  3. ブラウザ制御が利用可能な場合、ページが読み込まれ、document.body に panorama-loaded クラスがあることを確認します。
  4. ユーザーの次のタスクを特定します:
    • ディレクターを使用する
    • 機能を学ぶ
    • ローカルディレクターファイルをカスタマイズまたはパッケージ化する
  5. 機能ガイダンスについては、references/feature-guide.md を読んでください。
  6. ローカルサーバー、アセット、画像、ルート、またはブラウザの問題については、references/troubleshooting.md を読んでください。
  7. 指示は実用的でユーザー向けに保ってください。画像の自動開封にはローカルヘルパーを優先してください。

ローカル画像インポート

ユーザーがローカル画像パスを指定し、自動的に開きたい場合は、次を使用します:

python <skill-dir>/scripts/local_import.py "<image-path>" --open

ユーザーが画像なしでローカルディレクターをデプロイ/開封したいだけの場合は、次を使用します:

python <skill-dir>/scripts/local_import.py --open

ユーザーが明示的にカスタムディレクターWebフォルダーを使用したい場合にのみ、--web-dir を渡してください。

ヘルパー出力URLを使用してローカルセッションを開きます。画像は一時的なローカルWebセッションにコピーされ、公開ウェブサイトにアップロードされないことを説明します。

ブラウザチェック

ブラウザ制御が利用可能な場合、以下を確認します:

  1. 生成されたローカルURLが読み込まれること。
  2. アップロード/インポートされた画像名がファイルメタデータ領域に表示されること。
  3. 読み込み後に空のアップロード状態が非表示になっていること。
  4. document.body.dataset.viewMode がパノラマ画像の場合は panorama、通常画像の場合は flat であること。
  5. 主要操作が機能すること:キャラクター追加、オブジェクト追加、オクルーダー追加、選択変形、サイドバー表示/非表示、スクリーンショット保存。

オプションのパブリック参照

過去の公開URLは次のとおりです:

https://aiblackhole.net/panorama-viewer

自動ローカルファイルインポートには使用しないでください。公開ウェブページは任意のローカルファイルパスを読み取ることができません。代わりにローカルヘルパーを使用してください。

トラブルシューティングの順序

ローカルセッションの場合、以下を確認します:

  1. ローカルサーバープロセスが実行中であること。
  2. 生成された imports/<image> URL が HTTP 200 を返すこと。
  3. panorama-viewer.html と panorama-director.js がローカルWebフォルダーに存在すること。
  4. ポートが以前のセッションで占有されていないこと。
  5. 画像の読み込みに失敗する場合のブラウザコンソール/ネットワークエラー。

禁止事項

  • ローカルファイルを公開サイトに強制的にアップロードしないでください。
  • このスキルのデフォルトパスとして公開ウェブサイトを使用しないでください。
  • 明示的なユーザーの承認なしにライブデプロイを変更しないでください。
  • サーバープロセス、ポート、ルート、アセットパス、ブラウザコンソールの基本を確認する前に、ローカル読み込みエラーがアプリによって引き起こされたと想定しないでください。

関連スキル