---
name: business-knowledge-lookup
description: >
  在本地资料库 business_knowledge/ 中查找场景、角色、章节、资源等创作参考资料。
  用于撰写大纲或剧本前快速了解可调用的场景清单、角色设定、已有章节上下文。

  **触发场景：**
  (1) 撰写大纲/剧本前，需要了解可用场景和角色
  (2) 需要查询某个角色的性格、关系、对话风格
  (3) 需要查询某个章节的已有剧情和知识点
  (4) 需要查询可用的emoji或其他资源
---

# 资料库查询技能

## 概述
本技能用于在 `business_knowledge/` 目录中快速查找创作所需的参考资料。

⚠️ **资料库是动态增长的**——角色、场景、章节、资源文件会持续新增。每次查找时必须先探索当前目录结构，不可依赖记忆中的旧文件列表。

## 资料库根目录

```
business_knowledge/
├── characters/       # 角色库（持续新增）
├── chapters/         # 章节库（持续新增）
└── resources/        # 资源库（持续新增）
```

## 查找流程

### 通用原则：先探索，再读取

**每次查找都从目录探索开始**，不假设文件列表不变：
```bash
# 1. 查看顶层结构
ls business_knowledge/

# 2. 查看子目录内容
ls business_knowledge/characters/
ls business_knowledge/characters/main/
ls business_knowledge/characters/supporting/
ls business_knowledge/chapters/
ls business_knowledge/resources/
```

---

### 查找角色信息

1. **先读索引**：读取 `characters/README.md` 获取当前角色总览
2. **探索目录**：`ls characters/main/` 和 `ls characters/supporting/` 确认当前有哪些角色文件
3. **读取详情**：根据需要读取具体角色文件（如 `characters/main/Ben.md`）
4. 每个角色文件通常包含：基本信息、性格与行为、对话风格、关系

**目录约定：**
- `characters/main/` — 主要角色（家庭成员、核心同学、主角伙伴）
- `characters/supporting/` — 配角（老师、镇民、临时出场角色）
- 新角色可能随时被添加到任一目录

---

### 查找可用场景

1. **探索资源目录**：`ls resources/` 查看当前有哪些资源文件
2. **读取场景清单**：读取 `resources/` 下以 `scene_catalog` 开头的文件
3. 场景通常按区域分类，每个场景包含：场景名、描述、对应关卡等信息
4. 未来可能有多个Level的场景文件（如 `scene_catalog_L1.md`、`scene_catalog_L2.md`）

---

### 查找章节上下文

1. **探索章节目录**：
   ```bash
   ls chapters/                    # 查看有哪些Level
   ls chapters/Level1/             # 查看有哪些Season
   ls chapters/Level1/S1/          # 查看S1有哪些Unit
   ls chapters/Level1/S2/          # 查看S2有哪些Unit
   ```
2. **读取目标章节**：文件命名规则为 `{编号}_{名称}.md`
3. 每个章节文件通常包含：整体梗概、各Lesson的知识点/登场角色/故事梗概

---

### 查找资源（emoji等）

1. **探索资源目录**：`ls resources/`
2. 按需读取对应资源文件
3. 资源文件类型会持续扩充（emoji、场景、道具等）

---

## 典型使用场景

### 场景A：撰写大纲前的标准准备

当需要为某个Lesson撰写大纲时，按以下顺序查找：

1. **章节上下文** — 读取对应Unit文件，了解整体梗概和该Lesson的基本设定
2. **可用场景** — 读取场景清单，确认当前可用的场景
3. **角色信息** — 读取该Lesson涉及的角色文件，了解性格和对话风格
4. **可用资源** — 如需emoji等，查阅对应资源文件

### 场景B：快速查询特定角色

1. 在 `characters/README.md` 中确认角色存在及分类
2. 读取对应角色文件

### 场景C：确认前后剧情衔接

1. 读取当前Unit文件的整体梗概
2. 读取相邻Unit文件了解前后剧情

---

## 注意事项

- **动态增长**：文件随时可能新增，每次使用前务必重新探索目录
- **用户补充优先**：如果用户在对话中提供了新角色/场景信息，以用户提供的为准
- **不依赖缓存**：不要基于之前会话中看到的文件列表做假设，每次都重新 ls 确认
- **新目录可能出现**：`business_knowledge/` 下可能新增新的子目录（如道具库、音效库等），查找时先看顶层有什么
