@lemoncat7/dsh-partner 2.5.0 → 2.7.0

package/resources/skills/drama-production/upstream/skills/short-drama-edit/scripts/selftest.py

@@ -0,0 +1,520 @@
+#!/usr/bin/env python3
+"""Offline self-test for cut-list parsing and mechanical checks.
+
+Runs without ffmpeg: every assertion here is about the document, not the media.
+The media-dependent paths are exercised by the suite's tests instead.
+"""
+
+from __future__ import annotations
+
+import re
+import sys
+import tempfile
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+
+from edit_tool import (  # noqa: E402
+    _unaccounted_shots,
+    DEFAULT_REMOTION_CONCURRENCY,
+    REMOTION_SOURCE,
+    REMOTION_SOURCE_FILES,
+    EditError,
+    _ass_text,
+    _build_ass,
+    _shot_match_filter,
+    _subtitle_cues,
+    check_cuts,
+    parse_cut_list,
+)
+
+MINIMUM_PYTHON = (3, 9)
+if sys.version_info < MINIMUM_PYTHON:
+    raise SystemExit("selftest.py requires Python 3.9 or newer")
+
+MOTION = """# EP001 视频提示词
+
+## MOTION-EP001-010 · 手指停在发布键上
+
+## MOTION-EP001-011 · 认证弹窗展开
+"""
+
+SCREENPLAY = """# EP001
+
+## EP001-SC003 内 · 房间 · 夜
+
+角色甲：这条路我自己走。
+"""
+
+CUT_LIST = """# EP001 剪辑单
+
+- 成片目标时长：5.00 秒
+- 交付响度：-16 LUFS
+- 未采用镜头：MOTION-EP001-009（理由：文件缺失——尚未生产）
+
+## CUT-EP001-001 · 手指停在发布键上
+
+- 来源：MOTION-EP001-010 · media/010.mp4
+- 入点：0.60
+- 出点：3.60
+- 时长：3.00
+- 取舍：入点=手指已经在下压；出点=界面开始响应
+- 声音：保留原声
+- 字幕：无
+
+## CUT-EP001-002 · 那句话
+
+- 来源：MOTION-EP001-011 · media/011.mp4
+- 入点：0.00
+- 出点：2.00
+- 时长：2.00
+- 取舍：入点=文件起点；出点=句尾收音后
+- 声音：保留原声
+- 字幕：这条路我自己走
+"""
+
+
+def require(condition: bool, message: str) -> None:
+    if not condition:
+        raise AssertionError(message)
+
+
+def build(root: Path, cut_list: str) -> Path:
+    episode = root / "剧集" / "EP001"
+    (episode / "media").mkdir(parents=True)
+    (episode / "视频提示词.md").write_text(MOTION, encoding="utf-8")
+    (episode / "剧本.md").write_text(SCREENPLAY, encoding="utf-8")
+    (episode / "剪辑单.md").write_text(cut_list, encoding="utf-8")
+    for name in ("010.mp4", "011.mp4"):
+        (episode / "media" / name).write_bytes(b"")
+    return episode
+
+
+def check_subtitle_geometry() -> None:
+    """FontSize is already in PlayRes units; scaling it by the frame twice ruins it.
+
+    Letting ffmpeg convert an SRT hands libass a 384-high canvas and every size
+    is then multiplied by height/384 on the way to the frame. Computing the size
+    from the real height on top of that produced type a third of the frame wide,
+    sitting in the middle of the picture with both ends of the line cut off — and
+    it shipped, because the render after the style change was checked with
+    numbers instead of a frame.
+    """
+
+    width, height = 768, 1344
+    ass = _build_ass([(1.0, 2.0, "这条路我自己走")], width, height)
+    require(f"PlayResX: {width}" in ass, "PlayResX 必须等于画面宽")
+    require(f"PlayResY: {height}" in ass, "PlayResY 必须等于画面高")
+    style = next(line for line in ass.splitlines() if line.startswith("Style:"))
+    fields = style.split(":", 1)[1].split(",")
+    font_size = float(fields[2])
+    require(
+        height * 0.02 <= font_size <= height * 0.06,
+        f"字号 {font_size} 不在画面高度的 2%–6% 之间",
+    )
+    margin_v = float(fields[21])
+    require(margin_v < height * 0.2, f"底边距 {margin_v} 会把字幕推离安全区")
+    margin_h = float(fields[19])
+    require(margin_h > 0, "左右边距为 0 时长句会顶到画面边缘")
+    require("这条路我自己走" in ass, "台词原文必须原样进 ASS")
+
+
+def check_subtitle_timing() -> None:
+    """Cues follow the segments that were written, not the numbers in the document.
+
+    Each segment lands on a frame boundary, so it runs a few milliseconds past
+    its declared length. Accumulating the declared numbers drifts, and the
+    subtitle leaves before the actor stops speaking.
+    """
+
+    with tempfile.TemporaryDirectory() as scratch:
+        root = Path(scratch)
+        episode = build(root, CUT_LIST)
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        declared = [cut.end - cut.start for cut in cuts]
+        measured = [span + 0.04 for span in declared]
+
+        drifting = _subtitle_cues(cuts, declared)
+        真实 = _subtitle_cues(cuts, measured)
+        require(len(真实) == 1, f"应有一条字幕，实际 {len(真实)}")
+        require(
+            真实[0][0] > drifting[0][0],
+            "分段比声明更长时，后面的字幕必须相应后移",
+        )
+        require(
+            abs(真实[0][0] - (drifting[0][0] + 0.04)) < 1e-6,
+            "位移必须等于前面各段的实测差之和",
+        )
+
+
+def check_shot_match() -> None:
+    """A declared correction is applied; an undeclared one never is.
+
+    Generated shots drift a stop apart, so the join reads as a mistake. The
+    correction has to be visible in the document — a tool that measured clips
+    and adjusted them on its own would be changing pictures nobody could review.
+    """
+
+    with tempfile.TemporaryDirectory() as scratch:
+        root = Path(scratch)
+        episode = build(root, CUT_LIST)
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        require(_shot_match_filter(cuts[0]) == "", "没写画面的段不得被改动")
+
+        listed = CUT_LIST.replace(
+            "- 声音：保留原声\n- 字幕：无",
+            "- 声音：保留原声\n- 画面：亮度 +0.06；色温 -6\n- 字幕：无", 1)
+        (episode / "剪辑单.md").write_text(listed, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        chain = _shot_match_filter(cuts[0])
+        require("brightness=0.06" in chain, f"亮度没进滤镜链: {chain}")
+        require("colorbalance" in chain and "rm=-0.06" in chain, f"色温没进滤镜链: {chain}")
+
+        # ffmpeg 的 eq 只接受 0..3 的饱和度；负数在文档里通过、渲染时才炸。
+        negative = CUT_LIST.replace(
+            "- 声音：保留原声\n- 字幕：无",
+            "- 声音：保留原声\n- 画面：饱和 -1.5\n- 字幕：无", 1)
+        (episode / "剪辑单.md").write_text(negative, encoding="utf-8")
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("超出允许范围" in str(error), f"负饱和度报错不对: {error}")
+        else:
+            raise AssertionError("饱和 -1.5 应当被拒绝——ffmpeg 不接受负饱和度")
+
+        # 超出范围是重新调色，不是接镜，必须挡住。
+        wild = CUT_LIST.replace(
+            "- 声音：保留原声\n- 字幕：无",
+            "- 声音：保留原声\n- 画面：亮度 +0.9\n- 字幕：无", 1)
+        (episode / "剪辑单.md").write_text(wild, encoding="utf-8")
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("超出允许范围" in str(error), f"越界报错不对: {error}")
+        else:
+            raise AssertionError("亮度 +0.9 应当被拒绝")
+
+        # 写了内容却没有可执行项，是写错了，不能静默当成不校正。
+        vague = CUT_LIST.replace(
+            "- 声音：保留原声\n- 字幕：无",
+            "- 声音：保留原声\n- 画面：调暖一点\n- 字幕：无", 1)
+        (episode / "剪辑单.md").write_text(vague, encoding="utf-8")
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("没有可执行的项" in str(error), f"含混报错不对: {error}")
+        else:
+            raise AssertionError("「调暖一点」应当被拒绝")
+
+
+def check_multi_subtitle() -> None:
+    """A shot can carry several lines, and all of them must reach the screen.
+
+    The exchange "就是什么 / 就是少了点东西 / 少了什么" is one over-shoulder shot.
+    A cut list that holds only one subtitle per cut silently drops the other
+    two: the film plays lines that never appear, and nothing reports it.
+    """
+
+    with tempfile.TemporaryDirectory() as scratch:
+        root = Path(scratch)
+        episode = build(root, CUT_LIST)
+        (episode / "剧本.md").write_text(
+            SCREENPLAY + "\n江晨：就是什么。\n江晨：就是少了点东西。\n江晨：少了什么。\n",
+            encoding="utf-8",
+        )
+        multi = CUT_LIST.replace(
+            "- 字幕：这条路我自己走",
+            "- 字幕 1：0.10-0.60 就是什么\n"
+            "- 字幕 2：0.80-1.40 就是少了点东西\n"
+            "- 字幕 3：1.50-1.90 少了什么",
+        )
+        (episode / "剪辑单.md").write_text(multi, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        require(len(cuts[1].subtitles) == 3, f"三句应全部解析，实际 {len(cuts[1].subtitles)}")
+        require(cuts[1].subtitles[2][2] == "少了什么", "字幕顺序错了")
+        require(not check_cuts(episode, cuts, root, probe=False), "三句合法字幕不该报错")
+        cues = _subtitle_cues(cuts, [cut.end - cut.start for cut in cuts])
+        require(len(cues) == 3, f"三句应各自成为一条 cue，实际 {len(cues)}")
+
+        # 编号必须连续：跳号意味着有一句被漏掉了。
+        gap = CUT_LIST.replace(
+            "- 字幕：这条路我自己走",
+            "- 字幕 1：0.10-0.60 就是什么\n- 字幕 3：1.50-1.90 少了什么",
+        )
+        (episode / "剪辑单.md").write_text(gap, encoding="utf-8")
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("连续" in str(error), f"跳号报错不对: {error}")
+        else:
+            raise AssertionError("字幕编号跳号应当被拒绝")
+
+        # 两句不能同时在屏上。
+        overlap = CUT_LIST.replace(
+            "- 字幕：这条路我自己走",
+            "- 字幕 1：0.10-1.00 就是什么\n- 字幕 2：0.80-1.40 就是少了点东西",
+        )
+        (episode / "剪辑单.md").write_text(overlap, encoding="utf-8")
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("重叠" in str(error), f"重叠报错不对: {error}")
+        else:
+            raise AssertionError("字幕时间重叠应当被拒绝")
+
+        # 多句时每句必须自带时间，否则无从摆放。
+        untimed = CUT_LIST.replace(
+            "- 字幕：这条路我自己走",
+            "- 字幕 1：就是什么\n- 字幕 2：0.80-1.40 就是少了点东西",
+        )
+        (episode / "剪辑单.md").write_text(untimed, encoding="utf-8")
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("各自带时间" in str(error), f"缺时间报错不对: {error}")
+        else:
+            raise AssertionError("多句字幕缺时间应当被拒绝")
+
+
+def check_stale_window() -> None:
+    """Regenerating a shot invalidates every subtitle window bound to it.
+
+    The windows were reverse-engineered from the old take's audio. Nothing else
+    notices the change: the numbers stay in range, the render still succeeds,
+    and the subtitle appears at a moment when nobody is speaking.
+    """
+
+    import os
+    import time
+
+    with tempfile.TemporaryDirectory() as scratch:
+        root = Path(scratch)
+        # Anchored on the field, not on the line's wording: the fixture's dialogue
+        # is illustrative and gets rewritten, and a test that breaks when an
+        # example changes is a test nobody trusts.
+        timed = re.sub(
+            r"^(- 字幕：(?!无).+)$",
+            r"\1\n- 字幕时间：0.30-1.60",
+            CUT_LIST,
+            count=1,
+            flags=re.MULTILINE,
+        )
+        require(timed != CUT_LIST, "夹具里应当有一条带台词的字幕")
+        episode = build(root, timed)
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        require(
+            not check_cuts(episode, cuts, root, probe=False),
+            "素材不比剪辑单新时不该报陈旧",
+        )
+
+        media = episode / "media" / "011.mp4"
+        listing = episode / "剪辑单.md"
+        newer = listing.stat().st_mtime + 60
+        os.utime(media, (newer, newer))
+        findings = check_cuts(episode, cuts, root, probe=False)
+        require(
+            any("素材比剪辑单新" in item for item in findings),
+            f"重出后的陈旧字幕时间没抓到: {findings}",
+        )
+
+        # 改过剪辑单之后就不再报——那正是「重测并改」的动作。
+        time.sleep(0.01)
+        listing.write_text(timed, encoding="utf-8")
+        later = newer + 60
+        os.utime(listing, (later, later))
+        _, cuts, _ = parse_cut_list(listing)
+        require(
+            not any("素材比剪辑单新" in item for item in check_cuts(episode, cuts, root, probe=False)),
+            "改过剪辑单之后不该继续报陈旧",
+        )
+
+
+def check_ass_escaping() -> None:
+    """A quoted line keeps every character it had in 剧本.md.
+
+    `{`…`}` is an override block in ASS: unescaped, libass drops the braces and
+    everything between them, on screen, with no error anywhere. EDT-05 exists to
+    keep the burned text equal to the screenplay's character for character.
+    """
+
+    line = "他念出来：{姓名}，请签字。"
+    escaped = _ass_text(line)
+    require("\\{" in escaped and "\\}" in escaped, f"花括号没有转义: {escaped}")
+    require("姓名" in escaped, "转义把字弄丢了")
+    ass = _build_ass([(1.0, 2.0, line)], 1080, 1920)
+    dialogue = [row for row in ass.splitlines() if row.startswith("Dialogue")][0]
+    require(dialogue.endswith(escaped), f"Dialogue 行没有用转义后的正文: {dialogue}")
+    require(
+        _ass_text("反斜杠 \\N 不是换行").count("\\\\") == 1,
+        "反斜杠没有转义，\\N 会被当成换行",
+    )
+
+
+def check_remotion_sources_all_shipped() -> None:
+    """The sync list is a whitelist; a file left out of it is missing at render.
+
+    Nothing else notices until someone has already paid for that render.
+    """
+
+    # `as_posix`, because the whitelist is written with forward slashes and
+    # `relative_to` yields backslashes on Windows.
+    on_disk = {
+        path.relative_to(REMOTION_SOURCE).as_posix()
+        for path in REMOTION_SOURCE.rglob("*")
+        if path.is_file()
+        and path.suffix in {".ts", ".tsx", ".json"}
+        and "node_modules" not in path.parts
+    }
+    listed = set(REMOTION_SOURCE_FILES)
+    require(not (on_disk - listed), f"Remotion 源文件没进同步清单: {sorted(on_disk - listed)}")
+    require(not (listed - on_disk), f"同步清单里有不存在的文件: {sorted(listed - on_disk)}")
+
+
+def check_remotion_concurrency_is_capped() -> None:
+    """Remotion defaults to one browser per core, each holding a full frame."""
+
+    require(DEFAULT_REMOTION_CONCURRENCY >= 1, "并发上限必须是正数")
+    source = Path(__file__).resolve().with_name("edit_tool.py").read_text(encoding="utf-8")
+    require("--concurrency=" in source, "render 必须显式传 --concurrency，不能用 Remotion 的默认值")
+
+
+def check_grain_is_a_delivery_wide_decision() -> None:
+    """Grain is declared once for the film, and refused when it is not grain.
+
+    Per cut it would become one more thing that differs between segments, which
+    is the defect it exists to cover.
+    """
+
+    with tempfile.TemporaryDirectory() as scratch:
+        root = Path(scratch)
+        episode = build(root, CUT_LIST)
+        path = episode / "剪辑单.md"
+        baseline = path.read_text(encoding="utf-8")
+
+        delivery, _, _ = parse_cut_list(path)
+        require(delivery.grain is None, "没声明颗粒时应当是 None")
+
+        anchor = "- 交付响度："
+        require(anchor in baseline, "夹具里应当有交付响度那一行")
+        path.write_text(baseline.replace(anchor, "- 颗粒：6\n" + anchor, 1), encoding="utf-8")
+        delivery, _, _ = parse_cut_list(path)
+        require(delivery.grain == 6.0, f"颗粒没有解析出来: {delivery.grain}")
+
+        path.write_text(baseline.replace(anchor, "- 颗粒：无\n" + anchor, 1), encoding="utf-8")
+        delivery, _, _ = parse_cut_list(path)
+        require(delivery.grain is None, "「无」应当解析成不加颗粒")
+
+        path.write_text(baseline.replace(anchor, "- 颗粒：80\n" + anchor, 1), encoding="utf-8")
+        try:
+            parse_cut_list(path)
+        except EditError as error:
+            require("超出" in str(error), f"越界报错没说清: {error}")
+        else:
+            raise AssertionError("颗粒 80 应当被拒绝")
+
+
+def check_missing_shots_are_reported() -> None:
+    """A shot absent from the film must be absent on purpose.
+
+    Absence is invisible in a finished film — nobody watching can tell that an
+    episode's opening seven shots were never made. The only place it can be
+    caught is here, against the document that lists them.
+    """
+
+    known = {f"MOTION-EP006-{i:03d}" for i in range(1, 5)}
+
+    class Stub:
+        def __init__(self, motion): self.motion = motion
+
+    used = [Stub("MOTION-EP006-003"), Stub("MOTION-EP006-004")]
+    findings = _unaccounted_shots(known, used, [])
+    require(findings, "少了两镜却没有任何 finding")
+    require("001" in findings[0] and "002" in findings[0], f"没点名缺的镜头: {findings}")
+
+    excused = _unaccounted_shots(
+        known, used, ["MOTION-EP006-001（理由：质量不可用）", "MOTION-EP006-002（理由：文件缺失）"]
+    )
+    require(not excused, f"写进未采用的镜头不该再报: {excused}")
+
+    require(not _unaccounted_shots(known, [Stub(m) for m in known], []), "全采用时不该报")
+
+
+def main() -> int:
+    with tempfile.TemporaryDirectory() as scratch:
+        root = Path(scratch)
+        episode = build(root, CUT_LIST)
+        delivery, cuts, unused = parse_cut_list(episode / "剪辑单.md")
+        require(delivery.target_seconds == 5.0, "目标时长没有解析出来")
+        require(delivery.loudness_lufs == -16.0, "交付响度没有解析出来")
+        require(len(cuts) == 2, f"应解析出 2 段，实际 {len(cuts)}")
+        require(len(unused) == 1, "未采用镜头没有解析出来")
+        require(cuts[1].subtitles[0][2] == "这条路我自己走", "字幕文字没有解析出来")
+
+        clean = check_cuts(episode, cuts, root, probe=False)
+        require(not clean, f"完好的剪辑单不该有 findings: {clean}")
+
+        # 出点 - 入点 与声明时长不符必须抓到。
+        drifted = CUT_LIST.replace("- 时长：3.00", "- 时长：2.50")
+        (episode / "剪辑单.md").write_text(drifted, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        findings = check_cuts(episode, cuts, root, probe=False)
+        require(any("与「时长" in item for item in findings), f"时长漂移没抓到: {findings}")
+
+        # 字幕必须能在剧本里找到原文；转写猜出来的字不行。
+        invented = CUT_LIST.replace("字幕：这条路我自己走", "字幕：这条陆我自己走")
+        (episode / "剪辑单.md").write_text(invented, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        findings = check_cuts(episode, cuts, root, probe=False)
+        require(any("找不到原文" in item for item in findings), f"编造的字幕没抓到: {findings}")
+
+        # 未知 MOTION 必须抓到。
+        unknown = CUT_LIST.replace("MOTION-EP001-011", "MOTION-EP001-099")
+        (episode / "剪辑单.md").write_text(unknown, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        findings = check_cuts(episode, cuts, root, probe=False)
+        require(any("不在《视频提示词.md》中" in item for item in findings), f"未知 MOTION 没抓到: {findings}")
+
+        # 素材缺失必须抓到。
+        (episode / "media" / "011.mp4").unlink()
+        (episode / "剪辑单.md").write_text(CUT_LIST, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        findings = check_cuts(episode, cuts, root, probe=False)
+        require(any("素材不存在" in item for item in findings), f"缺素材没抓到: {findings}")
+
+        # 同一素材上的两段不得重叠。
+        overlapping = CUT_LIST.replace(
+            "- 来源：MOTION-EP001-011 · media/011.mp4", "- 来源：MOTION-EP001-011 · media/010.mp4"
+        ).replace("- 入点：0.00", "- 入点：1.00").replace("- 出点：2.00", "- 出点：3.00")
+        (episode / "media" / "011.mp4").write_bytes(b"")
+        (episode / "剪辑单.md").write_text(overlapping, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        findings = check_cuts(episode, cuts, root, probe=False)
+        require(any("区间重叠" in item for item in findings), f"同源重叠没抓到: {findings}")
+
+        # 缺字段是文档缺陷，报出来而不是崩掉。
+        (episode / "剪辑单.md").write_text(
+            CUT_LIST.replace("- 出点：3.60\n", ""), encoding="utf-8"
+        )
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("出点" in str(error), f"缺字段的报错没点名字段: {error}")
+        else:
+            raise AssertionError("缺「出点」应当报错")
+
+    check_subtitle_geometry()
+    check_subtitle_timing()
+    check_shot_match()
+    check_ass_escaping()
+    check_multi_subtitle()
+    check_stale_window()
+    check_missing_shots_are_reported()
+    check_grain_is_a_delivery_wide_decision()
+    check_remotion_sources_all_shipped()
+    check_remotion_concurrency_is_capped()
+    print("short-drama-edit self-tests passed")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: short-drama-image-prompts
+description: 为短剧人物、造型、地点、道具和状态编写或修改可直接复制的图片提示词 Markdown。用户提到角色设定图、三视图、参考图、场景板、道具图、风格帧、Look Development、状态变体或局部编辑提示词时使用；不生成图片，也不调用供应商。
+license: MIT
+---
+
+# 短剧资产图片提示词
+
+把视觉事实写成可复用、可修改、可直接复制的角色板、场景板、道具板或状态图提示词，统一保存到
+`剧集/<EP>/图片提示词.md`。每项用 `IMG-...` 标题，正文放在 `### 可复制提示词` 引用块。
+`IMG-...` 只是该提示词条目的稳定 ID，不声明图片已生成或可用；实际图片只能来自创作者已提供的输入，或经确认后的生产结果。
+
+## Quick Start
+
+```text
+用 $short-drama-image-prompts 为 EP001 已确定的人物、地点和道具写可直接复制的图片提示词
+```
+
+## 入口
+
+有当前视觉设定即可直接开始；剧本只在提示词需要确认剧情状态时读取。Look Development 是可选分支。
+先确认用途：身份板、造型/状态变体、地点板、道具板、组合 production sheet 或比较风格帧。
+分镜需要生产尾帧时，可把已接受的「收尾关键帧提示词」落实为独立 `IMG-...` 状态图条目：
+说明来源 SHOT 与终点，沿用视觉事实和参考范围，不重新设计动作。实际生成以该 IMG 条目为来源。
+
+创作者可读说明跟随项目语言；可复制正文跟随 `short-drama.json#/format/prompt_language`。没有
+`short-drama.json` 时正文默认
+使用 `en`，并在同一任务中保持一致；不能从创作者说明语言推断提示词语言。
+
+## 工作流
+
+1. 锁定这一张图要固定的身份、状态、空间或比较变量。
+2. 只读所需资产事实、视觉方向、负面约束和已提供参考图。
+3. 按“主体与身份锚点 → 当前变体 → 构图/视角 → 光色/材质 → 背景边界 → 禁止项”写正文。
+4. 每张参考只控制身份、造型、地理、构图或风格中的明确部分，并在 `REF-...` 槽位里写出封闭词表中的 `用途`。
+5. 检查身份与变体、文字政策、视角和光线是否冲突。
+6. 用户要全部资产就完成全部，资产组只是内部批次。
+
+## 提示词要求
+
+- 开头先写对象和用途，不用风格词淹没身份。
+- 只包含当前图能同时满足的要求；多视图/状态对照写清版面关系。
+- 保留稳定识别锚点，变体只改允许变化的部分。
+- 被《视觉设定.md》连续性锁点名的条目，锁面原样出现在可复制正文里，让这张参考图本身就把跨镜事实定住。
+- 避免无验证作用的质量词堆砌。
+- 可见文字、logo、水印、界面和字幕明确允许或禁止。
+- 正文可直接复制，不含占位符、流程说明、文件路径或 QA 结论。
+
+## 按需知识
+
+默认只读本 SKILL 和当前视觉设定。遇到对应问题时只打开一份：
+
+- 阶段边界与规则分级：[阶段契约](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)
+
+## 完成与投产
+
+每个点名对象都有明确用途、可复制正文、参考边界和禁止项，且相互不矛盾，即完成。本次请求同时
+修改图片提示词与分镜时，当轮刷新受影响镜头的「图片提示词项」，不另建对账产物。实际生成必须
+转 `$short-drama-produce`，展示精确任务并取得显式确认；本技能不调用外部服务。
+五份创作文档齐备后，可转 `$short-drama` 对跨文档结构做一次机械核对；内容质量仍由创作者审查。
+
+## 安装维护
+
+只有安装、升级或排障时运行 `python3 scripts/selftest.py`。

package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/agents/openai.yaml

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