zenstory-ai/drama-skills / skills/short-drama-write
short-drama-write
Verified编写或修订可拍摄的中文短剧、漫剧单集 Markdown 剧本,也负责保留作者原文并把现成剧本整理成标准格式。用户提出“写/改一集短剧”“把大纲写成剧本”“优化场景/对白”“去模板感”“去 AI 味润色”“续写下一集”或提供剧本要求进入后续制作时使用;不负责视觉设定、分镜、生图与视频提示词或终审。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.2 KB |
| agents/openai.yaml | config | 288 B |
| references/dialogue-craft.md | markdown | 12.0 KB |
| references/production-format-dialect.md | markdown | 2.0 KB |
| references/screenplay-format.md | markdown | 7.8 KB |
| references/script-craft.md | markdown | 19.3 KB |
| references/stage-contract.md | markdown | 7.2 KB |
| scripts/duration_estimate.py | script | 44.0 KB |
| scripts/screenplay_index.py | script | 57.7 KB |
| scripts/selftest.py | script | 7.1 KB |
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())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |