asset-passport

アセットパスポート

一度に1つのフィルムアセットについて、唯一の正式なビジュアルパスポートを作成します。 パスポートはアセットの記憶として扱います。記述と承認済みのリファレンスは、後続のプロンプトにそのままコピーされます。

開始

1. プロジェクトの CLAUDE.md または AGENTS.md にある ## AI film studio セクションを読みます。
2. 設定済みの画像モデルはリファレンスシート用プロンプトの送信先としてのみ使用します。特定のモデルを前提にしないでください。
3. セクションがない場合は、最初にセットアップを実行するようユーザーに伝えます。
4. 続行を希望する場合は、使用している画像モデルとプロンプトの送信方法を尋ねてから進めます。
5. スタジオのルートに /assets/characters/、/assets/locations/、/assets/props/、/docs/registry.md、/docs/breakdown.md があるか確認します。
6. 必要なフォルダーがない場合は、スタジオのツリー内に必要なフォルダーだけを作成することを提案します。
7. パスポートを作成するキャラクター、ロケーション、プロップ、または状態バリアントを1つだけ尋ねます。

最初から最後まで、一度に1つだけ質問してください。

アイデンティティの確定

アセットについて、以下を確認します。

• @ で始まるタグ
• 種別：キャラクター、ロケーション、またはプロップ
• バージョン
• 登場するシーン
• すでに選定されているシードまたはリファレンスファイル

/docs/breakdown.md がある場合は読み、シーン ID とアセットタグをユーザーの回答と照合します。 2つのタグを黙って統合したり、既存のタグを変更したりしないでください。

状態バリアントはそれぞれ、専用のパスポートとレジストリー行を持つ別個のアセットとして扱います。 たとえば、@cal、@cal_wet、@cal_blood は別々に管理します。 バリアントで目に見えて変化する点と、ベースアセットと同一のままにする点を尋ねます。

記述の作成

ビジュアルアイデンティティが網羅的かつ曖昧さのないものになるまで、ユーザーに聞き取りを行います。 不足している要素は、一度に1つずつ尋ねます。 別のプロンプト作成者が推測せずに再現できる、安定したビジュアル上の事実を網羅します。 恒常的なアイデンティティと、シーン固有の動作、フレーミング、カメラ設定は分けて記述します。

キャラクターの場合は、顔、髪、年齢を示す特徴、体格、肌、衣装、履物、携行品、使用感、特徴的な細部を明確にします。 プロップの場合は、形状、スケール、素材、色、仕上げ、使用感、マーキング、可動部、特徴的な細部を明確にします。 ロケーションの場合は、レイアウト、表面、建築、固定物、スケール、風化の程度、空間上の目印を明確にします。

ロケーションについては、シーンの以下の要素も含めます。

• 支配色、副次色、アクセントカラー
• 光の特性
• 組み込みのカラーグレーディング

色の設定は、/docs/bible.md があればそこから取得します。 未決定の場合は、独自に決めずにユーザーに尋ねます。

完全な文章で、標準となる記述を1つ作成します。 短縮版を作成したり、簡潔さのために詳細を省略したりしないでください。 アセットがストレステストを通過するまでは、記述に draft と表示します。

リファレンスシート用プロンプトの作成

ユーザーが設定した画像モデル用のプロンプトを作成します。 ニュートラルなグレーの背景で、同じアセットの以下のビューを表示するよう指示します。

1. 正面
2. 斜め前
3. 横顔
4. 背面
5. クローズアップのポートレートまたはディテール

標準となる記述を、プロンプトに一字一句そのまま貼り付けます。 無関係なロケーション、セットの装飾、物語上の動作、ドラマチックな演出はシートに含めないでください。 状態バリアントの場合は、変わらないアイデンティティ全体と、バリアントの正確な視覚的変化を含めます。 生成したリファレンスシートは、対応する /assets/<type>/ フォルダー内のパスポートと同じ場所に保存します。 各シートにはバージョン付きのファイル名を付け、その正確なパスをパスポートに記録します。

パスポートファイルの作成

該当するフォルダーを選びます。

• characters：/assets/characters/
• locations：/assets/locations/
• props：/assets/props/

プロジェクトで既に使われている命名パターンに従って、バージョン付きの Markdown ファイルを作成します。 パターンがない場合は、<tag-without-@>-v<version>.md を使用します。 リファレンスファイルの名前は変更しないでください。新しいバージョンには新しいファイルを作成します。

以下の構造を使用します。

# <tag> — version <version>
Status: draft
Type: <type>
Scenes: <scene IDs>
Seed files: <paths or pending>

## Canonical descriptor
<exhaustive descriptor>

## Reference-sheet prompt
<prompt containing the descriptor verbatim>

## Reference files
<versioned paths or pending>

レジストリを更新する

/docs/registry.md を開き、タグとバージョンが完全に一致する行を探します。 tag · type · version · seed file · scenes · status の列を維持します。 該当する行がない場合は追加し、ある場合はその完全一致するドラフト行を更新します。 status を draft に設定します。 seed file には、プロジェクトの既存の規則に従って、パスポートまたはリファレンスシートのパスを設定します。 アセットを locked にしてはいけません。これにできるのはストレステストのみです。

完了

パスポートのパス、レジストリの行、未解決のフィールド、次のアクションを報告します。 ユーザーに、アセットフォルダーでリファレンスシートを生成または添付し、リファレンスを承認してから、アセットを映画生成に使用する前にストレステストを実行するよう伝えます。