@oh-story/dsh 0.1.0

package/lib/drama/skills/short-drama-develop/scripts/selftest.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+"""Offline self-test for multi-episode source intake."""
+
+from __future__ import annotations
+
+import tempfile
+import sys
+from pathlib import Path
+
+from episode_intake import build_index, slice_episode, verify_index, write_index
+
+MINIMUM_PYTHON = (3, 9)
+if sys.version_info < MINIMUM_PYTHON:
+    raise SystemExit("selftest.py requires Python 3.9 or newer")
+
+
+def require(condition: bool, message: str) -> None:
+    if not condition:
+        raise AssertionError(message)
+
+
+def main() -> int:
+    with tempfile.TemporaryDirectory() as directory:
+        root = Path(directory)
+        source = root / "episodes.md"
+        index = root / "index.json"
+        source.write_text("第1集 开端\n行动一。\n第2集 反转\n行动二。\n", encoding="utf-8")
+
+        document = build_index(source, source_ref="输入/episodes.md")
+        require(document["episode_count"] == 2, "episode count")
+        require(document["problems"] == [], "valid episode index")
+        write_index(index, document)
+        require(verify_index(index, source)["verified"] is True, "fresh index")
+        require(
+            slice_episode(index, source, "EP002").startswith("第2集".encode()),
+            "verified episode slice",
+        )
+
+        source.write_text(source.read_text(encoding="utf-8") + "变更。\n", encoding="utf-8")
+        require(verify_index(index, source)["verified"] is False, "source drift")
+
+    print("5 self-tests passed")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

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

