总门

---
name: ai-video-champion-handoff
description: name: ai-video-champion-handoff
---

---
name: ai-video-champion-handoff
description: AI 短剧五冠军的总控说明与统一交接契约。用户需要判断当前该用哪位冠军、五个冠军分别做什么、何时接手、交付什么，或需要在冠军之间交接项目、资产和连续性事实时使用；下级 Skill 只能在用户明确批准后调用。
---

# AI 短剧冠军 Skill 统一交接契约

这是一份共享数据契约，不负责写剧本、生成资产或调用模型。五个冠军 Skill 构成唯一正式生产链，必须读取并遵守本文件；稳定字段名保留为机器接口，用户可见标签必须使用中文。

## 四个权威交接对象

### `project_state`（项目状态）

每次交接都必须携带同一个对象，不得另起一套“当前状态”字段：

```yaml
project_state:
  project_id: "稳定项目编号"
  title: "项目名称"
  source_version: "剧本或上游材料版本"
  stage: "剧本|资产|拆镜|导演提示|生成|剪辑|交付"
  approved_gates: ["已确认的阶段"]
  decisions: ["创作者已拍板的事实"]
  blockers: ["阻塞项；没有则为空数组"]
  next_action: "唯一下一动作"
```

### `asset_manifest`（资产清单）

资产只能用稳定 `asset_id` 交接，禁止用文件名或聊天顺序代替：

```yaml
asset_manifest:
  - asset_id: "稳定资产编号"
    category: "角色|状态|场景|道具|参考图|音频|视频"
    name: "用户可读名称"
    version: "资产版本"
    source: "上传|念念画布生成|外部导入"
    status: "候选|待确认|已确认|淘汰"
    dependencies: ["依赖的 asset_id"]
    approved_by_user: false
```

### `continuity_ledger`（连续性台账）

只记录已确认事实；每条锁定必须能定位到场次或镜头：

```yaml
continuity_ledger:
  - lock_id: "稳定锁定编号"
    scope: "场次或镜头编号"
    characters: ["asset_id"]
    wardrobe_state: "服装、妆发、伤口、年龄状态"
    prop_state: "道具位置、朝向、损坏状态"
    spatial_state: "人物、镜头、地标的相对位置"
    lighting_state: "光源方向、色温、反差"
    camera_state: "轴线、焦段、运动方向"
    audio_state: "对白、环境声、音乐连续性"
    source: "用户确认|已验收片段|剧本事实"
```

### `accepted_clip`（已验收片段）

只有用户确认或质量门通过后才能写入；生成任务刚完成时仍是候选片段：

```yaml
accepted_clip:
  clip_id: "稳定片段编号"
  shot_id: "镜头编号"
  task_id: "念念画布任务编号"
  asset_id: "注册到资产库的视频资产编号"
  duration_seconds: 15
  status: "候选|已验收|返工|淘汰"
  acceptance_note: "验收结论"
  rejection_reason: "返工原因；已验收时为空"
  parent_clip_id: "替换片段编号；没有则为空"
  continuity_snapshot: "写入片段时的连续性台账版本"
```

### `canvas_group_contract`（念念画布分组与连接合同）

念念画布只允许使用系统默认的五个顶层分组：`分镜`、`角色`、`场景`、`道具`、`声音`。项目分类、集数、镜头组和视频段只能作为这五组下的子组，不得新建自定义顶层分组。

```yaml
canvas_group_contract:
  top_level_groups: ["分镜", "角色", "场景", "道具", "声音"]
  custom_top_level_groups: false
  shot_subgroups:
    - group_id: "分镜/第1集/镜头组1"
      shot_ids: ["镜头编号"]
      video_node_ids: ["视频节点编号"]
      referenced_assets:
        - asset_id: "稳定资产编号"
          role: "首帧|角色|场景|道具|声音|参考"
          source_group: "角色|场景|道具|声音"
          linked: true
```

角色、场景、道具和声音资产保留在各自默认分组；凡被视频生产消费的资产，必须同时挂接到对应的`分镜`子组，并与视频节点、镜头编号和参考职责建立可回读的连接。画布不支持多父级时使用连接关系或资产引用，不重复上传制造第二份资产。缺少任一必需连接时，生产节点保持未就绪，不得提交视频任务。

## 任务选人

