git:20260820.a79710d to git:20260823.3d73368

- description: 为已确认的短剧角色、造型、场景、视角、道具和状态编写或修改可复制的通用资产图片提示词，并把已接受视觉方向投影成 Look Development 人物、地点或高压力风格帧。用户提到角色设定图、三视图、人物参考图、场景设定图、场景空镜、场景板、道具图、风格帧、Look Development、造型或状态变体、局部编辑提示词，或要求用自然语言修改现有图片提示词时直接使用；只产出结构化规格与 Markdown 文本，不生成图片，也不调用模型或供应商接口。

- 把已接受的资产事实写成“能认出、能复用、能区分状态”的参考图提示词。这里的产物是提示词，不是图片。

-

- 预览、警告与修订说明是创作者读的：项目内跟随 `short-drama.json#/language`，独立运行时

- 跟随用户使用的语言。送给图片生成器的**通用提示词正文**在项目内跟随

- `#/format/prompt_language`，独立运行时由用户指定、未指定则为 `en`。

- 改了描述语言不等于

- 改了画面里的可读文字——那由已接受的文字政策决定。

-

- ## 开始前

-

- 本技能可独立安装和执行。先读取用户明确提供的资产事实、视觉方向与本任务直接输入；若当前

- 目录是 `short-drama` 项目且项目工具可用，可以读取 `status` 并使用其发布生命周期，但缺少

- core 或任何其他技能都不是提示词工作的阻断条件。[阶段契约](references/stage-contract.md)

- 给出本阶段边界、制作形态输入与规则表，无需读取其他技能的文件。

- 从本技能的最小原生 JSONL 样例开始，写完当前有界资产集合后运行：

-

- python3 {技能目录}/scripts/image_prompt_check.py examples/minimal-image-prompt-specs.jsonl

- python3 {技能目录}/scripts/selftest.py

- 校验器检查准确绑定、稳定 reference slot/order、局部编辑必填项、文字政策冲突和 provider 字段

- 泄漏；构图、身份表现和画面质量仍属于内容审查。输入路径不存在于当前目录时，会相对本技能目录解析。

-

- ## 进入条件与边界

-

- - 可从现成项目或创作者直接提供的资产记录进入，不要求先做故事开发或安装主技能。

- - 所有权或直接输入影响不清楚时，读

- [阶段契约](references/stage-contract.md) 的所有权边界；需要定位规则 ID

- 或解释审查问题时，读同一文件的本阶段规则表。

- - 输入必须是已接受的 `CHAR/LOOK`、`LOC/VIEW` 或 `PROP/PSTATE` 精确 ID 与快照引用。未决指代、冲突变体或未知状态退回 `$short-drama-assets`，不代猜。

- - 项目存在时读取 `short-drama.json#/creator_authority/{visual_direction,production_profile}`

- 中状态为 `accepted` 的视觉方向与制作形态；独立运行时使用创作者直接提供的等价约束，未提供

- 就保持 `unset`。它决定本阶段可执行的形状语言、线条/表面处理、材质对光的

- 响应与层拆；若状态为 `unset`，就向创作者给出选择，不从对话记忆补造，也不用默认审美冒充

- 已接受形态。形态只决定可执行词汇，不决定身份、地理、持物、可读文字政策与故事状态。

- - 若创作者明确要求全链预览，可对唯一且没有 `unresolved` 问题的资产提案写候选提示词；

- 文档标明待确认，不得声称创作者已经接受。

- - 本技能只负责构图、提示词专用约束，以及局部修改中的修改项 `changes` 和保留项 `preserve`；身份、地理和资产状态仍由资产技能负责。

- - 始终保留不绑定供应商的通用提示词。不得创建图片、媒体任务、接口请求、模型参数、轮询记录或画质结论。

-

- ## 按任务加载资料

-

- | 任务 | 必读资料 |

- |---|---|

- | 新建任意资产提示词 | [通用配方与视觉锚点](references/common-recipe.md) |

- | Look Development / 人物、地点、高压力风格帧 | [Lookdev 风格帧](references/lookdev-frame.md) |

- | 人物设定图 | 加读 [人物与造型](references/character-and-look.md) |

- | 造型、视角或道具状态的版本 | 加读 [造型与状态变体](references/look-and-state-variant.md) |

