Skip to content

zenstory-ai/drama-skills / skills/short-drama-write

short-drama-write

Verified

编写或修订可拍摄的中文短剧、漫剧单集 Markdown 剧本,也负责保留作者原文并把现成剧本整理成标准格式。用户提出“写/改一集短剧”“把大纲写成剧本”“优化场景/对白”“去模板感”“去 AI 味润色”“续写下一集”或提供剧本要求进入后续制作时使用;不负责视觉设定、分镜、生图与视频提示词或终审。

scripts/selftest.py

View on GitHub
#!/usr/bin/env python3
"""Offline self-test for screenplay indexing and duration estimates."""

from __future__ import annotations

import json
import sys
import tempfile
from pathlib import Path
from typing import Any, Mapping

MINIMUM_PYTHON = (3, 9)
if sys.version_info < MINIMUM_PYTHON:
    raise SystemExit("selftest.py requires Python 3.9 or newer")

_SCRIPT_DIR = str(Path(__file__).resolve().parent)
if _SCRIPT_DIR not in sys.path:
    sys.path.insert(0, _SCRIPT_DIR)

from duration_estimate import StaleIndex, estimate, index_blocks, parse_script_blocks  # noqa: E402
from screenplay_index import build_index  # noqa: E402


def require(condition: bool, message: str) -> None:
    if not condition:
        raise AssertionError(message)


def measure_text(
    body: str, project: Mapping[str, Any] | None = None
) -> dict[str, Any]:
    """Index a screenplay the documented way, then estimate from that index.

    The estimate has no reader of its own. Going through ``build_index`` here is
    the point of the test, not overhead: it is what stops this script and the
    index from holding two opinions about the same line.
    """
    with tempfile.TemporaryDirectory() as directory:
        root = Path(directory)
        screenplay = root / "剧本.md"
        index_path = root / "screenplay-index.jsonl"
        screenplay.write_text(
            "# EP001\n\n## EP001-SC001 内 · 房间 · 日\n\n" + body, encoding="utf-8"
        )
        build_index(
            screenplay,
            index_path,
            source_ref="剧集/EP001/剧本.md",
            speakers=["甲"],
        )
        records = [
            json.loads(line)
            for line in index_path.read_text(encoding="utf-8").splitlines()
            if line.strip()
        ]
        source = screenplay.read_bytes()
        blocks, review = index_blocks(records, source)
        return estimate(source, blocks, project, review)


def test_duration_reports_counts_without_rates() -> None:
    """No declared rates must yield no seconds -- never a default guess."""
    report = measure_text("甲:一二三四五。\n\n他把门关上。\n")
    require(report["seconds"] is None, "seconds must stay unknown without rates")
    require(report["counts"]["dialogue_characters"] == 6, "spoken characters counted")
    require(report["counts"]["action_paragraphs"] == 1, "action paragraph counted")


def test_duration_uses_the_projects_own_rates() -> None:
    project = {
        "format": {
            "target_seconds_per_episode": 10,
            "pacing": {
                "spoken_characters_per_second": 3.0,
                "seconds_per_action_paragraph": 2.0,
            },
        }
    }
    report = measure_text("甲:一二三四五六。\n\n他把门关上。\n", project)
    # Punctuation stays in dialogue_characters (for VO share) and is excluded
    # from voiced_characters (pronounced speech): 6 / 3.0 + 1 * 2.0 == 4.0.
    require(report["counts"]["dialogue_characters"] == 7, "dialogue_characters keeps punctuation")
    require(report["counts"]["voiced_characters"] == 6, "voiced_characters drops punctuation")
    require(report["seconds"] == 4.0, f"expected 4.0s, got {report['seconds']}")
    require(report["delta_seconds"] == -6.0, "delta is reported against the target")


def test_production_tags_are_not_performed_time() -> None:
    report = measure_text("[画面文字] 店门告示:暂停营业\n\n他把门关上。\n")
    require(report["counts"]["production_tag_lines"] == 1, "tag counted separately")
    require(report["counts"]["action_paragraphs"] == 1, "tag is not an action")


def test_voice_over_is_performed_time() -> None:
    """[VO] is a line delivered off-camera, not an instruction to a later stage."""
    report = measure_text("[VO] 甲:一二三四五。\n")
    require(report["counts"]["dialogue_lines"] == 1, "[VO] is a spoken line")
    require(report["counts"]["dialogue_characters"] == 6, "[VO] characters are timed")
    require(report["counts"]["production_tag_lines"] == 0, "[VO] is not a mute tag")


def test_one_action_paragraph_is_one_paragraph_however_many_lines() -> None:
    """The format contract lets an action paragraph run several lines."""
    report = measure_text("他站起来,\n走到窗边,\n把窗帘拉开。\n")
    require(
        report["counts"]["action_paragraphs"] == 1,
        f"expected 1 paragraph, got {report['counts']['action_paragraphs']}",
    )


def test_comments_are_not_production_content() -> None:
    """A Markdown comment is a note to the writer, not a line to perform."""
    report = measure_text("<!-- 待确认:这一段的转场是否保留。 -->\n")
    require(report["counts"]["dialogue_lines"] == 0, "a comment is not dialogue")
    require(report["counts"]["dialogue_characters"] == 0, "a comment is not spoken")
    require(report["counts"]["action_paragraphs"] == 0, "a comment is not an action")


def test_an_index_from_other_bytes_is_refused() -> None:
    """Spans from a stale index land on text it never classified."""
    stale = [
        {
            "record_type": "screenplay_index_meta",
            "source_byte_length": 999_999,
        }
    ]
    try:
        index_blocks(stale, b"short")
    except StaleIndex:
        return
    raise AssertionError("a stale index must be refused, not measured")


def test_parse_script_blocks_estimates_in_memory() -> None:
    """Direct --script parsing handles spaces after colons and plausible auto-speakers."""
    raw = (
        "# EP001\n\n## EP001-SC001 内 · 房间 · 日\n\n"
        "林落: 我先看一眼。\n\n"
        "Agent Smith: Stay back.\n\n"
        "他把门关上。\n"
    ).encode("utf-8")
    blocks, review = parse_script_blocks(raw)
    require(review["review_status"] == "clean", f"expected clean review, got {review}")
    report = estimate(raw, blocks, None, review)
    require("incomplete" not in report, "valid in-memory script must not be incomplete")
    require(report["counts"]["dialogue_lines"] == 2, "two auto-discovered dialogue lines")
    require(report["counts"]["action_paragraphs"] == 1, "one action paragraph")


def main() -> int:
    with tempfile.TemporaryDirectory() as directory:
        root = Path(directory)
        screenplay = root / "剧本.md"
        index_path = root / "screenplay-index.jsonl"
        screenplay.write_text(
            "# EP001\n\n## EP001-SC001 内 · 客厅 · 夜\n\n陈予安推开门。\n\n陈予安:我回来了。\n",
            encoding="utf-8",
        )
        summary = build_index(
            screenplay,
            index_path,
            source_ref="剧集/EP001/剧本.md",
            speakers=["陈予安"],
        )
        require(summary["review_status"] == "clean", "valid screenplay index")

    test_duration_reports_counts_without_rates()
    test_duration_uses_the_projects_own_rates()
    test_production_tags_are_not_performed_time()
    test_voice_over_is_performed_time()
    test_one_action_paragraph_is_one_paragraph_however_many_lines()
    test_comments_are_not_production_content()
    test_an_index_from_other_bytes_is_refused()
    test_parse_script_blocks_estimates_in_memory()

    print("9 self-tests passed")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall