@oh-story/dsh 0.1.3 → 0.1.4

package/lib/drama/skills/short-drama-image-prompts/SKILL.md

@@ -1,181 +1,67 @@
 ---
 name: short-drama-image-prompts
-description: 为已确认的短剧角色、造型、场景、视角、道具和状态编写或修改可复制的通用资产图片提示词，并把已接受视觉方向投影成 Look Development 人物、地点或高压力风格帧。用户提到角色设定图、三视图、人物参考图、场景设定图、场景空镜、场景板、道具图、风格帧、Look Development、造型或状态变体、局部编辑提示词，或要求用自然语言修改现有图片提示词时直接使用；只产出结构化规格与 Markdown 文本，不生成图片，也不调用模型或供应商接口。
+description: 为短剧人物、造型、地点、道具和状态编写或修改可直接复制的图片提示词 Markdown。用户提到角色设定图、三视图、参考图、场景板、道具图、风格帧、Look Development、状态变体或局部编辑提示词时使用；不生成图片，也不调用供应商。
 license: MIT
 ---
 
 # 短剧资产图片提示词
 
-把已接受的资产事实写成“能认出、能复用、能区分状态”的参考图提示词。这里的产物是提示词，不是图片。
-
-预览、警告与修订说明是创作者读的：项目内跟随 `short-drama.json#/language`，独立运行时
-跟随用户使用的语言。送给图片生成器的**通用提示词正文**在项目内跟随
-`#/format/prompt_language`，独立运行时由用户指定、未指定则为 `en`。
-改了描述语言不等于
-改了画面里的可读文字——那由已接受的文字政策决定。
-
-## 开始前
-
-本技能可独立安装和执行。先读取用户明确提供的资产事实、视觉方向与本任务直接输入；若当前
-目录是 `short-drama` 项目且项目工具可用，可以读取 `status` 并使用其发布生命周期，但缺少
-core 或任何其他技能都不是提示词工作的阻断条件。[阶段契约](references/stage-contract.md)
-给出本阶段边界、制作形态输入与规则表，无需读取其他技能的文件。
+把视觉事实写成可复用、可修改、可直接复制的角色板、场景板、道具板或状态图提示词，统一保存到
+`剧集/<EP>/图片提示词.md`。每项用 `IMG-...` 标题，正文放在 `### 可复制提示词` 引用块。
 
 ## Quick Start
 
-从本技能的最小原生 JSONL 样例开始，写完当前有界资产集合后运行：
-
 ```text
-python3 {技能目录}/scripts/image_prompt_check.py examples/minimal-image-prompt-specs.jsonl
-python3 {技能目录}/scripts/selftest.py
+用 $short-drama-image-prompts 为 EP001 已确定的人物、地点和道具写可直接复制的图片提示词
 ```
 
-校验器检查准确绑定、稳定 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. 未决定项以及创作者的明确选择。
+有当前视觉设定即可直接开始；剧本只在提示词需要确认剧情状态时读取。Look Development 是可选分支。
+先确认用途：身份板、造型/状态变体、地点板、道具板、组合 production sheet 或比较风格帧。
 
-只带入当前操作必需的信息。私有引用在文本中仅写 `REF-*`，不泄露本地路径、网址或原始内容。
+创作者可读说明跟随项目语言；可复制正文跟随 `short-drama.json#/format/prompt_language`。没有
+`short-drama.json` 时正文默认
+使用 `en`，并在同一任务中保持一致；不能从创作者说明语言推断提示词语言。
 
-### 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`**。本阶段的完整清单是身份与变体两侧成对：
+1. 锁定这一张图要固定的身份、状态、空间或比较变量。
+2. 只读所需资产事实、视觉方向、负面约束和已提供参考图。
+3. 按“主体与身份锚点 → 当前变体 → 构图/视角 → 光色/材质 → 背景边界 → 禁止项”写正文。
+4. 每张参考只控制身份、造型、地理、构图或风格中的明确部分。
+5. 检查身份与变体、文字政策、视角和光线是否冲突。
+6. 用户要全部资产就完成全部，资产组只是内部批次。
 