- | 场景空镜或不同观察方向 | 加读 [场景与地理](references/location-plate.md) |

- | 道具或 道具状态 | 加读 [道具、尺度与文字](references/prop-plate.md) |

- | 局部修改或自然语言改提示词 | 加读 [编辑与修订](references/edit-and-revision.md) |

- | 自检、复核、失败诊断 | [审查量表与合成案例](references/review-and-fixtures.md) |

- | 生产端三视图/场景方位/物品版式配方 | [生产资产图配方](references/production-sheet-recipes.md) |

- | 参考图只决定身份、构图或尺度等指定内容 | [阶段契约](references/stage-contract.md) 的参考媒体与补拍 |

-

- 普通资产规格使用 [结构化规格模板](assets/image-prompt-spec.jsonl.md)；Look Development 改用

- [独立风格帧模板](assets/lookdev-frame-spec.jsonl.md) 与

- [风格帧 Markdown 模板](assets/lookdev-prompts.md)，不先加载普通资产超集再删字段。普通资产交付文本

- 使用 [Markdown 模板](assets/image-prompts.md)。只加载当前类型所需资料。

-

- ## 每轮的工作单元

-

- 一轮处理一组明确的资产 ID。“给所有资产写提示词”拆成若干个具名集合，每轮：

- 1. 只读这组资产的直接输入，写它们的提示词规格，跑本地结构检查；

- 2. 落盘这一组，其余资产保持原样；

- 3. 报告已覆盖范围、剩余范围、未决绑定和下一组值得做的资产；

- 4. 交还控制权，等创作者的下一次请求。

- 实际生成、下游阶段和审查各自是独立的工作单元，由创作者明确请求时开始。

- ### 1. 确认目的而非先堆风格词

-

- 先回答：这张参考图以后要帮助谁保持什么一致？选择一种主类型：

-

- - `character_sheet`：识别同一人物的一套已接受造型；

- - `location_plate`：固定一个地点的观察方向和地理；

- - `prop_plate`：固定道具的尺度、形制、功能和当前状态；

- - `look_state_variant`：在同一身份上突出有因果与有效范围的差异；

- - `edit_delta`：对精确目标做有边界的修改，同时声明保留集。

- - `lookdev_frame`：把已接受视觉方向投影成人物表现、核心地点或高压力场景的代表性文本规格。

-

- 一个规格只承担一个主要复用目的。需要不同造型、观察方向、状态或 lookdev 测试轴时分开写，

- 不把互相冲突的状态揉成“大全图”。风格帧不获得角色身份、场景地理或剧情状态的权威。

-

- ### 2. 整理输入

-

- 从接受快照记录：

-

- 1. 准确的资产 ID 与版本 ID；

- 2. 稳定识别点与本版本的变化；

- 3. 来源引用：文件头 `sources` 里的快照键 `src`、`record_id` 与 `field`；

- 4. 用途、构图、背景、光线与文字政策；

- 5. 每张参考图的准确引用、单一作用、可参考内容、不可照搬内容与检查状态；只有

- 创作者/参考图权利人的说明，或经过授权的输入参考图检查，才能给出像素/文字结论；

- 前者写 `creator_described`，后者写 `visually_inspected`，都没有时保持 `unverified` 并列出风险；

- 多参考还要保留稳定 `slot_id` 与显式 `order`，不能让数组重排改变用途；

- 6. 必须出现、必须保持和明确排除的内容；

- 7. 未决定项以及创作者的明确选择。

-

- 只带入当前操作必需的信息。私有引用在文本中仅写 `REF-*`，不泄露本地路径、网址或原始内容。

-

- ### 3. 按重要性写规格与通用提示词

-

- 按“用途/主体 → 识别点 → 状态差异 → 构图/方向/尺度/空间关系 → 材质/色彩/光线 → 背景 → 文字政策 → 排除/保留”组织。身份、地理、尺度和可读文字等重要事实先于“精致、电影感”等空泛审美词。

-

- - `structural_invariant`：绑定准确的已接受 ID/版本；局部修改写清 `target_ref` 与 `entity_or_region`、`changes`、`preserve` 和连续性影响；`readable` 不得与全局 `no-text` 并存。

