# Character Scene Extractor

> Character Scene Extractor is an Agent Skill for documents published in the chatfire-AI/huobao-drama repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

角色和场景提取的规范与方法

- Skill name: `character-scene-extractor`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/chatfire-AI/huobao-drama/blob/HEAD/skills/extractor/SKILL.md
- Repository: chatfire-AI/huobao-drama (13,533 GitHub stars when collected)

## SKILL.md

# 角色与场景提取指南

## 角色提取规范

提取的角色信息包含：
- **姓名**：角色全名
- **角色定位**：主角/配角/龙套
- **外貌描写**：性别、年龄、体型、面部特征、发型、着装（300-500字）
- **性格特点**：核心性格标签
- **角色描述**：背景故事和关系

## 场景提取规范

提取的场景/背景信息包含：
- **地点**：具体场所名称
- **时间**：时间段和光线条件
- **氛围**：环境氛围描述
- **提示词**：用于AI图片生成的英文提示词（纯背景，不含人物）

## 道具提取规范

提取的道具信息包含：
- **名称**：道具名
- **类型**：日常/武器/交通/装饰等
- **描述**：外观和用途
- **图片提示词**：用于AI图片生成的英文提示词

## 使用步骤

1. 调用 `read_script_for_extraction` 读取当前集剧本
2. 调用 `read_existing_characters` 查看项目已有角色和当前集已关联角色
3. 调用 `read_existing_scenes` 查看项目已有场景和当前集已关联场景
4. 只提取当前集真实涉及的角色和场景
5. 调用 `save_dedup_characters` 保存角色并自动关联到当前集
6. 调用 `save_dedup_scenes` 保存场景并自动关联到当前集

## 当前集规则

- 目标是补齐“当前集”需要的角色和场景，不是重扫整个项目
- 若角色或场景已在项目中存在但当前集未关联，仍应复用并关联到当前集
- 若项目中已有同名角色或同地点同时间场景，优先复用，不要重复创建

---

Source: https://www.openparable.com/skill/documents/character-scene-extractor (OpenParable). Cite the canonical URL above.