-```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
-```
+## 提示词要求
 
-## 自然语言修订
+- 开头先写对象和用途，不用风格词淹没身份。
+- 只包含当前图能同时满足的要求；多视图/状态对照写清版面关系。
+- 保留稳定识别锚点，变体只改允许变化的部分。
+- 避免无验证作用的质量词堆砌。
+- 可见文字、logo、水印、界面和字幕明确允许或禁止。
+- 正文可直接复制，不含占位符、流程说明、文件路径或 QA 结论。
 
-用户可直接说“外套保持不变，只把袖口变湿”“场景里不要出现演员”。不要让用户编辑 JSONL。
+## 按需知识
 
-1. 把请求整理成按字段列出的修改方案，并标记哪些事实由上游负责；
-2. 展示 `before → after`、受影响的绑定和连续性，以及无法对应或会丢失的内容；
-3. 等待接受或拒绝；拒绝时原规格与 Markdown 文本不变；
-4. 接受后先提交规格，再从规格重新导出 Markdown 文本。
+默认只读本 SKILL 和当前视觉设定。遇到对应问题时只打开一份：
 
-若 Markdown 文本被手改：`restore` 先预览恢复；`adopt` 只把能完整对应字段的改动变成
-规格提案。无法对应的文句会阻断 `adopt`，绝不让派生文本反向成为事实来源。详见
-[编辑与修订](references/edit-and-revision.md)。
+- 阶段边界与规则分级：[阶段契约](references/stage-contract.md)
+- 普通单图的最小配方：[通用配方](references/common-recipe.md)
+- 人物身份板与造型一致性：[人物与造型](references/character-and-look.md)
+- 地点地理、视角和光线：[地点板](references/location-plate.md)
+- 功能道具、尺度、材质与文字：[道具板](references/prop-plate.md)
+- 造型和状态变体：[造型与状态变体](references/look-and-state-variant.md)
+- 多对象组合板：[Production Sheet 配方](references/production-sheet-recipes.md)
+- 比较视觉方向的代表帧：[Lookdev 风格帧](references/lookdev-frame.md)
+- 局部修改和 preserve set：[定点修改](references/edit-and-revision.md)
+- 完成前的可生成性检查：[审查与示例](references/review-and-fixtures.md)
 
-## 完成标准
+## 完成与投产
 
-- 每个规格能追溯到准确的已接受资产与版本，且通用提示词可独立复制；
-- 类型配方完整，重要事实在泛化审美词之前，无未决占位或内部工作指令；
-- 局部修改同时说明改什么、保留什么、会影响哪些连续性；
-- 已运行当前批次的本地结构检查；需要内容 verdict 时作为单独请求交给 `$short-drama-review`；
-- 交付中没有媒体、远程执行任务或接口信息、远端 ID、私有对应表或“生成成功”声明。
+每个点名对象都有明确用途、可复制正文、参考边界和禁止项，且相互不矛盾，即完成。实际生成必须
+转 `$short-drama-produce`，展示精确任务并取得显式确认；本技能不调用外部服务。
 
-## 投产交接
+## 安装维护
 
-用户要求把已接受规格真正生成图片时，交给 `$short-drama-produce`。传递准确的 prompt/spec、
-参考文件、数量、尺寸和目标路径；生产技能必须展示完整预览并取得本次任务的明确确认后才可
-调用外部 adapter。本技能本身仍只负责规格和提示词。
+只有安装、升级或排障时运行 `python3 scripts/selftest.py`。

package/lib/drama/skills/short-drama-image-prompts/references/character-and-look.md

@@ -96,20 +96,19 @@ Variant prompt 不是完整身份重写。先复用 Character anchors，再突
 
 | 问题 | 分类 | 证据 |
 |---|---|---|
