关于 asset-passport
asset-passport 是一项创作技能，用于逐个为影片资产建立规范的视觉护照。它引导确认资产特征、编写参考图提示词、管理版本文件，并在压力测试前将资产登记为草稿。
主要功能
- 01为影片资产编写规范描述
- 02为不同状态变体分别建档
- 03生成五视图参考图提示词
- 04护照和参考文件版本管理
- 05在登记表中追踪草稿状态
适用场景
- 01记录角色的视觉身份
- 02整理场景布局和色彩方案
- 03追踪不同场景中的资产状态
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/asset-passport确认已加载。
详细介绍
资产设定档
每次为一个影视资产创建一份权威视觉设定档。 将设定档视为资产的记忆：其描述和已批准的参考图将原样复制到后续提示词中。
开始
- 阅读项目
CLAUDE.md或AGENTS.md中的## AI film studio部分。 - 仅将配置的图像模型用作参考图表提示词的目标；不要假定使用特定模型。
- 如果缺少该部分，请告知用户先运行设置。
- 如果用户希望继续，请询问他们使用哪种图像模型，以及如何提交提示词。
- 检查工作室根目录中是否存在
/assets/characters/、/assets/locations/、/assets/props/、/docs/registry.md和/docs/breakdown.md。 - 如果缺少必需文件夹，提出仅在工作室目录树中创建所需文件夹。
- 询问要为哪个单独的角色、地点、道具或状态变体创建设定档。
整个过程中一次只问一个问题。
确定身份
确认资产的：
- 标签，以
@开头； - 类型：角色、地点或道具；
- 版本；
- 出现的场景；
- 已选用的种子或参考文件。
如有 /docs/breakdown.md，请阅读，并核对其中的场景 ID 和资产标签是否与用户的回答一致。
不要擅自合并两个标签或更改现有标签。
将每个状态变体视为独立资产，为其创建自己的设定档和登记表行。
例如，分别保留 @cal、@cal_wet 和 @cal_blood。
询问变体在视觉上有哪些变化，以及哪些特征必须与基础资产保持一致。
编写描述
持续访谈用户，直到视觉身份全面且明确无歧义。 每次只询问一个缺失维度。 涵盖其他提示词撰写者必须能够复现、无需猜测的稳定视觉事实。 将永久身份与场景专属的动作、构图或镜头选择区分开来。
对于角色，明确面部、头发、年龄特征、体型、肤色、服装、鞋类、随身物品、磨损情况和独特细节。 对于道具，明确形状、尺寸、材质、颜色、表面处理、磨损情况、标记、活动部件和独特细节。 对于地点，明确布局、表面、建筑、固定物件、规模、风化情况和空间地标。
对于地点，还应包括场景的：
- 主色、次要颜色和点缀色；
- 光线特征；
- 固定调色。
如果存在 /docs/bible.md，请从中提取颜色设定。
如果尚未确定，请询问用户，不要自行编造。
用完整的文字撰写一份规范描述。
不要提供简略版本，也不要为求简短而省略细节。
在资产通过压力测试之前，将描述标记为 draft。
编写参考图表提示词
为用户配置的图像模型编写提示词。 要求模型在中性灰色背景上展示同一资产的以下视图：
- 正面；
- 四分之三视角；
- 侧面；
- 背面；
- 肖像特写或细节特写。
将规范描述逐字粘贴到提示词中。
参考图表中不要加入无关地点、布景陈设、叙事动作或戏剧性调度。
对于状态变体，请包含完整的固定身份信息，以及该变体确切的可见变化。
将生成的每张参考图表与其设定档一起保存到匹配的 /assets/<type>/ 文件夹中。
为每张图表指定带版本号的文件名，并在设定档中记录其确切路径。
创建设定档文件
选择匹配的文件夹：
- 角色：
/assets/characters/； - 地点：
/assets/locations/； - 道具：
/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；只有 stress-test 可以执行此操作。
完成
报告护照路径、注册表行、尚未解决的字段和下一步操作。 告知用户在素材文件夹中生成或附上参考图表、批准参考内容，并在将素材用于影片生成前运行 stress-test。