# prop-asset｜道具身份与状态合同

| 状态 | 现行本地规则补丁已纳入v1.4.0；实图审查与用户接受另列。 |
|---|---|
| 单独可交付 | 道具参考任务与合同交代整体形制和有用途的结构局部；依据成立时才扩展交互或变化状态视图。 |
| 单独不能声称 | 不负责完整场面调度，也不能在真实参考图和镜头未审时证明持用正确。 |

[运行正文 `SKILL.md`](../../../skills/prop-asset/SKILL.md) · [v1.4.0 ZIP](https://github.com/62656456/ai-film-skills/releases/download/v1.4.0/prop-asset.zip) · [安装说明](../../INSTALLATION.md) · [兼容说明](../../COMPATIBILITY.md) · [设计总则](../../SKILL_DESIGN_SYSTEM.md)

v1.4.0固定发布快照。请核对归档清单与技能版本；实验状态保持。

<!-- contract:purpose -->
## 1. 设计目的

定义道具身份、尺度、材质、可用面、接口、持有人、朝向、磨损、操作和状态变化。

<!-- contract:principles -->
## 2. 设计理念

- 先建立可审核、可版本化的资产身份，再进入分镜或视频生产。
- 平台适配可以改变语法，但不能改变已批准的 `locked_features` 和状态历史。
- 静态资产合同把身份、允许状态变化、材质、几何、布光和下游引用分开。
- 联合推导注意力、主体分离、有来源光影、尺度与细节层次。单图不自动变多格；按设计保留新塑料和有依据的发光。
- 局部修订复用未变原文与相关上下文；资产编号留内部，未审参考限制正式生成，不阻断候选文字设计。
- 道具通过可用面、持有人、朝向、开合/损伤状态和物理接触追踪，不能只靠名称。

<!-- contract:standalone -->
## 3. 适合单独使用的范围

当点名结果落在以下边界内时，可以只拿这一个模块使用：

道具参考任务与合同交代整体形制和有用途的结构局部；依据成立时才扩展交互或变化状态视图。

**单独不能声称:** 不负责完整场面调度，也不能在真实参考图和镜头未审时证明持用正确。

<!-- contract:inputs -->
## 4. 输入

- 唯一资产编号、版本、用途、已知来源事实和仍未知字段。
- 所需视图、状态、尺度参照、目标平台和已批准参考图。
- 下游连续性所需的锁定特征、可变状态、朝向、持用关系或空间锚点。

<!-- contract:workflow -->
## 5. 流程逻辑

1. 先选择仅提示词、实际图或局部诊断交付，以及摄影写实、三维动画或二维插画成像，再使用模板。
2. 提取必填维度，缺失事实明确标记，不臆造。
3. 锁定身份、几何、材质、物理行为、布光和状态规则。
4. 选择必要视图或状态图，编译平台适配的生成任务。
5. 执行模块质检并生成机读资产合同。
6. 仅文本交付时像素检查保持not_evaluated；实际图失败才标rework，资产需明确人审才能批准。

<!-- contract:returns -->
## 6. 退回、重做与版本回滚

- 身份或状态缺失退回输入；几何、材质、布光或交互失败退回对应合同字段。
- 跨视图漂移退回锁定特征与主参考图，不能靠无关风格词修复。
- 审核失败保持 `rework`，结构完成不能自动晋级。

<!-- contract:review -->
## 7. 审核门

- [ ] 编号、版本、用途、必填维度、锁定特征和未知项明确。
- [ ] 比例、透视、几何、材质、接触、重量、阴影和关键面物理自洽。
- [ ] 无多余肢体、物件、文字、水印、漂移或抢主体的背景。
- [ ] A/B 面、尺寸、持有人、朝向、接口、开合状态、材质、磨损和状态变化无歧义。

<!-- contract:pass -->
## 8. 过关标准与状态

- 资产任务和 JSON 合同通过模块检查，且没有未解决阻塞字段。
- `assets_approved` 必须检查真实参考图；只有文本合同仍是待审状态。

> 下方“通过”只表示本模块规定的审核门已通过；结构有效、真实任务证据和用户接受必须分开记录。

<!-- contract:outputs -->
## 9. 输出

- 主参考图任务，以及确有必要的多视图或状态图任务。
- 供分镜、提示词和质检使用的版本化 JSON 资产合同。

<!-- contract:boundaries -->
## 10. 边界、依赖与权限

- 不臆造缺失事实、不覆盖批准特征，也不把视频动作和台词写进静态资产身份。
- 没有生图工具和视觉审核时，本模块交付生成任务与合同，不能声称完成参考图。
- 描述交互不新增图片任务；文字仍交文字，图片数量服从用户范围。

<!-- contract:agents -->
## 11. 跨 Agent 使用

- 标准包是完整 Skill 文件夹，不是只复制一段提示词。
- `agents/openai.yaml` 只是 Codex 的可选界面元数据，不是其他宿主的运行依赖。
- 任何能读取文件夹的宿主都可输出文本合同；真实参考图还需要生图工具、文件能力和人类视觉审核。
- Agent 能阅读指令不等于原生发现或原生执行；提示词回退不能写成原生兼容。

<!-- contract:sources -->
## 12. 原始文件与引用

**运行正文与元数据**

- [`agents/openai.yaml`](../../../skills/prop-asset/agents/openai.yaml)
- [`SKILL.md`](../../../skills/prop-asset/SKILL.md)

**引用资料**

- [`references/cinematic-image-direction.md`](../../../skills/prop-asset/references/cinematic-image-direction.md)
- [`references/NEGATIVE-CASE-BOOK.md`](../../../skills/prop-asset/references/NEGATIVE-CASE-BOOK.md)
- [`references/prop-design-and-reference.md`](../../../skills/prop-asset/references/prop-design-and-reference.md)

**新构建 ZIP 的分发许可文件**

新构建会将下列文件附在 ZIP 内的 Skill 目录，不修改运行源码；既有历史 Release 附件不变。

- [`LICENSE`](../../../LICENSE)