- - `reviewed_invariant`：人物在一个规格中保持同一身份和一套连贯造型；场景保持清楚的地理；道具保持可辨尺度、形制与功能。

- - `reviewed_invariant`：参考图只决定已经声明的内容；构图、尺度或效果参考不得顺带改写身份、文字、人数或故事状态。

- - `craft_default`：用少量可观察、彼此不重复的识别点；负面约束只防止当前风险，不写长篇万能禁词。

- - `taste_option`：写实/绘制、镜头审美、色彩浓度、文风密度由创作者决定；一旦被写入

- `creator_authority` 并接受，它就不再是本阶段可自选的口味，而是必须投影的形态约束。

-

- ### 4. 做矛盾与可复用性审查

-

- 逐项检查：锚点是否互相打架；临时状态是否污染身份；空间关系是否能画在同一画面；构图是否服务参考用途；文字政策是否可执行；排除项是否误杀必需事实。语义质量用证据复核，不用词数、形容词数或固定提示词长度硬判。

-

- ### 5. 让创作者接受，再写正式产物

-

- 先展示人能读懂的预览：绑定对象、关键选择、警告与可复制提示词。接受后写：

-

- - `项目开发/lookdev-image-prompt-specs.jsonl` 与 `项目开发/lookdev-prompts.md`：仅项目级

- Look Development 使用，后者为派生文本；

- - `剧集/<EP>/assets/image-prompt-specs.jsonl`：权威规格，写入时 `status` 如实跟随对象当前

- 生命周期状态（预览为 `candidate`，已接受的落盘规格为 `accepted`）；

- - `剧集/<EP>/assets/image-prompts.md`：由已接受规格重新生成的文本版本，元信息写明用的是哪个渲染器。

-

- 项目工具可用时用 `publish` 发布规格和派生文本并声明直接输入；独立运行时直接写出本阶段文件。

- 两种方式都不得以半成品覆盖当前版本。

-

- `--input` 要把本文件 `sources` 里声明的每一个上游都列全——**少列一个，那个上游改了本产物也不会

- 变 `update_needed`，它会带着过期的绑定停在 `accepted`**。本阶段的完整清单是身份与变体两侧成对：

- ```text

- ... publish <project> --owner short-drama-image-prompts --artifact-id EP001:image-prompts \

- --output 剧集/EP001/assets/image-prompt-specs.jsonl=_work/image-prompt-specs.jsonl \

- --input 设定集/characters.jsonl --input 设定集/looks.jsonl \

- --input 设定集/locations.jsonl --input 设定集/location-views.jsonl \

- --input 设定集/props.jsonl --input 设定集/prop-states.jsonl

- ```

- ## 自然语言修订

- 用户可直接说“外套保持不变，只把袖口变湿”“场景里不要出现演员”。不要让用户编辑 JSONL。

- 1. 把请求整理成按字段列出的修改方案，并标记哪些事实由上游负责；

- 2. 展示 `before → after`、受影响的绑定和连续性，以及无法对应或会丢失的内容；

- 3. 等待接受或拒绝；拒绝时原规格与 Markdown 文本不变；

- 4. 接受后先提交规格，再从规格重新导出 Markdown 文本。

- 若 Markdown 文本被手改：`restore` 先预览恢复；`adopt` 只把能完整对应字段的改动变成

- 规格提案。无法对应的文句会阻断 `adopt`，绝不让派生文本反向成为事实来源。详见

- [编辑与修订](references/edit-and-revision.md)。

- ## 完成标准

- - 每个规格能追溯到准确的已接受资产与版本，且通用提示词可独立复制；

- - 类型配方完整，重要事实在泛化审美词之前，无未决占位或内部工作指令；

- - 局部修改同时说明改什么、保留什么、会影响哪些连续性；

- - 已运行当前批次的本地结构检查；需要内容 verdict 时作为单独请求交给 `$short-drama-review`；

- - 交付中没有媒体、远程执行任务或接口信息、远端 ID、私有对应表或“生成成功”声明。

- ## 投产交接

- 用户要求把已接受规格真正生成图片时，交给 `$short-drama-produce`。传递准确的 prompt/spec、

- 参考文件、数量、尺寸和目标路径；生产技能必须展示完整预览并取得本次任务的明确确认后才可

- 调用外部 adapter。本技能本身仍只负责规格和提示词。