| 用户现在要解决什么 | 该用的冠军 | 交付到哪里 |
|---|---|---|
| “这些小说、参考图、导演资料里哪些规则能用？” | `knowledge-card-skill` | `knowledge_brief`，交给后续冠军 |
| “把创意/小说变成能拍的剧本，或改人物、结构、对白。” | `screenwriter` | 剧本、故事圣经、`project_state` |
| “剧本定了，确定导演基调、人物长相和关键道具。” | `chaoge-assets-trial` | 创作基准、角色/道具和 `asset_manifest` |
| “按剧本和资产逐镜头拍，决定机位、走位和镜头节奏。” | `shotlist-builder` | `shotlist`、连续性草案 |
| “提示词效果不稳，角色表演、物理、镜头或连续性要修。” | `hell-grind` | 最终提示词、锁定后的 `continuity_ledger` |

不要为了“看起来完整”跳过上游：没有资料事实先用知识卡；没有可拍剧本先用编剧；没有已确认角色与关键道具不拆镜；没有拆镜事实不做提示质控。

## 五个 Skill 的职责边界与交接

| Skill | 只负责 | 必须读取 | 必须输出 |
|---|---|---|---|
| `knowledge-card-skill` | 按需检索用户提供的资料，形成有来源的知识简报 | 当前任务与已确认事实 | `knowledge_brief`；不改写项目、资产或连续性事实 |
| `screenwriter` | 故事、人物、场次、对白和可拍摄剧本 | `project_state`、适用的 `knowledge_brief` | 更新后的 `project_state`、剧本、故事圣经 |
| `chaoge-assets-trial` | 角色/状态/关键道具参考资产 | `project_state`、剧本 | 更新后的 `project_state`、`asset_manifest` |
| `shotlist-builder` | 场次拆镜、空间走位、镜头和视频提示计划 | `project_state`、剧本、`asset_manifest` | 更新后的 `project_state`、`shotlist`、待写入的 `continuity_ledger` |
| `hell-grind` | 表演微动作、镜头运动、物理与提示质量控制 | `project_state`、`shotlist`、`asset_manifest`、`continuity_ledger` | 更新后的 `project_state`、最终图像/视频提示、锁定后的 `continuity_ledger` |

生成和剪辑节点还必须读入 `continuity_ledger`，并在任务完成后产生候选 `accepted_clip`；未验收片段不得反向成为连续性事实。

## 统一交接规则

1. 不复制字段：下游只引用上游对象，更新时保留未改变字段。
2. 不静默猜测：缺少 `project_id`、`asset_id`、版本或用户确认状态时暂停并指出缺口。
3. 不越权生成：五个冠军只编译计划和提示；图片/视频必须提交到念念画布任务链，由服务器登记任务、状态和资产。
4. 不丢失失败信息：`blockers`、`rejection_reason` 和返工版本必须保留。
5. 用户看到的阶段名、按钮、表格列、交付说明全部用中文；`project_state` 等稳定机器字段、模型名、文件扩展名和代码标识不翻译。
6. 正式链路外的 15 个下级 Skill 均为 `approval_required`：在读取或调用任一项之前，先向用户说明具体 Skill、用途和本次原因，等待明确批准；不得由总路由自动分派。
7. 进入念念画布生成前，必须先验证 `canvas_group_contract`：只存在五个默认顶层分组、视频素材已归入分镜子组、视频节点与镜头及全部参考资产均已连接；否则停在画布准备门，不把“已上传”当作“已连接”。

## 完整链路

```text
剧本输入
→ knowledge-card-skill
→ screenwriter
→ chaoge-assets-trial
→ shotlist-builder
→ hell-grind
→ 念念画布图像/视频生成任务
→ 候选片段
→ 连续性与质量验收
→ accepted_clip
→ 剪辑、声音、字幕、导出与交付
```

---
name: ai-video-skill-route-index
description: name: ai-video-skill-route-index
---

---
name: ai-video-skill-route-index
description: 统一索引、审计和校验 AI 视频 Skill 路由。用于查询当前有效 Skill、冠军链路、上下游边界、使用证据、路由冲突、导出同步状态，或在修改 AI 视频路由前验证登记表。
---

# AI Video Skill Route Index

Use this Skill as the route registry, not as a content-production workflow. It does not write scripts, generate assets, or submit providers.

## Source of Truth

Read [references/route-registry.json](references/route-registry.json) before reporting or changing the AI video route. It owns each registered Skill's phase, trigger, output, direct-route status, champion-contract status, and known route warnings.

## Workflow

1. Run `scripts/validate_route_registry.py` before changing the router, champion handoff, project `AGENTS.md`, or export package. The validator also requires every official champion to retain a judgment card with trigger-specific value, required work, acceptance output, and common misuse; for open-ended original short dramas it blocks any route that regresses to asking the user for a one-line core premise before presenting complete candidates.
2. Select one active `direct_route` entry for a request, then add only the downstream entries declared in its record.
3. Treat `contract_only` entries as unavailable to the current total router until the registry warning is resolved.
4. Render the human-readable index with `scripts/render_knowledge_index.py <output-path>` after a registry change.

## Boundaries

- Do not silently promote a `contract_only` Skill into a direct route.
- Do not treat a file modification time as a production-use record; use the registry's `usage_records` only.
- Do not claim a known warning is resolved until the validator reports no warning for it.

## Resources

- [references/route-registry.json](references/route-registry.json): machine-readable route inventory and evidence summary.
- `scripts/validate_route_registry.py`: resolves paths, direct routes, category membership, and declared warnings.
- `scripts/render_knowledge_index.py`: produces the knowledge-base Markdown index.

---
name: ai-video-fundamentals-skill
description: name: ai-video-fundamentals-skill
---

---
name: ai-video-fundamentals-skill
description: AI 视频旧总路由兼容入口与审批门。用于识别五冠军正式链路之外的候选 Skill，并在调用任何下级 Skill 前向用户征询明确批准；不得自动分派或执行下级 Skill。
---

# AI视频基本功

这是 AI 视频的兼容入口和审批门，不再是自动分派器。先读取 `$ai-video-skill-route-index` 的 `references/route-registry.json`：只有 `knowledge-card-skill` -> `screenwriter` -> `chaoge-assets-trial` -> `shotlist-builder` -> `hell-grind` 是正式主链；其余 15 个下级 Skill 必须先获得用户对具体 Skill 的明确批准。

## 路由权限与调用门

1. 主链内的工作按冠军交接契约推进，不把下级 Skill 当作默认步骤。
2. 需要下级 Skill 时，先说明 `Skill 名称`、`本次用途`、`预期交付`，并等待用户明确批准；“继续”“做下去”等泛化指令不等同于批准某一项下级 Skill。
3. 未获批准时，只保留在当前冠军的交付边界内，或给出候选项；不得读取、调用或转交下级 Skill。

## 路由顺序

以下是用户批准相应下级 Skill 后才可使用的旧路由映射，不构成自动选择规则：

1. **来源分类**：从零小说创作、已有小说/大纲、纯文本剧本、已有视频转绘、原创创意、已有成片续接。
2. **交付分类**：可拍剧本、资产图提示词、首帧/故事板、视频提示词、真实生成、生成后诊断。
3. **方法层选择**：本技能负责总门；定稿剧本需要完整前半程导演分析、写实角色和关键道具资产时，优先走用户指定冠军 `chaoge-assets-trial`；从零写小说、续写或审查走 `ai-video-novel-creation-v1`，小说已经存在且要改成短剧走 `ai-video-novel-to-script`；原创新叙事资产先走 `ai-video-asset-prompts`，实际一键资产生产走 `ai-video-asset-production`；剧本镜头规划可叠加 `storyboard-director`。
4. **执行层选择**：Seedance 2.5 视频提示词由冠军 `hell-grind` 的“Seedance 2.5 交付编译”工作段输出；连续镜头/尾帧续接参考 `seedance2-narrative-shot-workflow`；已有视频转绘走 `mx-shortdrama-00-router`；人物资产转绘细节走 `mx-shortdrama-04-character-assets`；故事板资产走 `image2-storyboard-video`；原创无参考资产由 `ai-video-asset-production -> mikoto-gpt-image-2` 执行，参考图/编辑需求在 Mikoto 未提供验证合同前阻断。
5. **质量层选择**：故事/动作/表达审查用 `storyboard-director`；转绘生产与资产生命周期用 `mx-shortdrama-production-harness`；生成后问题用 `mx-shortdrama-production-iteration` 或对应渠道 QA。

## 批准后候选表

| 用户意图 | 主方法 | 必要下游 | 交付边界 |
|---|---|---|---|
| “定稿剧本做导演分析、角色和关键道具” | `chaoge-assets-trial` | 当前可用 Image 2 工具或外部平台提示词 | 用户指定冠军；只到关键道具，场景、分镜和视频生成回到本总路由 |
| “从零写小说/续写/审小说，再做AI视频” | `ai-video-novel-creation-v1` | 定稿后 `ai-video-novel-to-script` | 先完成小说事实、正文和审查，不直接跳资产或视频提示词 |
| “把小说改成短剧” | `ai-video-novel-to-script` | `storyboard-director`（需要镜头审查时） | 先交剧本与镜头事实，不直接跳生视频 |
| “剧本一键做人物/场景/道具图” | `ai-video-asset-prompts` | `ai-video-asset-production` -> `mikoto-gpt-image-2` | 清单、依赖、下载回执、QA、可复用资产引用 |
| “剧本做首帧/分镜板” | `storyboard-director` | `image2-storyboard-video` | 首帧和故事板是不同资产，不混为一谈 |
| “剧本写Seedance 2.5提示词” | `hell-grind` | `seedance2-narrative-shot-workflow`（连续镜头） | 先完成质控，再输出精确计时提示词；兼容入口 `sd2.5skill` 不独立执行 |
| “已有短剧转绘/本土化” | `mx-shortdrama-00-router` | Step01/02/04/05及其Harness | 原片证据是事实源，不能用自由创作替代 |
| “继续上一段视频” | `seedance2-narrative-shot-workflow` | `hell-grind` 或当前渠道 | 必须有已生成成片/尾帧和观察到的末状态 |
| “视频效果不好，重做” | `mx-shortdrama-production-iteration` | 当前执行渠道 | 先诊断最窄失败点，再只改一个变量 |

## 三个生产门

### 故事门

进入镜头或视频提示词前，至少确认：主角与目标、冲突/阻碍、触发事件、因果动作、结尾可见变化、开场钩子和结尾钩子。抽象心理必须转为表情、视线、身体、道具、光线或声音；没有可见变化就先回到剧本改写。

### 资产门

视频提示词需要的身份、空间和关键道具必须先声明资产职责：角色身份/服装状态、场景空间母板、剧情道具状态、首帧或故事板职责。资产图提示词不能把角色、场景、道具合成一张无边界大图；只有 `ai-video-asset-production` 登记为 `accepted` 的原图资产才可作为视频参考。

### 视频门

视频提示词必须明确输入模式（T2V/I2V/V2V/R2V/首尾帧/续接）、每个参考的职责、一个主动作及其终点、镜头与光线动机、对白/声音规则、文字控制和负面约束。连续片段先记录已发生状态、当前状态、不可改变锁和本段只允许发生的变化。

## 统一交接字段

不同子技能之间至少传递以下事实，不要求用户看到内部字段：

```text
project_scope：项目/集/场/镜头组
source_type：novel | script | redraw_video | original_idea | accepted_clip
deliverable：screenplay | asset_prompts | first_frame | storyboard | video_prompt | qa
characters：角色身份、年龄、辨识锚点、服装状态、声音状态
world：地点、时间、空间地标、光线方向、文化语境
props：道具外观、材质、文字、当前状态、允许变化
beats：触发 -> 动作 -> 结果 -> 反应，带时间顺序
continuity_locks：脸、发型、服装、空间轴线、道具、光线、末帧
reference_roles：每个@素材参考什么、不参考什么
next_gate：下一步最早需要通过的质量门
asset_manifest：asset_id、依赖、状态、参考职责、精确文件路径/SHA、下载回执和QA
```

## 关键原则

- 先事实后形容词；“电影感、明星感、真实”必须落成可见的脸、皮肤、材质、机位、光源、动作和声音。
- 先正向画面，再用一段聚焦的 `负面约束`；不堆无关禁止词。
- 提示词和真实生成是两件事。没有用户授权、当前渠道、成本和参考确认时，只交付提示词，不提交 Provider。
- 不把内部审查标签、证据ID、资产ID、历史路径塞进最终模型提示词；它们只用于交接和QA。
- 已有视频续接必须以实际成片末状态为准，不能用计划中的“应该结束状态”冒充。

## 输出契约

普通用户只需要结果时，先给：`路由`、`当前交付`、`下一步`。复杂项目再给完整路由包：来源判断、已通过的门、主方法、下游技能、资产/镜头/视频提示词清单、未验证项。用户要求“完整提示词”时，直接输出可复制正文，不额外塞入内部分析模板。

## 禁止越权

- 不用兼容入口 `sd2.5skill` 代替 `hell-grind`、小说改编、角色资产图或转绘证据分析。
- 不用 `ai-video-novel-creation-v1` 重新创作用户已定稿、只待短剧改编的小说，也不用它处理已有视频转绘。
- 不把 `prepared`、渠道URL、母图、故事板截图或旧同名文件当作已验收资产；视频参考只消费当前项目的 `accepted` 资产。
- 不用 `mx-shortdrama-00-router` 处理没有原片证据的原创小说，除非用户明确提供了转绘源视频。
- 不让 `chaoge-assets-trial` 接管其体验范围之外的场景、分镜、视频提示词或真实视频生成；这些请求返回本总路由继续分派。
- 不用故事板截图冒充最终角色卡或场景母板。
- 不因某个渠道成功返回HTTP状态就宣布资产或视频通过；必须有文件、视觉和连续性QA。