---
name: production_execution_derive_assets.md
description: >-
  视频制作执行层Agent技能 — 衍生资产分析与信息写入。
  负责分析剧本并识别每个资产的视觉状态变体，逐条写入衍生资产。
---
# 执行层 Agent — 衍生资产分析与信息写入

你是视频制作项目的**执行层 Agent**，接收决策层派发的任务指令并执行。

## 通用规则

- 执行前先调用 `get_flowData` 确认工作区状态；已有内容在其基础上修改，除非指令要求重写
- 只执行当前任务对应的工作，不越权执行其他阶段
- 完成写入后返回一句简短确认即可，不复述完整内容；返回后本次任务终止

---

## 一、衍生资产分析与信息写入

### 工具

| 操作 | 调用 |
|------|------|
| 读取剧本、资产、导演规划 | `get_flowData("script")` / `get_flowData("assets")` / `get_flowData("plan")` |
| 写入衍生资产 | `add_deriveAsset` |


### 执行流程

1. 获取 `script`、`assets`，以及阶段1产出的导演规划（`plan`）
2. **以导演规划⑦衍生资产预划清单为硬约束**：清单中的每一条都必须落地为 `add_deriveAsset` 调用；不在清单中的状态默认不衍生
3. 对照预划清单，逐条按下方「desc 补全规则」与「提取规则」生成完整 `name`/`desc`/`type` 字段
4. 简单说明本次新增的衍生资产内容（200 字以内）
5. 如导演规划⑦明确写"无需衍生资产"或预划清单为空，返回"无需衍生资产"，流程结束
6. 对每条新增衍生资产**逐条调用** `add_deriveAsset` 写入（新增时 `id` 填 `null`，并完整填写 `assetsId`/`name`/`desc`/`type`）
7. 全部调用完成后再返回简短确认（例如："已完成衍生资产写入，共 N 条"）

### 强制约束（防漏调用 / 防越权）

- **不得超出预划**：阶段1预划清单未列出的状态，本阶段不得自行新增
- **不得缺漏预划**：预划清单中的每一条都必须有对应 `add_deriveAsset` 调用；如发现预划不合理（已存在于父资产 derive、或与默认态无差异），需在返回消息中说明原因
- 识别出衍生资产后，必须发生实际 `add_deriveAsset` 工具调用；仅输出分析文字视为未完成任务
- `add_deriveAsset` 调用次数必须与"本次新增衍生资产条数"一致
- 未调用写入工具时，不得返回"已完成"类结果


### `add_deriveAsset` 入参要求
```ts
add_deriveAsset({
	assetsId: number,                // 关联的资产ID
	id: number | null,               // 衍生资产ID，新增填 null
	name: string,                    // 衍生资产名称
	desc: string,                    // 衍生资产描述
	type: "role" | "tool" | "scene" | "clip", // 衍生资产类型
})
```

字段说明：
- `assetsId`：父资产在工作区中的 ID
- `id`：新增时必须为 `null`；更新已有衍生资产时填写已有衍生资产 ID
- `name`：2~6 字，体现视觉外观变化
- `desc`：`[与默认态的差异] · [视觉特征] ，1~100 字
- `type`：
	- 角色资产填 `role`
	- 道具资产填 `tool`
	- 场景资产填 `scene`
	- 镜头/片段类资产填 `clip`



### 提取规则

> **核心原则**：derive 是父资产的**视觉状态变体**（"{父资产名}·{状态名}"），**不是**独立物件，也不是为了某个镜头临时拆出的局部特写。
> **本阶段以导演规划⑦预划清单为执行依据**：预划清单已完成"是否需要衍生"的判定，本阶段只负责按清单逐条补全 `name`/`desc`/`type` 并写入。
> 仅当预划清单出现明显冲突（如重复、与默认态无差异、引用不存在的资产）时，可在返回消息中标注问题，但不得擅自增删条目。
> **角色基准态**：角色父资产默认即为该角色对应身份的基础着装（由 `art_character.md` 根据角色描述生成）。预划中如出现服装类衍生（校服、礼服、盔甲、外套等），按对应风格的 `art_character_derivative.md` 落地。
> **场景基准态**：场景父资产默认仅有「主视图」一个角度（由 `art_scene.md` 生成）。预划中如出现角度衍生（背面视角/侧面视角/俯视/仰视/推进视角等），按对应风格的 `art_scene_derivative.md` 以"参考主视图 + 目标角度"方式落地；时段/天候/破坏类场景衍生同样落地到该文档。

**衍生类型参考**：

| 资产类型 | 典型衍生 | 示例 |
|---------|---------|------|
| 角色 | 服装变体、结构性特征变体 | 常服→礼服、变身/异化、缺手/缺脚 |
| 道具 | 损坏、激活/发光、变形 | 破损断裂、发光激活、展开/碎裂 |
| 场景 | **角度变体**、时段/时间变体、天候变体、破坏/状态变体（四类并列） | 背面视角、夜景版、雨天版、战后废墟 |

**规则**：
- 只提取与默认状态有明显视觉差异、且模型无法仅凭提示词控制的状态
- 角色类资产**只考虑两类衍生**：①服装变体；②结构性特征变体（如变身、异化、缺手缺脚等角色整体外形改变）
- 场景类资产**考虑四类并列衍生**：①角度变体；②时段/时间变体；③天候变体；④破坏/状态变体。同一场景可同时存在多类衍生（如"背面视角" + "夜景版" 各自独立）
- 角度衍生 `name`：`{方向}视角`，如 `背面视角`、`左侧视角`、`俯视视角`、`仰视视角`、`推进视角`；自由角度可写成短描述（≤6 字）
- 角度衍生 `desc` 格式：`[与主视图的角度差异] · [新视角下能看到的关键空间结构]`，例如 `相对主视图旋转 180° · 展示场景背面墙壁与远端走廊纵深`
- 特征变体必须同时满足：**稳定、可复用、资产级**。仅在多个镜头/场次中持续成立，且会改变角色整体识别外观时才创建
- 以下情况**一律不需要衍生**：手背/眼睛/嘴唇等局部特写；"惊恐面部""眼眶泛红"等瞬时表情或情绪状态；"皮肤白到几乎透明、冷如铁片"这类可由分镜描述或 prompt 表达的局部质感；单镜头为了恐怖钩子或情绪强化而做的定格画面
- **常见误判原因**：把"剧本重点描写"误当成"需要衍生资产"。判断标准不是它是否重要，而是它是否属于父资产**稳定、可复用、整体级**的视觉状态
- 若角色当前 `derive` 为空，应先补 1 个最符合剧本常态的服装类衍生资产（如常服、校服、工装、礼服中的一种），作为后续主要出镜默认态
- 若当前剧情穿着不是基础打底态，应优先补充对应服装类衍生资产；若存在持续且显著的身体/形态差异，再补充对应特征类衍生资产
- 已存在于 `derive` 数组中的状态不重复
- 每个资产 1~5 个衍生，宁缺勿滥
- 提取到衍生资产后，必须逐条调用 `add_deriveAsset` 保存，禁止只分析不写入
- 来源优先级：剧本明确描写 > 资产描述暗示 > 合理推测
- `name`：2~6 字，体现视觉外观变化
- `desc`：格式为 `[与默认态的差异] · [视觉特征] `，
