---
name: Short Drama
slug: short-drama
category: Automation
description: Orchestrates short drama/comic projects by routing tasks to specialized sub-skills, providing a local dashboard for creators, and managing project lifecycle from initialization to delivery.
github: "https://github.com/worldwonderer/drama-skills/tree/main/skills/short-drama"
language: Python
stars: 631
forks: 229
install: "npx degit https://github.com/worldwonderer/drama-skills/tree/main/skills/short-drama ~/.claude/skills/short-drama"
installs_to: ~/.claude/skills/short-drama
source_path: skills/short-drama/SKILL.md
collection_size: 10
category_size: 1523
collection_url: "https://dirskills.com/collections/worldwonderer/drama-skills"
added: 2026-08-11T07:20:20.998Z
last_synced: 2026-08-11T07:20:20.998Z
canonical_url: "https://dirskills.com/skills/short-drama"
---

# Short Drama

Orchestrates short drama/comic projects by routing tasks to specialized sub-skills, providing a local dashboard for creators, and managing project lifecycle from initialization to delivery.

**Install:**

```bash
npx degit https://github.com/worldwonderer/drama-skills/tree/main/skills/short-drama ~/.claude/skills/short-drama
```

## README

# 短剧创作路由

这是轻量项目路由，不在本技能内代写故事、资产提示词、镜头、视频提示词或终审结论。
默认使用创作者的语言；中文项目使用简洁中文呈现状态、差异、选择和下一步。

## 每次请求的起点

1. 使用用户明确路径，或从当前目录向上寻找最近的 `short-drama.json`。
2. 从本技能安装目录找到同一套件的其他技能，读取 `suite-manifest.json`；缺少技能或版本混用时先停止变更。
3. 只读 `short-drama.json` 与 `.short-drama/state.json` 摘要；不要一次加载全部创作文件。
4. 执行 `status` 或写入前先运行事务恢复。发现外部编辑冲突时保留原文件，提供
   `adopt`、`restore`、`merge` 三种处理，不静默覆盖。
5. 按创作者当前任务路由；不强制补走整条流水线。

入口、检查点、修订和交付见 [creator-workflow.md](references/creator-workflow.md)。
每次入口先执行 [runtime-preflight.md](references/runtime-preflight.md)，统一验证安装、恢复事务并读取项目状态。
所有权、文件过期标记 `stale`、隐私或恢复有疑问时读
[contract-and-ownership.md](references/contract-and-ownership.md)。
意图含混时读 [routing-examples.md](references/routing-examples.md)。
只在需要把规则 ID 定位到负责技能时读
[knowhow-index.md](references/knowhow-index.md)；路由只负责分派，不代替创作技能判断。
一张参考图可以决定什么、以及首尾帧契约见 [reference-roles.md](references/reference-roles.md)；
观众此刻可以知道什么见 [audience-reveal.md](references/audience-reveal.md)；
补拍与替代版和母版的关系见 [pickup-and-alternate.md](references/pickup-and-alternate.md)。
不同制作形态的执行翻译见 [production-form-profiles.md](references/production-form-profiles.md)。
需要在正式分镜前用人物、地点和高压力代表帧统一视觉语言时读
[look-development.md](references/look-development.md)。

## 意图路由

| 创作者意图 | 路由 |
|---|---|
| 开发点子、故事承诺、系列、分集地图 | `$short-drama-develop` |
| 导入小说/长材料并做可追溯分集与资产候选预览 | `$short-drama-develop` → 接受改编/分集 → `$short-drama-write` → 接受剧本 → `$short-drama-assets` |
| 写/改单集契约、因果节拍、剧本 | `$short-drama-write` |
| 拆人物/造型、地点/视图、道具/状态 | `$short-drama-assets` |
| 写人物/地点/道具/局部修改的图片提示词 | `$short-drama-image-prompts` |
| 做原文覆盖、镜头或冻结关键帧 | `$short-drama-storyboard` |
| 写动作/表演/运镜/声音视频提示词 | `$short-drama-video-prompts` |
| 定画风、制作形态或视觉方向 | `$short-drama` 本身：按 [production-form-profiles.md](references/production-form-profiles.md) 定位一张形态卡，产出候选并请创作者接受，再提升到 `creator_authority`。资产、图片提示词、分镜与视频提示词都要求形态已定，且都不自行选择，所以这一步必须在这里完成 |
| 做 Look Development / 风格帧 | `$short-drama` 先明确并接受可观察视觉方向 → `$short-drama-image-prompts` 写 `lookdev_frame` 文本规格；不生成图片，也不让风格参考接管身份、地理或剧情状态 |
| 用授权生产观察校准本项目 | `$short-drama-review` 绑定准确版本并诊断 → 对应 owner 做有 `preserve_set` 的定点修订 → 重新接受与 fresh re-review；没有授权观察时只报文字风险 |
| 校验、审查或发修订请求 | `$short-drama-review` |
| 只检查或诊断模板感、AI 味 | fresh `$short-drama-review`，只发带证据 finding |
| 直接去 AI 味、润色或定点改稿 | `$short-drama-write`，保留作者声音并展示语义差异 |
| 先检查再改 | fresh review → write owner 定点修订 → fresh re-review |
| 打开 Dashboard、短剧创作台或管理创作内容 | `$short-drama dashboard`：执行下方“本地 Dashboard”启动契约 |

创作者明确意图优先于名义上的“下一检查点”。Look Development 是可选的项目级分支，不是通用前置；
C2 资产接受后，图片提示词和分镜是平行分支；创作者只要其中一支时，不强迫等待另一支。

若当前上下文参与过目标文件的创作，审查路由必须优先启动 fresh reviewer agent/context，
只传目标、已接受限制和审查表；运行环境不支持 fresh agent 时透明降级为 `PROVISIONAL`
自检，不能把切换 Skill 名称当成独立审查。

“像不像模板/AI 写的”是诊断请求；“把它改掉”是 owner 修订请求。不要让 write owner
先自诊断再给自己签发结论，也不要让 reviewer 越权直接改正文。组合请求先冻结目标版本，
由 fresh reviewer 定位证据和损失，再交 write owner 只改被接受的范围，最后换一个 fresh
reviewer 对新 hash 做 re-review；任何无法取得独立上下文的环节都保持 `PROVISIONAL`。

## 初始化

没有项目且用户要初始化时：

1. 仅确认或合理推断可逆格式默认值：标题、语言、画幅、路径；集数/时长未知就留空。
2. 复制项目模板，不覆盖已有创作者文件。
3. 建立空阶段目录和非公开输入边界。
4. 在 `short-drama.json#/creator_authority` 建立空的创作者限制、视觉方向和制作配置；
   它们初始为 `unset`，而资产及其下游都要求形态已定——所以初始化后要告知创作者：
   **定制作形态是下一个最有用的动作**，入口在本技能（见意图路由表），不在任何子技能；
   实际选择写入 [creator-decision.example.jsonl](assets/creator-decision.example.jsonl)
   所示的决定记录。
5. 记录套件版本、契约版本与五项彼此独立的空状态。
6. 告知项目路径和最有用的创作者动作。

初始化不生成故事引擎、剧本或资产设定表。

开发阶段若提交 `项目开发/director-brief.md`，先向创作者展示其相对当前
`visual_direction` / `production_profile` 的语义差异；只有明确接受后，路由才把相应选择
提升到 `short-drama.json#/creator_authority`。候选文件本身不具有 creator authority。

## 本地 Dashboard

当用户调用 `$short-drama dashboard` 时，不再转交子技能，直接启动本技能自带的
本地短剧创作台：

1. 先按 [runtime-preflight.md](references/runtime-preflight.md) 核对套件并恢复未完事务。
2. 工作目录位于某个项目内时，以该项目根为 `workspace`；否则使用用户明确
   给出的容器目录，未给出则使用当前目录。不扫描 workspace 之外。
3. 从本技能安装目录运行：

   ```text
   python3 <short-drama-skill-dir>/scripts/dashboard_server.py --workspace <workspace> --port 0 --open
   ```

4. 保持进程运行，回报脚本打印的完整回环地址（包含本次启动的会话片段）和停止方式。
   浏览器无法自动打开时，保留服务并让用户打开该完整地址。

Dashboard 只有一个创作页面：左侧是按项目与剧集整理的通俗内容目录，右侧是常驻正文；
打开项目后自动载入剧本，切换内容只替换正文，不打开新页面或浮层。待办与导出只作为
正文下方的简短提示。界面不显示文件树、真实路径、结构化格式、生命周期或工程详情入口。
Markdown 作为文稿阅读和编辑；结构化数据转换为卡片；图片和视频只预览。
`short-drama.json`、`.short-drama/**`、创作者决定、检查证据和导出校验均由系统维护，
不成为创作者导航。保存只表示保存修改，不能替代创作者明确采用某个版本。
它不连接外部数据源、不调用媒体生成接口，也不向浏览器注入密钥。
每次启动生成独立会话凭证和 API 路径；浏览器用地址片段换取 `HttpOnly` 本机会话，
项目 API 仅接受该会话。
具体参数见 [lifecycle-commands.md](references/lifecycle-commands.md#dashboard-启动)。

## 确定性工具

从本技能安装目录调用 `scripts/project_tool.py`，不依赖当前工作目录：

| 命令 | 用途 |
|---|---|
| `init` | 初始化最小项目 |
| `status` | 读取生命周期与恢复摘要 |
| `recover` | 恢复全部或指定事务 |
| `publish` | 通过预写日志发布 `candidate`，不附带接受或审查结论 |
| `accept` | 用创作者决定记录接受准确的 `candidate` 目标 |
| `review` | 用独立审查结论更新校验与审查状态 |
| `package` | 复验五轴、依赖和证据后生成文本交付包 |
| `verify` | 用交付包自带的校验和复核它，并报告未登记的新增文件 |

只有实际调用这些命令、诊断失败或核对记录格式时，才读取
[lifecycle-commands.md](references/lifecycle-commands.md) 中的完整调用示例、预写日志、接受、
审查、下游过期影响与打包约束。

## 状态与下一步

用创作者语言说明：

- 已存在且状态为 `accepted` 的来源；
- 状态为 `provisional`、`stale`、`blocked` 或待创作者接受的内容；
- 当前可并行进入的分支；
- 推动用户所求结果的最小动作。

除非用户要求诊断，不打印 `hash`、事务 ID、内部数据结构或原始状态内容。
五项状态彼此独立：构建、校验、创作者接受、独立审查和交付检查；不得用一个
`accepted` 冒充全部。

## 恢复与修订

恢复用户所问环节内最早未完成的操作，而不是全项目最早阶段。变更已确认内容前：

1. 指明负责修改的技能；
2. 展示拟议的语义变化；
3. 列出准确的下游受影响清单；
4. 在需要时取得创作者接受；
5. 交给负责人修改，并对新 `hash` 重新审查。

没有 `COMMIT` 的不完整事务回滚到已保存的上一版本；已有 `COMMIT` 的不完整事务继续到
`candidate` 并补齐状态。恢复必须先读后写、可重复运行；无法确认来源的外部改动必须标为
`conflict`，不能覆盖。

## 交付

先路由到 `$short-drama-review` 的 fresh 审查上下文校验，再在交付检查就绪时打包。只包含状态为 `accepted`
的剧本、清单、提示词、审查、创作者备注与校验和。排除二进制媒体、非公开输入、
机器状态、绝对路径、凭据、非公开来源材料和未批准草稿。

## 边界

- 只使用当前智能体的文本推理；不调用媒体生成或服务接口。
- 运行时不检索外部或非公开生产来源。
- 不把别处见过的案例提升为创作定律。
- 负责人不能审查自己的产物。
- 语义冲突不静默修复。