-| exact Character/Look 是否解析 | `structural_invariant` | 规格引用与接受快照 |
+| exact Character/Look 是否解析 | `structural_invariant` | `视觉设定.md` 的可见 ID 与当前变体 |
 | 是否只有一个连贯 Look | `reviewed_invariant` | Look 字段与 prompt 对应句 |
 | 是否保持区别性身份 | `reviewed_invariant` | Character anchors 与画面描述 |
 | 泛化美词是否挤压锚点 | `craft_default` | 指出可删词与缺失的可见事实 |
 | 中性姿态/背景是否适合 | `craft_default` | 用途与构图的关系 |
 | 表情强度、板式数量 | `taste_option` | 创作者/视觉方向 |
 
-最终必须产生一个结构化 spec 和一段无需资产库暗知识也能复制理解的通用 prompt；不产生图片。
+最终在 `图片提示词.md` 产生一个 `IMG-...` 人物板条目和一段无需资产库暗知识也能复制理解的正文；
+不产生图片。
 
 ## 6. 制作形态投影与模板槽位
 
-已接受的 `short-drama.json#/creator_authority/{visual_direction,production_profile}` 决定这张
-人物板用什么词汇画，不决定画的是谁。形态词表见
-本阶段需要从制作形态取得哪些输入，见 [阶段契约](stage-contract.md) 的“制作形态需要什么”。
+`视觉设定.md` 的项目视觉方向与已明确制作形态决定这张人物板用什么词汇画，不决定画的是谁。
 
 ### 从形态取什么
 
@@ -129,26 +128,26 @@ Variant prompt 不是完整身份重写。先复用 Character anchors，再突
 - 故事状态：伤势、湿污、包扎的因果与生效时间。
 
 形态改变的是**同一锚点走哪条表达通道**，不是锚点集合。若形态以剪影为主要识别通道，就要
-为已接受锚点找到剪影能承载的写法（发际形状→发型剪影缺口、旧伤→轮廓上的缺口、体态→肩背
-重心），而不是新增、替换或悄悄删掉锚点。找不到可靠通道时记 `creator_decision_needed`，退回
+为已确认锚点找到剪影能承载的写法（发际形状→发型剪影缺口、旧伤→轮廓上的缺口、体态→肩背
+重心），而不是新增、替换或悄悄删掉锚点。找不到可靠通道时标为“需创作者决定”，退回
 资产或创作者，不擅自换一个更好画的身份。
 
 ### 模板槽位不得覆盖身份锚点
 
-**`reviewed_invariant`**：模板槽位不得覆盖已接受的身份锚点；当模板默认值与已接受身份冲突时，
+**`reviewed_invariant`**：模板槽位不得覆盖已确认的身份锚点；当模板默认值与当前身份冲突时，
 **身份优先，模板让位**。
 
-合成例：角色甲的已接受身份是五十岁上下、体格厚重、肩背略沉。若人物板模板对每个角色机械
+合成例：角色甲的身份是五十岁上下、体格厚重、肩背略沉。若人物板模板对每个角色机械
 追加“九头身黄金比例、极度修长的双腿”，这条默认槽位就把角色甲改写成了另一个人，而且因为它
-出现在每张板上，下游会把它当成风格统一而不是错误。角色乙即使确实修长，也应由已接受的
+出现在每张板上，下游会把它当成风格统一而不是错误。角色乙即使确实修长，也应由当前
 Character 锚点写出，而不是由模板默认值代写。
 
 排查方式：把同一批人物板的提示词并排看，找出**逐字重复且与身份无关**的句子。重复出现的
-审美句若不能追溯到某个角色的接受快照，就是模板残留，删除或改写成该角色的真实锚点。
+审美句若不能追溯到某个角色的当前视觉设定，就是模板残留，删除或改写成该角色的真实锚点。
 
 | 检查 | 分类 | 证据 |
 |---|---|---|
 | 形态投影是否只落在词汇层 | `reviewed_invariant` | 形态卡字段与提示词对应句 |
 | 锚点是否在该形态下真的可见 | `reviewed_invariant` | 识别通道与所选锚点 |
-| 模板默认值是否覆盖身份 | `reviewed_invariant` | 跨角色重复句与接受快照 |
-| 形态未定时是否停在提问 | `structural_invariant` | `visual_direction` 状态为 `unset` |
+| 模板默认值是否覆盖身份 | `reviewed_invariant` | 跨角色重复句与当前视觉设定 |
+| 形态未定时是否停在提问 | `structural_invariant` | `视觉设定.md` 明确标为未决 |

package/lib/drama/skills/short-drama-image-prompts/references/common-recipe.md

@@ -25,7 +25,7 @@
 
 资产提示词不是剧情镜头，也不是形容词收藏。它要把已接受资产中最值得稳定的事实，变成一张便于识别、比较和后续复用的参考图意图。
 
-开始前取得：准确的资产 ID 和版本 ID、接受快照与字段位置、用途、目标构图、视觉风格、
+开始前取得：`视觉设定.md` 中准确的资产 ID 和当前变体、来源场景、用途、目标构图、视觉风格、
 背景与光线、文字政策、创作者引用 `REF-*`、约束与排除项。身份尚未确定时停在提案，
 不要用提示词文案掩盖缺口。
 
@@ -90,8 +90,8 @@
 - `look_state_variant`：绑定基础来源、可见变化和有效范围；姿势本身不自动成为新版本。
 - `edit_delta`：只保留精确目标、变化、保持项和连续性影响；上游负责的变化先取得其接受。
 
-`reference_bindings` 不是普通参考图清单。每条只声明一个主要用途，分别写清可借用和不可带入的事实；
-没有参考媒体时用空数组，没有观察证据时保持 `unverified` 并列出风险。
+参考说明不是普通图片清单。每张只声明一个主要用途，分别写清可借用和不可带入的事实；没有参考
+媒体就不写参考段，没有观察证据时保持“未验证”并列出风险。
 
 ## 4. 锚点、约束与取舍
 
@@ -126,7 +126,7 @@
 2. **本次提示词的呈现方法（由图片提示词环节管理）**：`readable | symbolic |
    blank | postproduction`，回答这次参考图怎样处理该真相。
 
-规格必须保存来源政策的产物引用（`src` 与 `record_id`）、字段位置、两层选择和对应理由。
+条目必须指向 `视觉设定.md` 的资产 ID 与文字事实，并写清两层选择和对应理由。
 默认映射：
 
 | 资产来源政策 | 允许的呈现方法 | 要求 |
@@ -147,11 +147,11 @@
 明确接受时，不要编造。
 
 “语义上必须出现签名”不等于已经拥有可复制的正式签名字形。只有签名归属或剧情职责、没有
-创作者接受的字形资产时，保留准确来源引用并阻断 `readable`；仅在已接受文字政策允许
+创作者确认的字形资产时，保留准确来源说明并阻断 `readable`；仅在当前文字政策允许
 `postproduction` 时可预留承载区，不得用姓名、伪签名或自行设计的笔画冒充正式字形。
 若人物的接收或反转依赖这项文字，不得一面保留空白承载区、一面让人物认出签名；候选文本
-保留 `<正式签名字形-ref>` 未决引用，并把涉及可读识别的帧/提示词范围标为 `blocked`，直到
-字形或已接受的合成处理真正到位。
+明确写“正式签名字形未提供”，并点名受影响的 `IMG-...` / `SHOT-...`；在字形或已确认的后期处理
+真正到位前，不写可读签名正文。
 
 ### 检查输入参考图（`IMG-08`）
 
@@ -175,10 +175,8 @@
 
 ### 参考图可以决定哪些内容（`IMG-09`）
 
-`reference_bindings` 为每张参考记录稳定 `slot_id`、显式唯一 `order`、准确的 `artifact_ref`
-（文件头 `sources` 中的快照键 `src` 加该参考的 `record_id`）、一个主要 `role`、`may_control`、`must_not_control`、`admission_status`、可选的准确
-`reference_observation_ref` 与 `unresolved_risks`。数组重排或插入新参考不能改变已有槽位语义。
-常见用途包括身份、造型/状态、
+每张参考使用稳定可见 ID 和显式顺序，写一个主要用途、允许控制、不得控制、观察状态与未决风险。
+调整顺序或插入新参考不能改变已有 ID 的语义。常见用途包括身份、造型/状态、
 地理、构图、尺度和效果；项目也可以增加更具体的用途。
 
 - 身份参考不自动决定姿势、构图或临时造型；
@@ -186,7 +184,7 @@
 - 效果参考只控制已接受目标的形态/范围，不让非目标对象一起消失、复制或变形；
 - 任一参考都继续服从文字政策与已确认来源，冲突时退回负责方，不用“全参考”。
 
-这项质量要结合当前项目资料判断，不能按参考图数量、`role` 关键词或固定裁切方式机械判定。
+这项质量要结合当前项目资料判断，不能按参考图数量、用途关键词或固定裁切方式机械判定。
 
 ### 负面约束
 

package/lib/drama/skills/short-drama-image-prompts/references/edit-and-revision.md

@@ -2,16 +2,15 @@
 
 ## 有界编辑合同 (`IMG-06`)
 
-每次 edit 都声明精确 target/region、要改什么、必须保留什么、以及预期的
-continuity impact。如果期望变更会改写 identity 或 accepted 上游事实，路由给
-该 owner，不要伪装成局部 prompt revision。
+每次 edit 都声明精确目标/区域、要改什么、必须保留什么，以及预期的连续性影响。如果期望变更会
+改写身份或已确认上游事实，路由给该 owner，不要伪装成局部提示词修订。
 
 ## 目录
 
 1. 两类修改
 2. Edit-delta 配方
-3. 自然语言 spec → diff → accept → rerender
-4. 缓存漂移的 restore/adopt
+3. 自然语言要求 → 差异预览 → 确认 → 重写
+4. 当前文件与旧预览不一致时的处理
 5. 失败与检查
 
 ## 1. 两类修改
@@ -26,15 +25,15 @@ continuity impact。如果期望变更会改写 identity 或 accepted 上游事
 四个问题缺一不可：
 
 ```text
-Target：哪个精确来源快照（`sources` 键）、记录、entity 和 region？
+Target：哪个可见 `IMG-...`、对象和区域？
 Change：哪些有边界、可观察的变化？
 Preserve：身份、构图、光线、空间以及哪些未影响 entity/region 必须不变？
-Continuity impact：预期对应哪个 accepted State/binding，有效到哪里？
+Continuity impact：预期对应哪个已确认状态或引用，有效到哪里？
 ```
 
 ### Target
 
-- 用元信息绑定目标快照；copyable 正文用自然语言明确主体和区域。
+- 用可见 `IMG-...` 和对象名绑定目标；可复制正文用自然语言明确主体和区域。
 - “改背景”“让她更狼狈”过宽；需要具体新 View/区域与可观察变化。
 - 多个不相干 target 默认拆为多个 edit，防止 preserve 集失焦。
 
@@ -50,73 +49,62 @@ Continuity impact：预期对应哪个 accepted State/binding，有效到哪里
 
 引用 道具状态/Look/View 或提出 owner revision；记录受影响的 prompt/shot/keyframe，而非在 edit 中成为新的连续性权威。若没有影响，也明确 `none` 及理由。
 
-- **`structural_invariant`**：`target_ref`、region、changes、preserve 和 impact 必须存在且没有显式冲突。
+- **`structural_invariant`**：目标、区域、变化、保持项和影响必须存在且没有显式冲突。
 - **`reviewed_invariant`**：修改范围是否足够清楚、preserve 是否保护真正身份/地理，需要 reviewer 引用证据判断。
 - **`craft_default`**：一次 edit 聚焦少量相互关联的 delta；复杂重构改用新 variant/plate。
 - **`taste_option`**：变化的视觉强度由创作者决定，只要状态事实未变。
 
-## 3. 自然语言 spec → diff → accept → rerender
+## 3. 自然语言修订
 
-用户不需要知道 JSONL 字段。对“把工作服换成深蓝，但保留脸和袖口油渍”执行：
+用户不需要知道内部字段。对“把工作服换成深蓝，但保留脸和袖口油渍”执行：
 
-1. **读取权威源**：当前 accepted spec、asset refs 与 recipe version。
-2. **解释请求**：区分 prompt-owned 改动、source-owned 事实、含糊项与可能影响。
-3. **生成候选 spec**：不覆盖 accepted spec；不确定值保持 unresolved。
-4. **展示语义 diff**：字段路径、before、after、理由、影响、是否需上游 owner。
-5. **展示新 prompt 预览**：让创作者看实际文案效果，而非只看字段。
-6. **接受/拒绝**：接受才提交；拒绝使原 spec 与 Markdown byte-identical。
-7. **重渲染**：从 accepted spec 与 recipe version 导出 Markdown，更新下游 stale 状态。
+1. 读取当前 `视觉设定.md` 条目和 `图片提示词.md` 的 `IMG-...`；
+2. 区分提示词可改措辞、资产 owner 才能改的事实、含糊项和连续性影响；
+3. 展示简短语义差异：改前、改后、理由、保持项、影响和是否需要上游修改；
+4. 展示新的可复制正文，让创作者看到实际效果；
+5. 确认后直接更新同一个 `IMG-...`；拒绝时当前文件保持不变；
+6. 列出需要同步检查的 `SHOT-...` 或其他 `IMG-...`，不自动改用户未点名的文档。
 
 建议预览：
 
 ```markdown
 ### 提议修改 `IMG-...`
-- `variant_delta.uniform.color`: `灰蓝` → `深蓝`
-- `preserve`: 新增 `右袖口原有油渍的形状与位置`
-- 未改：Character identity、服装剪裁、背景、构图、光向
-- 影响：仅当前 Look prompt；若资产 Look 尚未接受深蓝色，先请求 assets 修改
-- 未映射：无
+- 深灰蓝工作服 → 深蓝工作服
+- 保持：脸、服装剪裁、右袖口旧油渍的形状与位置、背景、构图、光向
+- 影响：仅当前造型提示词；若 `视觉设定.md` 还没有深蓝变体，先交给 assets 修改
 
-**重渲染预览**
+**新正文预览**
 > ...
 ```
 
-对“更有电影感”不能擅自选择一串风格字段。给两三个互斥但可解释的候选（如更明确光比/构图/色彩关系），标为 `taste_option` 让创作者选。
+对“更有电影感”不能擅自堆一串风格词。给两三个互斥且可观察的候选，例如光比、构图或色彩关系，
+作为 `taste_option` 让创作者选择。
 
-## 4. 缓存漂移的 restore/adopt
+## 4. 当前文件冲突
 
-`image-prompts.md` 是缓存视图。发现它与 spec 不一致时暂停覆盖：
+如果另一个编辑或人工修改已经改变当前 `IMG-...`，不要用旧预览覆盖：
 
-### Restore
+- 重新读取当前条目；
+- 展示人工改动与本次修改的语义差异；
+- 能安全合并时生成新的完整预览；
+- 无法无损对应、触及上游事实或存在冲突时保留当前文件，并交给创作者选择。
 
-- 展示当前手改文本与将恢复的 canonical preview；
-- 创作者接受后从 accepted spec 重渲染；
-- 不把手改内容静默写回 spec。
-
-### Adopt
-
-- 将可表示的手改语义解析为候选 spec diff；
-- 逐条列出 `mapped`、`unmapped`、`lossy`；
-- 有 unmapped/lossy 或改动 source-owned 事实时阻断 adopt，保留原文件与冲突副本；
-- 安全且被接受后，先提交 spec，再重渲染成规范 Markdown。最终文本可能排版变化，但语义 diff 必须无损。
-
-选择 `merge` 时也先生成候选 diff；不能以“最后写入者获胜”处理创作权威。
+不得把“最后写入者获胜”当创作规则，也不得为了恢复格式丢掉人工增加的有效语义。
 
 ## 5. 失败与检查
 
 ### 失败征兆
 
-- 直接改 accepted JSONL 或只改 Markdown；
-- diff 只写“优化措辞”，没有字段和语义影响；
-- 把身份、Location 地理、道具状态 在 prompt 层擅自改掉；
-- edit 只有 Change 没有 Preserve；
-- unmapped 手改被自动丢弃；拒绝后文件仍改变。
+- 只改可复制正文，却不核对 `视觉设定.md`；
+- 差异只写“优化措辞”，没有语义影响和保持项；
+- 把身份、地点地理或道具状态在提示词层擅自改掉；
+- edit 只有 Change，没有 Preserve；
+- 发现冲突后自动覆盖人工修改。
 
 ### 完成检查
 
-- source-owned 请求已路由给正确 owner；
-- 候选与 accepted 分离，diff 可读、可拒绝，预览可复制；
-- accept 顺序是 spec commit 后 rerender；reject 不变；
-- restore/adopt 都有预览，无法对应字段的改动保留为冲突；
-- 本提示词修订流程不调用媒体生成或 provider API；实际生产交 `$short-drama-produce`
-  并对精确任务预览单独确认。
+- 上游事实请求已路由给正确 owner；
+- 目标、区域、变化、保持项和连续性影响都清楚；
+- 差异预览可读、可拒绝，新正文可直接复制；
+- 拒绝不改变当前文件，冲突不静默吞掉；
+- 本流程不调用媒体生成或 provider API；实际生产交 `$short-drama-produce`，并对精确任务预览单独确认。

package/lib/drama/skills/short-drama-image-prompts/references/location-plate.md

@@ -117,13 +117,12 @@ Location plate 的价值是让后续镜头共享同一可导航空间。输入
 | 同一 Location 同一 state 各 View 的主光、色温与光比是否对齐 | `reviewed_invariant` | 并排比同组 View，差异需成因与 delta |
 | 镜头审美与构图 | `taste_option` | 保留创作者选择 |
 
-输出一条 location-plate spec 和 copyable prompt；ID 留在元信息，正文用清楚自然语言。不得生成 plate 图片。
+输出一个 `IMG-...` 地点板条目和可复制正文；ID 留在标题，正文用清楚自然语言。不得生成地点板图片。
 
 ## 6. 制作形态投影
 
-已接受的 `short-drama.json#/creator_authority/{visual_direction,production_profile}` 决定这张
-场景板用什么词汇表达空间，不决定空间长什么样。形态词表见
-本阶段需要从制作形态取得哪些输入，见 [阶段契约](stage-contract.md) 的“制作形态需要什么”。
+`视觉设定.md` 的项目视觉方向与已明确制作形态决定这张场景板用什么词汇表达空间，不决定空间
+长什么样。
 
 ### 从形态取什么
 

package/lib/drama/skills/short-drama-image-prompts/references/look-and-state-variant.md

@@ -12,27 +12,27 @@
 
 变体的目标是在不改变持久身份的前提下，把有因果、可复用、在一定范围内持续的视觉状态明确出来。它不是为了给每个表情、角度或手势建一张新资产图。
 
-先用 assets 的接受决定区分：
+先用 `视觉设定.md` 的当前判断区分：
 
 - **reuse**：身份/地理/功能和需要保持的 state 都没变，直接复用；
 - **variant**：同一身份上出现可逆或时间有界的 Look/View/道具状态差异；
 - **new asset**：持久身份、固定地理或基本功能已改变；
-- **unresolved**：无法确定，停止编译并让创作者选择。
+- **unresolved**：无法确定，停止写提示词并让创作者选择。
 
-图片提示词不能自行做这项身份决定，只把 accepted variant 编译为可见参考。
+图片提示词不能自行做这项身份决定，只把已确认变体写成可见参考。
 
 ## 2. Base—delta—validity
 
