**中文** | [English](README_EN.md)

# 短剧技能套件

面向编剧、漫剧工作室和编导的 AI 短剧创作技能套件。它把点子或长篇材料一路发展为 分集剧本、资产设定、图片提示词、分镜/关键帧、视频提示词和独立审查记录，并用同一套 创作者决策、来源引用与连续性契约衔接各环节。适配 Claude Code、Codex 和其他支持 Agent Skill 规范的运行环境。

当前版本只交付剧本、资产说明、分镜、提示词、审查记录和结构化文本；不调用真正的 图片、视频或音频生成服务。

## 核心思路

三句话贯穿整条制作链：

> 1. **剧本交付可表演、可制作的事实**：优先用行动、证据、调度与对白策略承载 > 意义；VO/OS、屏显文字和表演括注只在创作者有意选择时使用。 > 2. **资产拥有身份与状态，分镜拥有本镜呈现**：参考图版式、背景和视图数量由 > 项目用途决定，让每种构图方案服务明确的复用目标。 > 3. **连续性必须明确记录**：精确比较相邻镜头的已确认边界；提示词只重复当前执行 > 必需的局部锚点，以项目记录作为跨环节协作依据。

除此之外，规则分为四类：可以直接检查的结构要求、需要结合证据判断的内容要求、 通常有帮助的做法，以及由创作者决定的风格选择。创作判断因此保留弹性，确定性工具则 专注保护文件、引用、状态和交付完整性。

题材手册按压力来源、人物策略、观众回报和制作难点选择写法；制作形态卡再把实拍、 2D 动态漫、风格化 3D、水墨等方向翻译成形、层、材质、光、动作与声音，让同一故事 意图在编剧、资产、分镜和提示词之间保持一致。

## 每个技能自包含

八个技能同级安装，但**互不读取对方的文件**。共享内容按阶段切片内联：每个子技能的 `references/stage-contract.md` 自带该阶段的运行时预检、所有权边界、需要从制作形态取得 哪些输入，以及本阶段完整的规则表。路由技能只按技能名分派，不代子技能决定读哪一份资料。

代价是同一条 `CON-*` 连续性规则会在资产、分镜、视频提示词三处各存一份；测试强制三份的 分级与正文完全一致，改一处必须改三处。

## 生产链路

```mermaid flowchart LR classDef phase fill:#e8f4fd,color:#1a1a2e,stroke:#4a9be8,stroke-width:1px classDef final fill:#fce4ec,color:#333,stroke:#e57373,stroke-width:1px

dev["故事开发<br/>$short-drama-develop"]:::phase write["分集剧本<br/>$short-drama-write"]:::phase assets["资产决策<br/>$short-drama-assets"]:::phase img["图片提示词<br/>$short-drama-image-prompts"]:::phase sb["分镜/关键帧<br/>$short-drama-storyboard"]:::phase vid["视频提示词<br/>$short-drama-video-prompts"]:::phase rev["独立审查<br/>$short-drama-review"]:::final pkg["文本交付包"]:::final

dev -.可选.-> write --> assets assets --> img assets --> sb --> vid img --> rev vid --> rev --> pkg ```

`$short-drama` 是入口路由：初始化、继续、恢复和交付项目，把具体工作转给对应 技能。现成剧本可以直接进入规范化或资产拆解，点子与长篇材料则从故事开发进入。

图像提示词有两条职责清晰的路径：`$short-drama-image-prompts` 为人物、地点、道具等 **资产参考图**写复用提示词；`$short-drama-storyboard` 在每个镜头内写只代表该镜开始 状态的**关键帧提示词**。两者共享已接受的资产事实，并分别维护复用设计与本镜呈现。

## 技能

| 技能 | 职责 | |---|---| | `short-drama` | 初始化、路由、状态、异常恢复、接受/审查生命周期与交付 | | `short-drama-develop` | 小说/长材料的可追溯改编、故事引