@oh-story/dsh 0.1.2 → 0.1.4

package/lib/drama/skills/short-drama/SKILL.md

@@ -1,153 +1,86 @@
 ---
 name: short-drama
-description: 基于文件系统初始化、继续和交付短剧或漫剧项目，并提供面向创作者的本地 Dashboard；也负责项目级制作形态、视觉方向和 Look Development 路由。用户提出“创建/继续短剧项目”“看进度/下一步”“做 Look Development”“打开 dashboard/短剧创作台”“导出制作资料”，或任务跨多个环节而需要判断负责技能时使用；明确的写作、资产、提示词、分镜或审查请求由对应子 skill 直接处理。
+description: 基于文件系统初始化和继续短剧或漫剧项目，提供 creator-first 五文档路由、本地 Dashboard、制作形态与 Look Development 决策。用户提出“创建/继续短剧项目”“看进度/下一步”“做 Look Development”“打开 dashboard/短剧创作台”“导出制作资料”，或任务跨多个创作阶段时使用；明确的写作、资产、提示词、分镜或审查请求由对应子 skill 直接处理。
 license: MIT
 ---
 
 # 短剧创作路由
 
-本技能负责找到项目、显示当前状态并把工作交给正确的创作技能，不代写各阶段内容。
+本技能负责项目初始化、跨阶段路由、制作形态与 Dashboard。各阶段正文由对应 owner 完成。
 
 ## Quick Start
 
-先离线确认本技能被单独复制后仍能初始化、读取和保护项目路径：
+所有项目统一使用 [creator-first 工作流](references/creator-workflow.md)：每集按需维护
+`剧本.md`、`视觉设定.md`、`分镜.md`、`图片提示词.md`、`视频提示词.md`，不建立并行的结构化创作真相。
+具体写法见 [五份创作文档](references/creator-documents.md)。
 
-```bash
-python3 {技能目录}/scripts/selftest.py
-python3 {技能目录}/scripts/project_tool.py init ./my-drama --title "示例短剧"
-```
-
-创作者可读内容使用 `short-drama.json#/language`；交给图片或视频生成器的提示词正文使用
-`#/format/prompt_language`。两者互不推断，详见
-[contract-and-ownership.md](references/contract-and-ownership.md#output-language-contract)。
-
-## 每次请求的起点
-
-1. 使用用户给出的路径，或从当前目录向上寻找最近的 `short-drama.json`。
-2. 运行 `status`，只读完成当前任务所需的直接输入，不批量加载整个项目。
-3. 按用户眼下要完成的工作路由；未安装的阶段技能只影响对应路由，不阻断其他工作。
-4. 明确的单阶段任务直接交给独立安装的对应技能，按创作者要的那一步做。
-
-统一预检见 [runtime-preflight.md](references/runtime-preflight.md)，创作入口见
-[creator-workflow.md](references/creator-workflow.md)，所有权见
-[contract-and-ownership.md](references/contract-and-ownership.md)。
-
-## 意图路由
+## 路由
 
-| 创作者意图 | 路由 |
+| 用户要做什么 | owner / 行为 |
 |---|---|
-| 开发点子、系列承诺、改编和分集地图 | `$short-drama-develop` |
-| 导入已有多集完整剧本/散稿并生成或补分集地图 | `$short-drama-develop` 按文件实际结构建立索引，每次只读当前集并续跑 |
-| 判断长篇是否值得改、建立原文索引 | `$short-drama-novel-analyze` |
-| 写或改单集契约、节拍、剧本 | `$short-drama-write` |
-| 拆人物、造型、地点、道具和状态 | `$short-drama-assets` |
-| 写人物、地点、道具和 Look Development 图片提示词 | `$short-drama-image-prompts` |
-| 做覆盖设计、镜头和冻结关键帧 | `$short-drama-storyboard` |
-| 写动作、表演、运镜、声音视频提示词 | `$short-drama-video-prompts` |
-| 写主题曲/配乐意图或校验时间线音乐规格 | `$short-drama-video-prompts`，歌词必须由创作者提供并接受 |
-| 按已确认规格实际生成图片、视频、TTS 或时间线音乐 | `$short-drama-produce` 先展示本次 job，得到明确确认后才执行 |
-| 定制作形态、视觉方向或 Look Development 路径 | `$short-drama` |
-| 校验、审稿或发修订请求 | `$short-drama-review` |
-| 打开创作台、看内容和进度 | `$short-drama dashboard` |
+| 开发点子、系列承诺、改编和分集地图 | `$short-drama-develop`，仅在用户需要时 |
+| 已有多集完整剧本/散稿识别分集 | `$short-drama-develop` 按实际边界建立临时索引 |
+| 分析长篇原著 | `$short-drama-novel-analyze`，仅在用户需要时 |
+| 写或改单集剧本 | `$short-drama-write` → `剧本.md` |
+| 拆人物、造型、地点、道具 | `$short-drama-assets` → `视觉设定.md` |
+| 写资产图片提示词 | `$short-drama-image-prompts` → `图片提示词.md` |
+| 做镜头和冻结关键帧 | `$short-drama-storyboard` → `分镜.md` |
+| 写视频/时间线音乐提示词 | `$short-drama-video-prompts` → `视频提示词.md` |
+| 实际生成媒体 | `$short-drama-produce`，先预览，再显式确认，最后运行 |
+| 审稿或校验 | `$short-drama-review`，仅在用户点名时 |
+| 初始化、Dashboard、归档点名文档 | 本技能 |
 
-用户的明确意图优先。Look Development 是可选分支；资产图片提示词和分镜在资产确认后可以
-并行，不互相等待。需要把已接受的视觉方向变成可比较的代表帧时，读
-[look-development.md](references/look-development.md)。
+`项目开发/` 中的长材料分析与分集索引是可选分析工作区，不参与单集布局判定；写任何一集仍只维护
+该集的五份 creator-first Markdown。
 
-**产物可以直接入场**。 上游的可选环节缺失不构成阻塞：现成剧本可直接进入资产；已接受资产
-可直接进入资产图片提示词；已接受剧本加资产可直接进入分镜；已接受镜头与关键帧可直接进入
-视频提示词。只补建对应技能拥有的、确实缺少的必要产物，绝不倒补虚构的创作简报或系列大纲。
+现成剧本可直接拆资产；已有视觉事实可直接写图片提示词或分镜；已有分镜可直接写视频提示词。
+不要为补齐名义流水线伪造上游。
 
-**请求含糊时不要追问技术细节**。 遇到"帮我把这集做完"这类请求，先展示当前的创作者可读
-状态，再给出不超过三个有意义的动作，优先能解开当前交付阻塞的那个；不要拿 schema、事务或
-存储格式去问创作者。
+## 执行请求
 
-## 有界续跑
+1. 找到用户给出的项目或资料，只读当前任务的直接输入。
+2. 把用户点名的完整范围交给相应 owner；批次只控制上下文，自动续跑。
+3. 只有真实创作分叉才询问；不要拿 schema、目录、事务或检查器询问创作者。
+4. 范围完成后一次回报完成内容、关键决定、真实未决项和可选下一步。
+5. 不自动开始用户没点名的审查、归档或生产。
 
-全链预览或“继续”每轮只授权一个 owner 的一个有界工作单元。写作、资产、图片提示词、分镜和
-视频提示词按各自「每轮的工作单元」分批工作；完成当前批次后报告已覆盖范围、剩余范围与
-下一步，并把控制权交还创作者。下一阶段、审查和生产各自需要明确的后续请求；生产还要先展示
-准确 job 并取得确认。
+## 初始化与 Dashboard
 
-审查尽量交给没有参与该版本创作的 reviewer，以减少自证偏差；运行环境不支持隔离上下文时，
-如实标注为自检即可。CLI 只记录 verdict、reviewer 标签和备注，不收集或伪造上下文证明。
-Reviewer 给出证据和修改请求，内容仍由原 owner 修改。
+需要项目配置时运行：
 
-## 初始化
-
-没有项目且用户要初始化时：
+```bash
+python3 {技能目录}/scripts/project_tool.py init ./my-drama --title "示例短剧"
+```
 
-1. 确定标题、项目语言、提示词语言、画幅和路径；集数或时长未知就留空。
-2. 运行 `init` 建立最小目录和空状态，不覆盖现有文件。
-3. 将制作形态与视觉方向保持为 `unset`，告诉创作者下一个最有用的选择。
-4. 创作者定下形态、方向、播放面或集长目标后，把这条决定发布并接受为一条创作者决策记录，
-   再用 `set-authority` 写回 `short-drama.json`，让下游读到已 `accepted` 的值。
+`init` 只建立配置和空目录；第一次创作时再把文档写入 `剧集/<EP>/`，不预建空文件。
+项目定位与安全写入见 [运行预检](references/runtime-preflight.md)。用户明确要求 Dashboard 时运行：
 
-初始化不自动生成故事、剧本或资产设定。
+```bash
+python3 {技能目录}/scripts/dashboard_server.py --workspace <workspace> --port 0 --open
+```
 
-## 本地 Dashboard
+Dashboard 展示和编辑创作文件，不负责工作流编排或媒体生产。
 
-Dashboard 是项目内容的轻量展示与有限文本编辑层，核心能力仍在各 skill 中。当用户调用
-`$short-drama dashboard` 时：
+## 项目级创作决定
 
-1. 项目存在时读取 `status`；浏览普通目录时直接使用该目录。
-2. 项目内启动时用项目根作为 workspace；否则使用用户给出的容器目录或当前目录。
-3. 从本技能安装目录运行：
+制作形态、视觉方向、播放面和集长目标确实约束多个阶段时，展示选择及影响后由用户决定。
+Look Development 是可选分支，不是进入图片提示词或分镜的固定门槛。
 
-   ```text
-   python3 <short-drama-skill-dir>/scripts/dashboard_server.py --workspace <workspace> --port 0 --open
-   ```
+按问题只读取一份相关知识：
 
-4. 回报脚本打印的完整回环地址与停止方式，并保持进程运行。
+- 规则分级与 owner 路由：[规则与路由索引](references/knowhow-index.md)
+- 输出语言、稳定 ID、所有权与安全边界：[契约与所有权](references/contract-and-ownership.md)
+- 实拍、二维、三维、水墨、Q 版、国漫的形态差异：[制作形态](references/production-form-profiles.md)
+- 需要比较代表帧时：[Look Development](references/look-development.md)
+- 参考图能控制什么：[参考角色](references/reference-roles.md)
+- 遮挡、延迟揭示和观众知情时机：[观众揭示](references/audience-reveal.md)
+- 母版、补拍和替代版的职责：[补拍与替代](references/pickup-and-alternate.md)
 
-Dashboard 只读取 workspace 内的文件；密钥、生产 adapter 与工作流编排都在它之外。它按项目
-和剧集展示正文、结构化卡片以及已有图片/音频/视频；保存只表示保存文件，不代表创作者确认。
-每次启动使用独立本机会话，项目 API 只接受该会话。参数与安全边界见
-[lifecycle-commands.md](references/lifecycle-commands.md#dashboard-启动)。
+## 生产与交付边界
 
-## 项目命令
+外部生产永远保留 `preview -> explicit confirm -> run`。归档只复制用户点名的当前文档和成品，排除
+私有输入、凭据、绝对路径与隐藏运行状态；不为归档补造审批、哈希或第二套内容。
 
-从本技能安装目录调用 `scripts/project_tool.py`：
+## 安装维护
 
-| 命令 | 用途 |
-|---|---|
-| `init` | 初始化最小项目 |
-| `status` | 显示项目与产物状态 |
-| `publish` | 原子发布一项产物并记录它的直接输入 |
-| `accept` | 记录创作者接受或拒绝当前版本 |
-| `review` | 记录当前版本的复核结论 |
-| `set-authority` | 把已接受的创作者决策写回制作形态、视觉方向、播放面或集长目标 |
-| `package` | 打包当前已确认且复核通过的文本/JSON |
-| `verify` | 用交付校验和检查打包结果是否被改动 |
-
-完整示例见 [lifecycle-commands.md](references/lifecycle-commands.md)。单文件发布用临时文件与
-原子替换完成。
-
-## 状态与修订
-
-对创作者只使用六种状态：
-
-- `draft`：尚未发布；
-- `needs_confirmation`：等待创作者决定；
-- `accepted`：创作者已接受；
-- `revise`：创作者或 reviewer 要求修改；
-- `approved`：当前版本已确认且复核通过；
-- `update_needed`：输出或某个直接输入已经变化，需要重新发布。
-
-状态在读取时核对当前文件，不把过期传播写回整个项目。修订时只说明负责技能、语义变化、
-直接受影响的产物和下一步；重新发布会清除该产物旧的接受与复核结果，不触碰无关产物。
-除非诊断需要，不向创作者显示内部 hash 或原始状态文件。
-
-## 交付
-
-先由 `$short-drama-review` 复核，再用 `package` 打包。包内只收录明确选择的、当前状态为
-`approved` 的文本和 JSON，并记录有意省略项；二进制媒体、非公开输入、机器状态、绝对路径、
-凭据和未批准草稿不进入文本交付包。`verify` 检查清单、校验和及未登记新增文件。
-
-## 边界
-
-- 图片、视频和 TTS 生产只由 `$short-drama-produce` 在展示准确 job 并取得本次明确确认后执行；
-  其他技能不直接调用生成服务。
-- 运行时不检索外部或非公开生产来源。
-- 不把别处案例提升为项目定律。
-- 语义冲突不静默修复；不明外部改动由创作者选择保留或重做。
+只有安装、升级或排障时运行 `python3 scripts/selftest.py`。

package/lib/drama/skills/short-drama/references/audience-reveal.md

@@ -1,74 +1,21 @@
 # 观众此刻可以知道什么
 
-背影、腿部入画、门缝、画外声、浅景深和遮挡不只是画面风格。它们同时决定观众**何时**
-知道一个人是谁、看见那张字条、或者发现门后有人。
+背影、门缝、画外声、浅景深和遮挡会决定观众何时知道一个人是谁、看见证据或发现门后有人。
+需要同时防两种错：该给的信息被漂亮构图挡住；不该给的信息被镜头提前泄露。
 
-这件事容易被当成构图偏好处理，于是出两种错，而且两种都不会被"这镜好看吗"抓到：
+## 一条事实一条判断
 
-- 本镜本来要交代证据，却被一个漂亮的遮挡挡住了——**该给的没给**；
-- 剧本只允许观众先看到鞋和停步位置，结果正脸提前露出来——**不该给的给了**。
+对每个有揭示时机的事实，在对应 `SHOT-...` 下写清：
 
-所以每个镜头要按**事实**分开记录可见性，而不是给整镜写一句"稍后揭示"。
+- **事实来源**：来自哪个场景 ID、对白、动作或画面文字；
+- **本镜权限**：现在展示，还是暂时扣住；
+- **可见/可听载体**：观众具体能看到或听到什么；
+- **释放时机**：若暂时扣住，在哪个可见事件后释放；
+- **保护方法**：靠遮挡、景深、画外声、光线或构图怎样实现；
+- **戏剧理由**：为什么这个时机改变理解或压力。
 
-## 一条记录只管一个事实
+同一镜头里“来者认识主角”和“来者是谁”是两件事：可以让旧称呼先从画外传来，同时让来者的脸
+留在暗处。揉成一句“稍后揭示”，下游就无法分别处理声音和身份。
 
-这些记录写在镜头的 `audience_visibility[]` 里（字段属于 storyboard 的 shot 记录）。
-
-同一个镜头里，"这人是谁"和"他手里有什么"是两件独立的事，可以有完全不同的揭示条件。
-揉成一句，下游就只能一起放或一起收——所以 `audience_visibility` **按事实分条**，
-不是每镜一条。
-
-每条记录写清五项：
-
-| 字段 | 回答什么 |
-|---|---|
-| `fact` | 这条管的是哪一个具体事实 |
-| `source_ref` | 这个揭示义务来自剧本的哪一段 |
-| `permission` | 现在就给（`show_now`）还是先扣住（`withhold_now`） |
-| `carrier` | 观众此刻能看见或听见的是什么 |
-| `reveal_trigger` / `protection_method` / `rationale` | 什么时候放、靠什么扣住、为什么 |
-
-### 合成示例
-
-一个镜头里，观众要听见有人叫出主角的旧称呼（说明来者认识他），但**不能**看到来者的脸。
-
-`audience_visibility` 所在的 `shots.jsonl` 在第一行声明本文件引用到的上游快照：
-
-```json
-{"record_type":"sources","schema_version":"1.0.0","sources":{"screenplay":{"owner":"short-drama-write","artifact":"剧集/EP001/screenplay.md"}}}
-```
-
-数组里每条只写快照键和记录 ID：
-
-```json
-[
-  {
-    "fact": "来者认识主角的旧身份",
-    "source_ref": {"src": "screenplay", "record_id": "BLK-EP001-SC003-A02"},
-    "permission": "show_now",
-    "carrier": "画外一声旧称呼，主角闻声停手",
-    "reveal_trigger": "对方开口",
-    "rationale": "本镜必须让观众意识到主角被认出来了"
-  },
-  {
-    "fact": "来者是谁",
-    "source_ref": {"src": "screenplay", "record_id": "BLK-EP001-SC003-A05"},
-    "permission": "withhold_now",
-    "carrier": "只有门框边的一只手和影子",
-    "protection_method": "来者留在景深之外，不进正面光",
-    "reveal_trigger": "下一场推门进屋时",
-    "rationale": "身份揭示是场末的转折，提前露脸会让那一下失效"
-  }
-]
-```
-
-两条各有各的条件：**声音放，脸扣住**。写成一条就做不到这件事。
-
-## 不是"神秘感越多越好"
-
-扣住信息本身没有价值，它只在为后面某个具体时刻服务时才有价值。所以
-`withhold_now` 必须写出 `reveal_trigger`——说不出什么时候放，就说明这不是设计，
-只是没想清楚。
-
-审查时同时核对两侧：原文此刻**允许**透露什么，以及本镜**必须**传达什么。
-只评价构图是否漂亮的审查，抓不到这类缺陷。
+扣住信息本身没有价值；说不出何时释放，就说明还没完成设计。审查时同时核对原文此刻允许透露什么，
+以及本镜必须让观众明白什么。

package/lib/drama/skills/short-drama/references/contract-and-ownership.md

@@ -1,94 +1,40 @@
-# Contract And Ownership
+# 契约与所有权
 
-## Contents
-
-1. Project flow
-2. Runtime path ownership
-3. Output language contract
-4. Stable identities and references
-5. Rule classes
-6. Trust and file safety
-
-## Project flow
+## 工作流不是瀑布
 
 ```text
-development? -> screenplay -> assets -> image prompts
-                         \-> storyboard -> video prompts
-                         \-> confirmed production -> review -> delivery
+开发? -> 剧本 -> 视觉设定 -> 图片提示词
+                    \-> 分镜 -> 视频提示词
+                    \-> 明确确认后的媒体生产
 ```
 
-This is a routing map, not a mandatory waterfall. Direct entry is valid, and Look Development is optional.
-Each artifact records only the project files it directly read. There is no recursive stale-propagation graph.
-
-## Runtime path ownership
-
-`project_tool.py` does not contain a registry mapping business paths to skill names. The first published artifact
-claims its output paths in project state, and another artifact cannot silently overwrite those paths. Input,
-delivery and machine-state roots remain protected regardless of owner name.
+可以从任一已有材料直接进入；Look Development 和审查都按需发生。每个 owner 只修改自己的 Markdown，
+引用上游可见事实，但不静默改写它们。
 
-Each skill's own stage contract describes its semantic responsibility. An artifact may project another artifact's
-facts but may not silently redefine them. A reviewer requests changes; the responsible skill edits its source.
+## 输出语言
 
-## Output language contract
-
-| Field | Governs | Default |
+| 内容 | 有项目配置时 | 独立任务默认 |
 |---|---|---|
-| `short-drama.json#/language` | creator-facing artifacts, findings, status and Dashboard | `zh-CN` |
-| `short-drama.json#/format/prompt_language` | copyable image/video prompt bodies | `en` |
-
-Creator-facing prose follows `language`. Prompt bodies follow `prompt_language`. Depicted speech and on-screen text
-come from accepted story/asset facts, not from either description-language setting.
-
-## Stable identities and references
-
-Use stable IDs such as `EP001`, `SC001`, `BLK-...`, `CHAR-...`, `LOOK-...`, `LOC-...`, `PROP-...`,
-`SHOT-...`, `KEY-...` and `MOTION-...`. Display names may change without changing identity.
-
-For cross-artifact references, a file declares each upstream snapshot once, and every reference names that
-declaration plus the record it points at.
-
-A `.jsonl` file declares them on its first line:
-
-```json
-{"record_type":"sources","schema_version":"1.0.0","sources":{"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/EP001/screenplay-index.jsonl"}}}
-```
-
-A `.json` file uses a top-level `"sources"` object with the same entries. A reference is then:
-
-```json
-{"src": "screenplay-index", "record_id": "BLK-EP001-SC001-A01", "field": "/text"}
-```
+| 创作者可读说明与审查 | `short-drama.json#/language` | 用户当前语言 |
+| 图片、关键帧、视频的可复制正文 | `short-drama.json#/format/prompt_language` | `en` |
 
-`sources` keys are short, lowercase and derived from the artifact filename; each is unique and stable inside its
-file, and one artifact is declared under one key. `owner` and the project-relative `artifact` identify authority.
-`record_id` and `field` are optional selectors, and a reference pointing at a whole artifact keeps `src` alone.
-`authority` (`accepted` or `candidate`) belongs to the individual reference, because one snapshot can be read at
-different authority levels by different references. Do not copy whole authoritative values into consumers, and do
-not create self-references. A `sources` entry names the artifact the file was written against by `owner` and
-`artifact` only — no digest. Bytes are compared by the tool, in lifecycle state and delivery checksums, and that is not
-user-supplied lifecycle evidence and does not drive transitive invalidation.
+两种语言互相独立；画面中的对白和可读文字来自剧本/视觉事实，不由描述语言推断。
 
-## Rule classes
+## 稳定身份与引用
 
-- `structural_invariant`: locally provable; a script may block.
-- `reviewed_invariant`: semantic obligation; a reviewer may request revision.
-- `craft_default`: usually useful, but creator intent may override it.
-- `taste_option`: present alternatives; never block by itself.
+使用创作者可见的稳定 ID：`EP001-SC001`、`IMG-...`、`SHOT-...`、`MOTION-...`。显示名可以改变，
+身份不因此改变。跨文档引用直接写这些 ID；不写哈希、内部路径、隐藏状态或第二套 record ID。
 
-Word counts, shot counts, emotional curves and patterns seen elsewhere are not structural invariants unless the
-creator explicitly chose them as format constraints.
+## 规则分级
 
-## Trust and file safety
+- `structural_invariant`：本地可证明的引用、ID、算术或显式矛盾；
+- `reviewed_invariant`：需要结合语义证据判断的义务；
+- `craft_default`：通常有效，但创作者可以说明理由覆盖；
+- `taste_option`：表达选择，不能单独阻断。
 
-Deterministic suite scripts do not make outbound connections. Confirmed production may launch a project-external,
-locally configured adapter without a shell; that adapter owns any provider SDK/API access and reads credentials from
-its environment or system store. Released skills do not retrieve external or private production sources at runtime.
-Do not ship private identifiers, plot passages, prompt sentences, URLs, user data or credentials.
+字数、镜头数、情绪曲线和案例配方不是通用结构门槛。
 
-Creator input under `输入/` is immutable to publication commands. Machine state lives under `.short-drama/` and
-delivery under `交付/`; neither is an owner publication target. Text/JSON publication validates all sources before
-writing and replaces each target atomically under one project lock. A crash cannot expose a partially written file;
-rerun the command to continue. Unknown external edits are never silently overwritten.
+## 信任与文件安全
 
-Legacy v0.3 state remains readable. The next state-changing command rewrites only the compact artifact record; old
-transaction and propagation fields are not carried forward.
+普通创作不联网。实际媒体生产只允许项目外 adapter 读取环境凭据，并始终经过
+`preview -> explicit confirm -> run`。不要把私有输入、凭据、绝对路径或非公开观察写入可交付文档。

package/lib/drama/skills/short-drama/references/creator-documents.md

@@ -0,0 +1,79 @@
+# 五份创作文档
+
+这是一份建议格式，不是 schema。优先让人一眼读懂；只有跨文档引用和投产定位需要稳定 ID。
+
+## `剧本.md`
+
+- 一级标题必须以集号开头，例如 `# EP001 集名`。
+- 每场用 `## EP001-SC001 内 · 地点 · 时间/天气`（空间性质也可写 `外` 或 `内外`）。
+- 对白使用 `角色（可选表演提示）：台词`；画外音、画外对白、声音、可见文字、连续性和转场分别使用 `[VO]`、`[OS]`、`[SFX]`、`[画面文字]`、`[连续性]`、`[转场]`，不要把含冒号的动作叙述误写成对白。
+- 不为每段台词生成 block ID，不另写节拍表、索引或录音表；用户明确需要时再做。
+
+## `视觉设定.md`
+
+按人物、造型、地点和道具分节。每项只写后续生成真正需要保持的识别锚点、当前状态与变化原因，
+不要抄剧情摘要，也不要把瞬时姿势或镜头角度升级成新资产。
+
+```markdown
+## 人物 · 江辰
+- 识别锚点：窄长眼、左眉尾旧疤、肩背略绷。
+- 本集造型：深灰旧西装，右袖口有雨水深痕。
+- 状态变化：EP001-SC003 后右手掌沾血。
+```
+
+## `分镜.md`
+
+每镜一个二级标题。镜头 ID 在本集内唯一并保持稳定；修订镜头内容时不要无故换 ID。
+
+```markdown
+## SHOT-EP001-001 · 门外停步
+- 来源：EP001-SC001
+- 时长：4s
+- 目的：先让观众看见他不敢进门，再揭示门内争吵。
+- 景别/机位：中近景，门框外侧，轻微低机位。
+- 起点：江辰右手悬在门把上方。
+- 终点：手收回，门内传来玻璃落地声。
+- 参考：IMG-JIANGCHEN-SHEET；IMG-OLD-DOOR；IMG-CORRIDOR-NIGHT。
+
+### 冻结关键帧提示词
+> 按项目提示词语言编写的冻结瞬间正文……
+```
+
+只写有镜头职责的镜头。关键帧提示词必须与该镜“起点”一致；终点才出现的文字、动作或状态不得
+提前进入静帧，也不要把整段动作塞进静帧。
+
+## `图片提示词.md`
+
+每项一个可投产的角色板、场景板、道具板或状态图。标题使用 `IMG-...` ID；正文放在
+`### 可复制提示词` 的引用块里，前面只保留用途和参考约束。
+
+```markdown
+## IMG-JIANGCHEN-SHEET · 江辰角色板
+- 用途：锁定身份、体态和本集造型。
+- 参考：无；若有参考图，只说明它控制什么。
+
+### 可复制提示词
+> 按项目提示词语言编写的正文……
+```
+
+## `视频提示词.md`
+
+与分镜一一对应时沿用镜头号并使用 `MOTION-...` ID。正文只描述从已确认起点到终点的变化，
+不重复静帧已经锁定的外观。
+
+```markdown
+## MOTION-EP001-001 · 门外停步
+- 分镜：SHOT-EP001-001
+- 时长：4s
+- 起始帧：SHOT-EP001-001 的冻结关键帧
+- 终点：右手收回；门内玻璃落地；人物视线转向门缝。
+
+### 可复制提示词
+> 从右手悬停的已确认起始帧开始……
+```
+
+## 共通规则
+
+- 提示词正文必须可直接复制，不放占位符、流程备注或 QA 结论。
+- 引用使用文档里看得见的场景/镜头/提示词 ID；不写文件哈希和内部路径。
+- 用户没要求的字段不为“完整”而补造。

package/lib/drama/skills/short-drama/references/creator-workflow.md

@@ -1,82 +1,56 @@
-# Creator Workflow
+# Creator-first 工作流
 
-## Creator authority
+## 唯一落盘
 
-`short-drama.json#/creator_authority` stores accepted creator constraints, visual direction and production
-profile choices. A skill may draft choices, but only the creator or an explicitly authorized delegate can accept
-them. If nobody has decided, keep the artifact pending; do not infer acceptance from silence or from a request to
-preview the whole pipeline.
+每集按需维护五份创作者可读 Markdown：
 
-Use project-relative paths and stable record IDs when one artifact points to another. Human-facing records do not
-need lifecycle digests. Deterministic source indexes may still carry byte spans because their job
-is exact source extraction, not workflow state.
+| 阶段 | owner | 文件 |
+|---|---|---|
+| 剧本 | `short-drama-write` | `剧集/<EP>/剧本.md` |
+| 视觉资产 | `short-drama-assets` | `剧集/<EP>/视觉设定.md` |
+| 分镜与冻结关键帧 | `short-drama-storyboard` | `剧集/<EP>/分镜.md` |
+| 图片提示词 | `short-drama-image-prompts` | `剧集/<EP>/图片提示词.md` |
+| 视频提示词 | `short-drama-video-prompts` | `剧集/<EP>/视频提示词.md` |
 
-## Entry points
+没有内容时不预建空文件。一个请求只创建它实际需要的文档；从剧本、视觉设定、分镜或提示词任一
+阶段直接进入都合法，不为补齐名义流水线伪造上游。
 
-| Creator asks for | Owner | Minimum input |
-|---|---|---|
-| Develop an idea or episode map | `short-drama-develop` | brief or conversation |
-| Analyze a long source | `short-drama-novel-analyze` | preserved source file |
-| Write or revise an episode | `short-drama-write` | idea, episode card, outline or script |
-| Extract assets | `short-drama-assets` | current script |
-| Create image prompt specs | `short-drama-image-prompts` | current asset facts |
-| Design shots/keyframes | `short-drama-storyboard` | current script and asset facts |
-| Create video prompt specs | `short-drama-video-prompts` | current shots/keyframes |
-| Produce images, video or TTS | `short-drama-produce` | current bounded job plus explicit confirmation after preview |
-| Review | `short-drama-review` | bounded artifact set |
-| Initialize, continue, show or deliver | `short-drama` | project path or target path |
-
-Direct entry is valid. Do not fabricate upstream files merely to make a nominal pipeline complete.
-
-## Branches
-
-```text
-direction / story development (when needed)
-              |
-           screenplay
-              |
-            assets
-          /        \
- image prompts   storyboard -> video prompts
-          \        /
-       confirmed production
-                |
-             review -> delivery
-```
-
-Look Development is optional. Image prompts and storyboard are sibling branches after asset facts exist.
-
-## Preview, confirmation and revision
-
-A request for an end-to-end preview authorizes drafting, not acceptance. Its runtime contract is **one bounded work unit per turn**:
-
-1. choose one owner stage; for a high-fanout stage, choose one explicit contiguous batch;
-2. read only that unit's direct inputs, draft or revise it, and run its local structural checks;
-3. persist a candidate without inventing creator acceptance;
-4. report the included scope, remaining scope and next useful action, then **return control to the creator**.
-
-The turn ends at step 4. A creator message such as “continue” authorizes the next bounded unit. The next owner
-stage, review and production each begin on their own explicit request; review also runs when an explicitly
-requested delivery needs a verdict. Undecided work stays in `needs_confirmation`, and delivery waits until the
-creator accepts the relevant outputs.
-
-For a revision:
-
-1. identify the artifact and owner;
-2. read only its direct current inputs;
-3. show the semantic change and what should remain unchanged;
-4. let the owner publish the revision;
-5. request creator acceptance when canonical meaning changed;
-6. report whether a separate bounded review is still needed; do not start it automatically.
-
-Changing an upstream file does not recursively rewrite project state. A consumer that directly recorded that file
-shows `update_needed`; republish the consumer when the creator actually wants it refreshed.
-
-Rendered prompt Markdown is a view of its structured spec. If someone edits the rendered view, either regenerate
-it, adopt the change into the spec, or reconcile both explicitly.
-
-## Delivery boundary
-
-Deliver only explicitly selected, current, approved text and JSON in the text package. Produced media remains in
-its project production directory and may be exported by a separate creator-approved media handoff. Exclude private
-sources, credentials, absolute paths and machine state. `verify` checks checksums; it does not judge creative quality.
+单集创作主链不落盘 JSON/JSONL、索引、指纹、覆盖表、QA 报告、审核表、交接胶囊或恢复状态。
+需要 ID 时写进 Markdown 标题；结构检查和批次状态留在本轮上下文，不成为第六份创作文档。建议
+写法见 [五份创作文档](creator-documents.md)。
+
+长篇原著拆解或多集材料识别可以在 `项目开发/` 使用机器索引；它们是用户点名时才建立的可选分析
+工作区，不是单集创作真相。其存在不会改变 `剧集/<EP>/` 的五文档布局，也不能要求单集 owner
+补造并行结构化产物。
+
+创作者说明跟随项目语言。图片、关键帧和视频的可复制正文跟随 `prompt_language`；没有
+`short-drama.json` 时默认使用 `en`，同一任务保持一致。两种语言互相独立，不能用一个推断另一个。
+
+## 请求范围
+
+用户点名的范围就是本轮范围。“写完这一集”完成整集；“从剧本做到视频提示词”依次完成所点名
+阶段。场次、资产组和镜头组只是内部上下文批次，通过后自动继续，不逐批交还控制权，也不为每个
+中间文件另开接受、审查或 QA 回合。
+
+只在三处停下：
+
+1. 点名范围已经完成；
+2. 缺失事实形成会显著改变剧情或视觉方向的真实创作分叉；
+3. 下一步会调用外部生产，必须先展示精确 job 并取得显式确认。
+
+结构检查服务于发现错误，不是创作门禁。能在当前文档直接修正的问题直接修正；审查、归档和媒体
+生产只有用户点名时开始。安装 selftest、全量 QA 和 demo 验证属于技能维护，不属于普通创作请求。
+
+## 创作质量
+
+简化文件数量不等于降低内容标准。各 owner 按具体问题读取自己的 craft references，检查剧情因果、
+人物声音、资产身份、空间连续性、镜头职责、可生成性和提示词边界。规则与路由总表见
+[knowhow-index.md](knowhow-index.md)。最终回报只说明已完成范围、关键创作决定、真实未决问题和可选
+下一步，不汇报内部流水线噪音。
+
+## 生产边界
+
+图片、视频、TTS 和音乐生产仍遵守 `preview -> explicit confirm -> run`。生产工具可以在隐藏运行目录
+保存 job、确认和审计记录；这些是付费/外部副作用的必要边界，不要求模型把创作内容再抄成长期
+JSON/JSONL。job 必须把拥有当前提示词的 Markdown 写入 `source`，输出写到
+`剧集/<EP>/制作成果/`；任何提示词、参数、输入或输出路径变化都需要重新预览和确认。