@@ -0,0 +1,181 @@
+---
+name: short-drama-image-prompts
+description: 为已确认的短剧角色、造型、场景、视角、道具和状态编写或修改可复制的通用资产图片提示词，并把已接受视觉方向投影成 Look Development 人物、地点或高压力风格帧。用户提到角色设定图、三视图、人物参考图、场景设定图、场景空镜、场景板、道具图、风格帧、Look Development、造型或状态变体、局部编辑提示词，或要求用自然语言修改现有图片提示词时直接使用；只产出结构化规格与 Markdown 文本，不生成图片，也不调用模型或供应商接口。
+license: MIT
+---
+
+# 短剧资产图片提示词
+
+把已接受的资产事实写成“能认出、能复用、能区分状态”的参考图提示词。这里的产物是提示词，不是图片。
+
+预览、警告与修订说明是创作者读的：项目内跟随 `short-drama.json#/language`，独立运行时
+跟随用户使用的语言。送给图片生成器的**通用提示词正文**在项目内跟随
+`#/format/prompt_language`，独立运行时由用户指定、未指定则为 `en`。
+改了描述语言不等于
+改了画面里的可读文字——那由已接受的文字政策决定。
+
+## 开始前
+
+本技能可独立安装和执行。先读取用户明确提供的资产事实、视觉方向与本任务直接输入；若当前
+目录是 `short-drama` 项目且项目工具可用，可以读取 `status` 并使用其发布生命周期，但缺少
+core 或任何其他技能都不是提示词工作的阻断条件。[阶段契约](references/stage-contract.md)
+给出本阶段边界、制作形态输入与规则表，无需读取其他技能的文件。
+
+## Quick Start
+
+从本技能的最小原生 JSONL 样例开始，写完当前有界资产集合后运行：
+
+```text
+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。本技能本身仍只负责规格和提示词。

package/lib/drama/skills/short-drama-image-prompts/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "短剧资产图提示词"
+  short_description: "为人物场景道具及局部编辑编写可追溯、可复用的图片提示词"
+  default_prompt: "使用 $short-drama-image-prompts 为已接受资产编写可复制的人物、场景、道具或编辑图片提示词。"

package/lib/drama/skills/short-drama-image-prompts/assets/image-prompt-spec.jsonl.md

@@ -0,0 +1,187 @@
+# `image-prompt-specs.jsonl` 填写模板
+
+首行是 `sources` 声明记录，之后每行一个候选规格对象，用于接受前预览；示例值不是默认答案。删除不适用字段，不要添加
+媒体任务、供应商或接口字段。上游引用默认绑定准确的已接受快照；只有与本对象同次发布的目标才写
+`authority:candidate`。对象接受状态由事务生命周期记录，不能靠改状态字样伪造。
+
+## 首行：`sources` 声明
+
+本文件用到的每个上游快照在这里声明一次，键取产物文件名（`characters`、`looks`、`props`），
+在本文件内唯一且稳定：
+
+```json
+{
+  "record_type": "sources",
+  "schema_version": "1.0.0",
+  "sources": {
+    "<identity-owner>": {
+      "owner": "short-drama-assets",
+      "artifact": "设定集/<identity-owner-file>.jsonl"
+    },
+    "<variant-owner>": {
+      "owner": "short-drama-assets",
+      "artifact": "设定集/<variant-owner-file>.jsonl"
+    },
+    "props": {
+      "owner": "short-drama-assets",
+      "artifact": "设定集/props.jsonl"
+    },
+    "<reference>": {
+      "owner": "<reference-owner>",
+      "artifact": "<project-relative-reference-record>"
+    },
+    "<edit-target>": {
+      "owner": "short-drama-image-prompts",
+      "artifact": "<精确目标>"
+    }
+  }
+}
+```
+
+引用用 `src` 指向声明键，再写本条引用自己的 `record_id` 和 `field`：
+`{"src": "<identity-owner>", "record_id": "CHAR-<id>"}`。
+
+## 规格行
+
+```json
+{
+  "spec_id": "IMG-<stable-id>",
+  "status": "candidate",
+  "purpose": "character_sheet | location_plate | prop_plate | look_state_variant | edit_delta",
+  "asset_binding": {
+    "identity_ref": {
+      "src": "<identity-owner>",
+      "record_id": "CHAR/LOC/PROP-<id>"
+    },
+    "variant_ref": {
+      "src": "<variant-owner>",
+      "record_id": "LOOK/VIEW/PSTATE-<id>"
+    }
+  },
+  "source_refs": [
+    {
+      "src": "<identity-owner>",
+      "record_id": "<record>",
+      "field": "/<field>",
+      "role": "identity_anchor | variant_delta | geography | scale | text_policy"
+    }
+  ],
+  "reference_bindings": [
+    {
+      "slot_id": "REF-<stable-slot>",
+      "order": 1,
+      "artifact_ref": {
+        "src": "<reference>",
+        "record_id": "<accepted-reference-record>"
+      },
+      "role": "composition",
+      "may_control": [
+        "<本次允许借用的构图事实>"
+      ],
+      "must_not_control": [
+        "<身份/内容/文字/状态等禁入事实>"
+      ],
+      "admission_status": "unverified | creator_described | visually_inspected",
+      "reference_observation_ref": null,
+      "unresolved_risks": [
+        "<没有观察证据时保留的文字/水印/裁切风险>"
+      ]
+    }
+  ],
+  "recipe": {
+    "name": "<type-recipe>",
+    "version": "<suite recipe version>"
+  },
+  "intent": {
+    "reuse_job": "<这张参考图后续保持什么>",
+    "audience": "<使用者/阶段>"
+  },
+  "identity_or_form_anchors": [
+    "<稳定、可见、可比较的锚点>"
+  ],
+  "variant_deltas": [
+    {
+      "field": "<变化对象>",
+      "observable_change": "<位置/范围/结果>",
+      "valid_range": "<接受的有效范围>"
+    }
+  ],
+  "composition": {
+    "view": "<观察方向/视图>",
+    "framing": "<主体占比或板式>",
+    "orientation": "<方向定义>",
+    "scale_relation": "<尺度参照>",
+    "spatial_relations": [
+      "<锚点之间的关系>"
+    ]
+  },
+  "appearance": {
+    "materials": [
+      "<识别所需材质>"
+    ],
+    "palette": "<主次色关系>",
+    "lighting": "<光源、方向、用途>",
+    "atmosphere": "<有事实依据的气氛>"
+  },
+  "background": {
+    "policy": "clean | contextual | empty_stage",
+    "details": "<背景与允许出现内容>"
+  },
+  "text_handling": {
+    "source_policy_ref": {
+      "src": "props",
+      "record_id": "PROP-<id>",
+      "field": "/text_policy"
+    },
+    "source_mode": "exact_readable | graphic_only | no_readable_text | pending_creator_text",
+    "render_treatment": {
+      "mode": "readable | symbolic | blank | postproduction",
+      "surface": "<承载面>",
+      "exact_text": "<仅 readable 且来自接受源时填写>",
+      "layout_or_reserved_area": "<方向/区域/行数>"
+    },
+    "mapping_rationale": "<为何本次呈现保持 source policy>"
+  },
+  "constraints": [
+    "<必须出现/保持>"
+  ],
+  "negative_constraints": [
+    "<仅当前高风险且不矛盾的排除>"
+  ],
+  "edit": {
+    "changes": [
+      "<有边界变化>"
+    ],
+    "preserve": [
+      "<身份/构图/光线/未影响区域>"
+    ],
+    "continuity_impact": "<影响的 accepted variant/binding 或 none>",
+    "target_ref": {
+      "src": "<edit-target>",
+      "record_id": "IMG-<target-id>",
+      "field": "/generic_prompt"
+    },
+    "entity_or_region": "<区域>"
+  },
+  "creator_overrides": [
+    {
+      "rule_id": "<IMG-*>",
+      "choice": "<覆盖选择>",
+      "rationale": "<原因>"
+    }
+  ],
+  "generic_prompt": "<从本规格渲染的可复制通用提示词>",
+  "derivation": {
+    "renderer": "generic-markdown"
+  },
+  "provenance": "creator_project"
+}
+```
+
+
+复制后按 `purpose` 删除不适用字段和悬空引用，`sources` 只保留仍被引用的键。Look Development 不使用本超集模板，改读
+[`lookdev-frame-spec.jsonl.md`](lookdev-frame-spec.jsonl.md)，避免普通人物、地点和道具规格加载
+风格帧专属字段。
+每条参考只声明一个用途，多参考的 `slot_id` 稳定且 `order` 显式。类型取舍、文字政策与
+参考准入由技能按 `references/common-recipe.md` 判断。候选与已接受对象分开发布；自然语言修改先形成
+候选和内容差异，不直接覆盖原记录。

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

@@ -0,0 +1,37 @@
+# `image-prompts.md` 可复制输出模板
+
+此文件由已接受规格生成。元信息用于核对来源；只复制引用块内的通用提示词。不要手写供应商参数。
+
+```markdown
+# EP<编号> · 资产图片提示词
+
+> 来源：`image-prompt-specs.jsonl` 的已接受记录
+> 配方：`<recipe>@<version>`
+> 范围：本文件仅提供提示词，不触发媒体服务；实际图片生产交 `$short-drama-produce`
+
+## `<display name>` · `<purpose>`
+
+- **规格**：`IMG-<id>`
+- **绑定**：`<asset-id>` + `<variant-id>`
+- **用途**：<后续复用目标>
+- **参考图用途**：`<slot_id / order / reference>` 只决定 `<role / may_control>`；不得导入 `<must_not_control>`；检查状态 `<observation ref | unverified + risks>`；无参考则写“无”
+- **文字来源政策**：`exact_readable | graphic_only | no_readable_text | pending_creator_text`
+- **本次呈现**：`readable | symbolic | blank | postproduction`（附 source → treatment 映射）
+- **注意**：<未阻断的警告 / 创作者明确调整；无则写“无”>
+
+### 可复制通用提示词
+
+> <正文语言按 `short-drama.json#/format/prompt_language`（独立运行时由用户指定，未指定为 `en`）——这一格不预设中文。用途/主体与区分性锚点在前，状态、构图、空间/尺度、材质/光线、背景、文字政策、保持/排除依次展开。不要出现字段名、hash、审查话术或生成历史。>
+
+### 变体/编辑说明
+
+- **相对基准**：<基础版本；非变体可省略>
+- **变化**：<看得见的变化；无则省略>
+- **必须保持**：<`preserve_set`；非局部修改可简写或省略>
+- **连续性影响**：<已接受的绑定 / 无；非局部修改可省略>
+
+---
+```
+
+每个资产或版本独立一节；不要把多个互相冲突的造型、观察方向或状态合成一个可复制段落。
+该文件被手改过时，先按 `restore | adopt` 流程预览将要恢复或采用的内容。

package/lib/drama/skills/short-drama-image-prompts/assets/lookdev-frame-spec.jsonl.md

@@ -0,0 +1,128 @@
+# `lookdev-frame` 填写模板
+
+只在 `purpose: lookdev_frame` 时读取。首行是 `sources` 声明记录，之后每行一个候选风格帧规格；它投影已接受视觉方向，
+不替普通人物、地点、道具规格增加字段。删除当前测试轴不需要的可选项。
+
+## 首行：`sources` 声明
+
+本文件用到的每个上游快照在这里声明一次，键取产物文件名，在本文件内唯一且稳定。视觉方向与
+制作形态同出于 `short-drama.json`，共用一个键：
+
+```json
+{
+  "record_type": "sources",
+  "schema_version": "1.0.0",
+  "sources": {
+    "short-drama": {
+      "owner": "creator",
+      "artifact": "short-drama.json"
+    },
+    "<identity-owner>": {
+      "owner": "short-drama-assets",
+      "artifact": "设定集/<identity-owner-file>.jsonl"
+    },
+    "<variant-owner>": {
+      "owner": "short-drama-assets",
+      "artifact": "设定集/<variant-owner-file>.jsonl"
+    },
+    "screenplay-index": {
+      "owner": "short-drama-write",
+      "artifact": "剧集/<EP>/screenplay-index.jsonl"
+    },
+    "<reference>": {
+      "owner": "<reference-owner>",
+      "artifact": "<project-relative-reference-record>"
+    }
+  }
+}
+```
+
+引用用 `src` 指向声明键，再写本条引用自己的 `record_id` 和 `field`。
+
+## 规格行
+
+```json
+{
+  "spec_id": "LOOKDEV-<stable-id>",
+  "status": "candidate",
+  "purpose": "lookdev_frame",
+  "lookdev_axis": "character_expression | core_location | high_pressure_scene",
+  "direction_ref": {
+    "src": "short-drama",
+    "field": "/creator_authority/visual_direction/choices/look_development"
+  },
+  "production_profile_ref": {
+    "src": "short-drama",
+    "field": "/creator_authority/production_profile"
+  },
+  "subject_bindings": [
+    {
+      "identity_ref": {
+        "src": "<identity-owner>",
+        "record_id": "CHAR/LOC/PROP-<id>"
+      },
+      "variant_ref": {
+        "src": "<variant-owner>",
+        "record_id": "LOOK/VIEW/PSTATE-<id>"
+      },
+      "role": "expression_subject | location | pressure_actor | evidence"
+    }
+  ],
+  "story_context_refs": [
+    {
+      "src": "screenplay-index",
+      "record_id": "BLK-<EP>-<SC>-<kind><nn>",
+      "field": "/<exact-source-field-if-needed>",
+      "role": "scene_heading | action | dialogue | information_permission | story_state"
+    }
+  ],
+  "reference_bindings": [
+    {
+      "slot_id": "REF-<stable-slot>",
+      "order": 1,
+      "artifact_ref": {
+        "src": "<reference>",
+        "record_id": "<stable-record-id>"
+      },
+      "role": "style",
+      "may_control": [
+        "<色彩层级/材质处理/阴影边缘/景深倾向/画面密度>"
+      ],
+      "must_not_control": [
+        "<角色身份/固定地理/剧情状态/人数/持物/道具文字>"
+      ],
+      "admission_status": "unverified | creator_described | visually_inspected",
+      "reference_observation_ref": null,
+      "unresolved_risks": []
+    }
+  ],
+  "test_question": "<本帧要暴露哪一种视觉方向风险>",
+  "stable_visual_rules": [
+    "<跨测试轴必须保留的可观察规则>"
+  ],
+  "allowed_variation": [
+    "<本场允许变化的光比/冷暖/留白/密度>"
+  ],
+  "composition_and_state": "<只写当前代表帧需要的构图、空间与剧情状态>",
+  "appearance": {
+    "materials": [
+      "<材质处理>"
+    ],
+    "palette": "<色彩层级>",
+    "lighting": "<光源逻辑与阴影边缘>",
+    "depth_or_density": "<景深/画面密度>"
+  },
+  "constraints": [
+    "<必须保持的身份、地理、文字与信息权限>"
+  ],
+  "generic_prompt": "<只含可被画出的自然表述，语言按 #/format/prompt_language，不含字段名/hash/审查话术>",
+  "derivation": {
+    "renderer": "generic-markdown"
+  },
+  "provenance": "creator_project"
+}
+```
+
+人物与地点测试没有剧情职责时删除 `story_context_refs` 及其 `sources` 键；高压力场景必须保留真实 `BLK-…`
+来源。单主体也使用一项 `subject_bindings[]`，不再与 `asset_binding` 二选一。无参考媒体时
+`reference_bindings` 为空；多参考的 `slot_id` 稳定、`order` 唯一。

package/lib/drama/skills/short-drama-image-prompts/assets/lookdev-prompts.md

@@ -0,0 +1,31 @@
+# `lookdev-prompts.md` 可复制输出模板
+
+此文件由已接受 Look Development 规格派生。它展示视觉方向怎样跨测试轴保持，
+只复制引用块内的自然语言提示词；本文件不触发图片或媒体服务，实际生产交
+`$short-drama-produce` 并单独确认。
+
+```markdown
+# 项目 Look Development 提示词
+
+> 来源：`lookdev-image-prompt-specs.jsonl` 的已接受记录
+> 视觉方向：`short-drama.json#/creator_authority/visual_direction/choices/look_development`
+> 范围：仅代表帧提示词，不拥有角色身份、地点地理或剧情状态
+
+## `LOOKDEV-<id>` · `<人物表现 | 核心地点 | 高压力场景>`
+
+- **测试问题**：<本帧要暴露的视觉方向风险>
+- **绑定事实**：<准确身份/变体；高压力帧再列 scene/block refs>
+- **跨轴稳定**：<形状、材质、色彩、阴影、景深或密度中的共同规则>
+- **本帧可变**：<当前场景允许变化的部分>
+- **风格参考权限**：`<slot_id / order / reference>` 只决定 `<may_control>`，不得导入 `<must_not_control>`
+- **仍未知**：<只能由授权生产观察回答的风险；无则写“无”>
+
+### 可复制通用提示词
+
+> <只写可被画出的主体、空间、构图、材质、光色和状态；不含字段名、hash、审查话术、供应商参数或生成历史。>
+
+---
+```
+
+三类测试帧不要求固定数量或宫格。人物/地点帧没有剧情职责时不列 scene/block refs；高压力帧必须
+显示其准确来源。规格或视觉方向改了就重新派生本文件，不直接手改缓存。

package/lib/drama/skills/short-drama-image-prompts/examples/minimal-image-prompt-specs.jsonl

@@ -0,0 +1,2 @@
+{"record_type": "sources", "schema_version": "1.0.0", "sources": {"characters": {"owner": "short-drama-assets", "artifact": "characters.jsonl"}, "looks": {"owner": "short-drama-assets", "artifact": "looks.jsonl"}, "composition-reference": {"owner": "creator", "artifact": "composition-reference.png"}}}
+{"spec_id": "IMG-LIN-RAIN", "status": "candidate", "purpose": "character_sheet", "asset_binding": {"identity_ref": {"src": "characters", "record_id": "CHAR-LIN"}, "variant_ref": {"src": "looks", "record_id": "LOOK-LIN-RAIN"}}, "source_refs": [{"src": "characters", "record_id": "CHAR-LIN", "field": "/identity_anchors", "role": "identity_anchor"}], "reference_bindings": [{"slot_id": "REF-LIN-COMPOSITION", "order": 1, "artifact_ref": {"src": "composition-reference", "record_id": "REF-COMP-01"}, "role": "composition", "may_control": ["左右排版与留白"], "must_not_control": ["角色身份、服装、文字"], "admission_status": "creator_described", "reference_observation_ref": null, "unresolved_risks": []}], "intent": {"reuse_job": "保持角色在雨夜造型中的跨镜身份", "audience": "image production"}, "identity_or_form_anchors": ["齐下颌黑发", "左眉尾浅疤", "站立时重心偏右"], "variant_deltas": [{"field": "wardrobe", "observable_change": "深蓝旧雨衣，肩部被雨水加深", "valid_range": "SC001-SC002"}], "composition": {"view": "front and side reference sheet", "framing": "full body", "orientation": "neutral", "scale_relation": "consistent body proportions", "spatial_relations": []}, "appearance": {"materials": ["worn waterproof fabric"], "palette": "deep blue with muted skin tones", "lighting": "soft neutral studio light", "atmosphere": "clean reference presentation"}, "background": {"policy": "clean", "details": "plain light-gray background"}, "constraints": ["one coherent accepted look", "identity anchors remain visible"], "negative_constraints": ["no extra accessories", "no readable text"], "generic_prompt": "Character reference sheet for Lin Lan in one coherent rain look, jaw-length black hair, a shallow scar at the left eyebrow tail, weight resting slightly on the right leg, worn deep-blue raincoat with rain-darkened shoulders, front and side full-body views, neutral studio light, plain light-gray background, no extra accessories, no readable text.", "provenance": "creator_project"}