Flatten skill category directory structure

2026-05-20 17:04:50 +08:00
parent 0dd552a6f7
commit 63f2baa4bd
354 changed files with 0 additions and 0 deletions
@@ -0,0 +1,90 @@
+# 关键物件图生成
+
+## 目标
+
+基于脚本中标注的关键物件，为需要跨镜头保持视觉一致的非人物元素生成统一参考图。
+
+## 物件类别
+
+- **道具**：武器、信物、乐器、书信等手持/随身物品
+- **载具**：马、车、船、摩托等交通工具
+- **场景地标**：反复出现的特定建筑、标志性场所、门牌等
+- **动物/宠物**：有辨识度的伴随动物
+
+## 流程
+
+### 1. 自动提取
+
+读取 `script.md` 中所有 `**关键物件：**` 字段，汇总并去重。列出在 **2 幕及以上** 重复出现的物件，附带每个物件的出场幕列表和外观描述摘要。
+
+### 2. 用户确认
+
+通过 `AskUserQuestion` 让用户确认/增删物件列表（选项：确认当前列表 / 我要增减物件）。
+
+如果最终列表为空（脚本中无跨镜头物件），通过 `AskUserQuestion` 确认后跳过此阶段。
+
+### 3. 生成参考图
+
+为每个物件生成 2～3 张候选图。宽高比根据物件类型选择：
+
+| 物件类型 | 宽高比 | 说明 |
+|----------|--------|------|
+| 道具/小物件 | **1:1** | 正方形，突出物件细节 |
+| 载具/动物 | **3:2** 横版 | 展示整体形态和比例 |
+| 场景地标 | **16:9** 宽屏 | 展示建筑/场所全貌 |
+
+使用 `all_in_one_image_generation`（model_name: `all_in_one_pro`）或 `nano_banana_image_generation`（model_name: `nano_banana_2`）生成候选图。提示词融合：物件外观描述（从 script.md 汇总）+ 美术风格关键词 + `art_style.md` 的 `风格JSON：` 内容（如在提示词末尾附加 `Art style: {JSON 内容}`）。
+
+### 4. 用户选图
+
+启动预览，展示物件卡片和候选图网格，用户为每个物件选定最终参考图。调用 MCP 工具 `preview_and_collect_feedback`：
+- **script**: `.opencode/skills/mv-creator/scripts/render_preview.py`
+- **args**: `[".mv/{song_name}/{theme}", "--type", "props", "--lang", "{lang}"]`
+- **feedback_path**: `.mv/{song_name}/{theme}/feedback.md`
+
+预览页面展示各物件信息卡片和候选图。
+每个物件默认选中第一张候选图作为兜底，用户点击图片切换选定。
+反馈处理逻辑同人设图阶段：
+- 以 `LGTM` 开头 → 将各物件的选定候选图复制为 `selected.jpg`，更新 `design.md`，进入下一阶段
+- 包含 `修改建议：` → 解析建议，调整 prompt 重新生成候选图，更新后重新校验和预览
+
+## 输出格式
+
+每个物件独立一个目录和设计文件。**严格按用户语言选择对应的 example 和字段名**（参见 SKILL.md「输出控制」和「Markdown 字段名中英对照表」）：
+- 中文用户：参考 `references/props-design-example.md`，字段用中文（`外观描述`、`叙事作用`、`生图设定`、`候选图`、`选定图`），内容用中文
+- 非中文用户：参考 `references/props-design-example-en.md`，字段用英文（`Appearance`、`Narrative Role`、`Image Settings`、`Candidates`、`Selected`），内容用对应语言
+
+关键要点：
+- 一级标题 `#` 用于物件名
+- 外观描述/Appearance 用列表逐项描述（类型、形态、颜色/材质、尺寸/比例、细节特征）
+- 生图设定/Image Settings 包含三个子字段：`提示词/Prompt`（英文）、`模型/Model`、`参考图/Reference`
+
+## 格式校验
+
+design.md 写入后，**必须**运行校验脚本：
+
+```bash
+# 校验单个物件
+python3 .opencode/skills/mv-creator/scripts/validate_props_design.py .mv/{song_name}/{theme}/props/{item_name}/design.md
+
+# 校验所有物件
+python3 .opencode/skills/mv-creator/scripts/validate_props_design.py .mv/{song_name}/{theme}/props/
+```
+
+校验规则：必需分区完整性、外观描述列表项、生图设定子字段、候选图非空且文件存在。
+
+- **通过** → 启动预览供用户选图
+- **未通过** → 由 LLM 根据校验错误信息自动修正，修复后重新校验
+
+## 文件存储
+
+**目录名规则**：`{item_name}` 统一使用英文小写 + 下划线（如 `guitar`、`pickup_truck`），不使用中文或显示名。该目录名是分镜阶段引用物件的唯一标识。
+
+```
+./.mv/{song_name}/{theme}/props/
+├── {item_name}/
+│   ├── design.md            # 物件设计说明
+│   ├── candidate_01.jpg     # 候选图
+│   ├── candidate_02.jpg
+│   └── selected.jpg         # 最终选定图（用户挑选）
+```