# Creator Keyframe Prompts

> Creator 把 keyframes.json 翻译成关键帧 .md 文件（含视觉描述和图像生成提示词），落盘到 assets/keyframes/{ep}/。

- Skill: `wddxh/creator-keyframe-prompts` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add wddxh/creator-keyframe-prompts`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wddxh/creator-keyframe-prompts/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wddxh (https://skillmd.com/u/wddxh)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wddxh/creator-keyframe-prompts

---


## 输入

### 文件读取
- `story/episodes/$ARGUMENTS[0]/keyframes.json` — 必须读取（关键帧描述源）
- `story/episodes/$ARGUMENTS[0]/outline.md` — 必须读取（本集资产清单，验证 composition 中 `<>` 标签）
- `config.md` — 必须读取（语言、视频风格、目标图像模型）
- `assets/**/*.md` — Glob 列出现有资产文件路径（用于解析 composition 中 `<>` 标签到 .md 文件路径）
- `skills/creator-keyframe-prompts/rules.md` — 必须读取并严格遵循

### 动态参数（$ARGUMENTS）
- `$ARGUMENTS[0]` — 当前集数（如 `ep01`）
- `$ARGUMENTS[1]` — 模式（可选，`full` 或 `incremental`，缺省为 `full`）
- `$ARGUMENTS[2]` — 仅 `incremental` 模式：dirty 列表（空格分隔的 KF id，如 `KF-EP01-003 KF-EP01-005`）

## 职责描述

### 核心使命

把 keyframes.json 中每张关键帧的结构化描述（composition / scene / characters / props / shot_size / camera_position / lighting_tone / action / emotion）翻译成图像模型可消费的提示词，并落盘为独立 .md 文件到 `assets/keyframes/{集数}/{KF-id}.md`。下游消费者是 `creator-generate-images`（按集扫 .md 出图）和 `creator-image-dreamina`（吃 .md 直接出图）。**不修改 keyframes.json**——keyframes.json 是 director 的产物，本 skill 只读不写。

### 工作思路

1. **读 keyframes.json**，得到关键帧数组
2. **读 config**，确定目标图像模型、视频风格、语言
3. **Glob `assets/**/*.md`** 建立"资产名 → .md 路径"映射表（用于把 composition 中 `<张三>` 解析到 `assets/characters/张三.md`）
4. **增量模式**：仅处理 `$ARGUMENTS[2]` 列出的 KF id；全量模式：处理全部
5. **对每张关键帧**：
   a. 解析 composition 中所有 `<资产名>` 标签
   b. 校验每个资产名能在 Glob 出的资产清单中找到（找不到则报错——说明 director-keyframes 没正确登记资产清单）
   c. 整理 `## 引用资产` 区块：按 composition 中 `<>` 标签首次出现顺序枚举、去重，每条写 `- [资产名](从 keyframe .md 到资产 .md 的相对路径)`
   d. 写 .md 文件：拼接 composition + 镜头语言（shot_size + camera_position）+ lighting_tone + 视频风格 suffix → 形成 prompt（资产名以裸名字出现，不带 markdown 链接）
   e. 落盘到 `assets/keyframes/{集数}/{KF-id}.md`
6. **清理孤儿 .md**：full 模式扫描 `assets/keyframes/{集数}/` 中所有 .md，删除不在 keyframes.json 的；incremental 模式仅在 dirty 列表中的 id 不在 keyframes.json 时删对应 .md
7. **输出生成摘要**：成功 N 张、删除 N 张、失败 N 张

### 常见误区

- **改 keyframes.json** — 本 skill 只读 keyframes.json，不修改它；任何对描述的修订都是 director-keyframes 的职责 — 严格只读
- **prompt 写得过于自由** — 模型容易把 description 重写一遍；prompt 应该**忠实保留** description 中的所有视觉信息（角色位置/朝向/动作/光线/景别）— 翻译不是改写，结构化字段必须 1:1 反映到 prompt
- **资产引用断链** — composition 写了 `<某资产>` 但 assets/ 中找不到对应 .md — 报错并停止处理本帧（不影响其他帧），不要"自动创建"或"忽略"
- **自动切英文** — 模型本能切换 prompt 语言为英文 — 严格遵循 config.md 语言设置
- **风格漏注** — 写 prompt 时忘了加 config 的视频风格 suffix（"3D写实风"等）— 每条 prompt 末尾必须包含视频风格描述
- **增量模式越权** — 收到 dirty 列表后顺手处理列表外的 keyframe — 严格只处理 dirty 列表中的 id
- **prompt 正文写 markdown 链接** — 「图像生成提示词」段写成 `[张三](../../characters/张三.md)站在...`❌ — 引用关系**只**在 `## 引用资产` 区块声明；正文写裸名字 `张三站在...`✅
- **`## 引用资产` 区块漏写或顺序乱** — composition 写了 `<硬币>` 但 `## 引用资产` 没列；或顺序不是 composition 中首次出现顺序 — 按 composition 标签首次出现顺序枚举、去重，每个 `<资产名>` 都必须在区块里

## 规则参考

- `skills/creator-keyframe-prompts/rules.md` — 必须读取并严格遵循

## 输出

### 文件操作
- 使用 Write 创建/覆写 `assets/keyframes/{集数}/{KF-id}.md`（每张关键帧一个文件）
- 使用 Bash 删除孤儿 `assets/keyframes/{集数}/{KF-id}.md`（按上述清理规则）

### 返回内容
- 生成摘要 → 返回给调用方