Asset Passport 用于在影视生成前,为单个影视资产建立一份权威的视觉护照。护照被视为资产的记忆,其描述符和已批准的参考图会被原样复制到后续提示词中,以保证视觉身份可重复。
使用前需先阅读项目 CLAUDE.md 或 AGENTS.md 中的 ## AI film studio 部分;若缺失,应提示用户先运行 setup。随后确认用户使用的图像模型及提交提示词的方式,并检查工作室根目录下 /assets/characters/、/assets/locations/、/assets/props/、/docs/registry.md 和 /docs/breakdown.md 是否存在,缺失时仅创建所需文件夹。
每次只处理一个角色、场景、道具或状态变体,并逐一提问。需确认资产的 tag(以 @ 开头)、类型、版本、出现场景及已选种子或参考文件;可读取 /docs/breakdown.md 核对场景 ID 与资产 tag,不得静默合并或更改已有 tag。每个状态变体视为独立资产,拥有自己的护照和注册表行,例如 @cal、@cal_wet、@cal_blood 需分开。
描述符需通过访谈补全,覆盖另一提示词作者无需猜测即可复现的稳定视觉事实,并区分永久身份与场景特定动作、构图或镜头选择。角色需明确面部、发型、年龄线索、体型、肤色、服装、鞋履、携带物、磨损及特征细节;道具需明确形态、比例、材质、颜色、表面处理、磨损、标记、活动部件及特征细节;场景需明确布局、表面、建筑、固定物体、比例、风化及空间地标,并包含主色、辅色、点缀色、光线特征和内置调色,颜色决策可取自 /docs/bible.md,未定则询问用户而非编造。
需撰写一份完整散文式规范描述符,不得为简洁而省略细节,在通过压力测试前标记为 draft。参考图提示词要求同一资产在中性灰背景下的正面、四分之三、侧面、背面及特写视图,并原样粘贴规范描述符,排除无关场景、布景、叙事动作和戏剧化调度;状态变体需包含完整不变身份及变体的确切可见变化。生成的参考图与护照保存在对应 /assets/<type>/ 文件夹下,使用带版本的文件名并记录确切路径。
护照文件为带版本的 Markdown,结构包含标题、状态、类型、场景、种子文件、规范描述符、参考图提示词和参考文件。注册表 /docs/registry.md 需按精确 tag 和版本查找行,保留 tag · type · version · seed file · scenes · status 列,追加或更新该草稿行,状态设为 draft,不得标记为 locked,只有压力测试可锁定。完成后报告护照路径、注册表行、未解决字段和下一步,并提示用户生成或附加参考图、批准参考图,并在影视生成前运行压力测试。