-一条变体规格必须能回答：
+一个 `IMG-...` 变体条目必须能回答：
 
-1. **Base**：它从哪个 exact accepted asset/variant 派生？
+1. **Base**：它从哪个准确身份/变体 ID 派生？
 2. **Preserved anchors**：哪些 Character/Location/Prop 身份事实不变？
 3. **Delta**：哪里发生了什么可观察变化，范围和强度如何？
-4. **Cause/source**：变化来自哪个 screenplay/continuity 事实或 creator 决定？
+4. **Cause/source**：变化来自哪个场景、连续性事实或创作者决定？
 5. **Validity**：从哪里开始、持续到哪里、何时恢复/再变化？
-6. **Affected bindings**：哪些 prompts/shots/keyframes 需要此 variant？
+6. **Affected work**：哪些 `IMG-...`、`SHOT-...` 或关键帧需要此变体？
 
-- **`structural_invariant`**：绑定 exact base + variant ID，source refs 与 validity 可解析；不得同时绑定不相容 variants。
+- **`structural_invariant`**：基底、变体 ID、来源与有效范围可解析；不得同时使用不相容变体。
 - **`reviewed_invariant`**：delta 与持久锚点没有混层，也没有超过 source 支持的范围。
 - **`craft_default`**：正文先短述保持的身份，再把注意力放在 delta；不要重写全部 base。
 - **`taste_option`**：单独 variant plate、同版对照或局部细节板由复用目的决定；默认单独 plate 更少歧义。
@@ -61,13 +61,13 @@
 
 ## 4. 变体 plate 与 edit 的区别
 
-- **Variant plate** 描述一个已接受、可被多个镜头复用的完整当前状态；它可以从零编写 generic prompt，不依赖某张待编辑图片。
-- **Edit-delta** 针对 `target_ref` 指名的精确快照、记录与 region，说明 change/preserve/continuity impact；用于“从现有参考改成 accepted variant”的提示词。
+- **Variant plate** 描述一个已确认、可被多个镜头复用的完整当前状态；它可以从零编写提示词，不依赖某张待编辑图片。
+- **Edit-delta** 针对可见 `IMG-...`、对象和区域，说明变化、保持项与连续性影响；用于“从现有参考改成当前变体”的提示词。
 
 若创作者说“把袖子改湿”：
 
-1. 已有 accepted wet Look，且目标是复用状态 → 可以写 variant plate 或 scoped edit；
-2. wet Look 尚未接受 → 先向 assets 提 variant proposal；
+1. 已有明确的湿衣 Look，且目标是复用状态 → 可以写变体板或局部编辑；
+2. 湿衣 Look 尚未确认 → 先向 assets 提变体选择；
 3. 只发生在单镜头动作末端、没有持续复用 → 可能应由 storyboard continuity 拥有，不自动创建资产 prompt。
 
 不要把 before/after 两个互斥人物叠在一张身份板，除非用途明确是比较板，且两个区域/标签不会造成身份融合；这属于可覆盖的 craft choice，不是默认。
@@ -87,10 +87,11 @@
 
 | 检查 | 分类 |
 |---|---|
-| exact base/variant、source、validity 解析 | `structural_invariant` |
+| 准确基底/变体、来源、有效范围解析 | `structural_invariant` |
 | delta 是否保持 identity/geography/function | `reviewed_invariant` |
 | 是否误把瞬时 shot 状态升级为 asset variant | `reviewed_invariant` |
 | delta 是否比 base boilerplate 更醒目 | `craft_default` |
 | 单图或对照板、变化强度与呈现媒介 | `taste_option` |
 
-输出包含 base、delta、preserve、validity 与 affected bindings 的 spec，以及一段聚焦当前状态的 generic prompt。不得生成图片，也不得声称变体画面已经验证成功。
+输出一个写清基底、变化、保持项、有效范围和受影响工作的 `IMG-...` 条目，以及一段聚焦当前状态的
+可复制正文。不得生成图片，也不得声称变体画面已经验证成功。