holo-card-studio

Holo Card Studio

完成済みのコレクターズカードプロジェクトを作成します。このスキルには、共通のアートディレクションと納品基準に基づく2つの制作ルートがあります。

まずルートを選択

アセットを準備する前に、必ずどちらか1つのルートを選んでください。

• ホログラフィック箔は、キャラクターアートワーク1点に使うデフォルトのルートです。subject、background、lineart、textの各プレーンを分け、箔とスパークルのエフェクトを加えます。
• 2画像レンチキュラーは、光栅、翻转、双图、双形态、または一念神魔向けのルートです。AとB、2つの完成したカードアートワークを使い、見る角度に応じてカード全体が変化します。1枚の画像を左右に分割したり、SVGで2つの状態を偽装したりしないでください。

ユーザーが一念神魔を指定した場合は、自動的にレンチキュラールートを選択します。

デフォルトのアートディレクション

アートを生成する前に、references/art-direction.mdを読んでください。ユーザーから別のスタイルが指定されない限り、生成するカードはすべて、色彩豊かな日本の浮世絵構図に、彩色された墨絵風のアニメ線画を組み合わせます。太さに変化をつけた表情豊かな墨の輪郭線、鉱物顔料、目に見える筆の質感、躍動感のある動き、統一感のある描画環境を使用します。

2状態のカードでは、まずAを生成し、画像生成ツールでAを編集してBを作成します。編集プロンプトでは、同一性と構図の不変条件を繰り返し指定してください。同じ顔立ち、髪や毛皮、衣装の特徴、プロポーション、カメラ、トリミング、体のスケール、主要なシルエットを維持します。表情は状態を明確に伝える必要があります。慈悲深い状態は穏やかで、思いやりがあり、揺るぎない表情にします。邪悪な状態は、同一性を変えずに、鋭く獲物を狙う目、吊り上がった眉、抑制された野性的または残酷な表情にします。

箔とダイヤモンドスパークルは演出レイヤーであり、アートワークの代わりにはなりません。foilとparticlesはデフォルトで1.0にし、顔を見やすく保ち、墨の輪郭線を損なわないようにしてください。

画像を生成する

ラスターアートワークには、組み込みの画像生成ツールを使用してください。画像を他の場所で生成するようユーザーに依頼しないでください。完成したイラストが求められている場合、SVGや手続き型の代替物は使用しないでください。

参照画像なしで生成する場合：

1. キャラクターの概要から、デフォルトのスタイルでAの完成アートワークを生成します。
2. Aを編集してBを生成します。同一性、フレーミング、主要な形状を固定し、表情、状態に応じた衣装の細部、ライティング、雰囲気、アクションエフェクトを変更します。
3. 両方を、同じ寸法の縦長PNGファイルとして保存します。

参照画像を使って生成する場合、参照画像を同一性の基準として扱い、Aを直接的なアレンジとして作成します。その後、Aを編集してBを作成します。必須のプロンプト構成と位置合わせチェックについては、references/lenticular-route.mdを読んでください。

プロジェクトをビルドする

このスキルの外部に、ユーザー所有のプロジェクトディレクトリを作成します。対応するサンプル設定をコピーし、アセットを準備してください。

ホログラフィックアセット：

assets/subject.png
assets/background.png
assets/lineart.png
assets/text.png
card-config.json

レンチキュラーアセット：

assets/image_a.png
assets/image_b.png
assets/text.png
card-config.json

共通ディスパッチャーを実行します。

python scripts/run_pipeline.py --project <project-dir> --mode holographic
python scripts/run_pipeline.py --project <project-dir> --mode lenticular

card-config.jsonに"mode"が含まれていれば、--modeは省略できます。デフォルトはholographicです。

レンチキュラープロジェクトでは、正規化または位置合わせレポートが必要な場合、パイプラインの実行前にscripts/lenticular/prepare_pair.pyを実行してください。パイプラインは、text.pngが存在しない場合はタイポグラフィを作成し、アセットを検証して、card.blendをビルドし、プレビューをレンダリングし、web/assets/card.glbを書き出します。また、対応するWebビューアーをコピーし、--skip-npmが指定されていない場合はローカルのWeb依存関係をインストールします。

検証と納品

references/verification.md を読んでください。少なくとも以下を検証してください。

• Blender シーンに物理的なカードの厚みと複数のエフェクトプレーンが含まれていること。
• A と B がイラストの表面全体を置き換え、1 人のキャラクターとして認識できる状態を保っていること。
• 正面と斜めからのレンダリングで、読み取り可能な状態変化が示されていること。
• ホイル、グリッター、ラインの発光、レンチキュラーの隆起が、顔を白飛びさせることなく視認できること。
• 白い Web ビューアが GLB を読み込み、横方向にはみ出すことなくポインター/タッチによる傾き操作に対応していること。

ソース画像、card.blend、レンダリング、Web ビューア、検証レポートを納品してください。生成されたバイナリはプロジェクト内に保持し、再利用可能なスキルアーカイブの中には決して入れないでください。

リファレンス

• references/art-direction.md: 共有のデフォルトスタイルとプロンプトレシピ。
• references/holographic-route.md: 多層ホイルカードのワークフロー。
• references/lenticular-route.md: 全画像 A/B ワークフローと同一性ロック。
• references/config.holographic.example.json: 単一アートの設定。
• references/config.lenticular.example.json: 二状態の設定。
• references/lenticular-model.md: 視野角モデル。
• references/verification.md: レンダリングとブラウザーの受け入れチェック。