# Reference CSV 数据规范

本目录存放技能系统的结构化参考数据，所有 CSV 文件使用 **UTF-8 with BOM** 编码。

## 通用列（所有表共享）

| 列名 | 说明 | 示例 |
|------|------|------|
| `编号` | 唯一 ID，带表前缀 | `NR-001`、`SP-002`、`WT-003` |
| `适用技能` | 管道符分隔的技能名 | `write\|init\|plan` |
| `分类` | 分类标签 | `角色`、`战斗`、`叙事` |
| `层级` | `提醒` / `缺陷补偿` / `知识补充` | `缺陷补偿` |
| `关键词` | 逗号分隔的搜索词 | `角色命名,人名,玄幻命名` |
| `适用题材` | `全部` 或逗号分隔的题材名 | `玄幻,仙侠` |

## 编号前缀

| 前缀 | 表 |
|------|------|
| `NR-` | 命名规则 |
| `SP-` | 场景写法 |
| `WT-` | 写作技法 |

## 表专属列

### 命名规则.csv

| 列名 | 说明 |
|------|------|
| `命名对象` | 命名针对的对象类型（角色人名、书名等） |
| `规则` | 命名规则描述 |
| `正例` | 好的命名示例 |
| `反例` | 不好的命名示例 |

### 场景写法.csv

| 列名 | 说明 |
|------|------|
| `场景类型` | 场景分类（战斗场景、对话场景等） |
| `模式名称` | 写作模式名称 |
| `说明` | 模式详细说明 |
| `示例片段` | 正面写作示例 |
| `反面写法` | 反面写作示例 |

## 适用题材（番茄分类）

**男频:** 都市、玄幻、仙侠、奇幻、武侠、历史、军事、科幻、悬疑、游戏、体育、轻小说

**女频:** 现言、古言、幻言、悬疑、轻小说

## 检索方式

使用 `reference_search.py` 脚本进行检索：

```bash
python reference_search.py --skill write --query "角色命名" --genre 玄幻
python reference_search.py --skill write --table 命名规则 --query "战斗描写" --max-results 3
```
