# references-add

## 用途

当 Skill 被部署到**非原始开发路径**时（即 Skill 根目录路径与原始项目路径不同），
所有用户在对话过程中新增的**流程定义、接口文档、创作知识、避坑规则**统一整理到此文件夹。

## 知识分类体系（V2.0）

基于短视频产品规划图的 **8 赛道 × 8 叙事形态**三级分类体系：

| 层级 | 维度 | 枚举值 |
|:---|:---|:---|
| L1 赛道 | 讲什么 | 剧情娱乐 / 泛生活 / 时尚美妆穿搭 / 知识科普 / 健康健身 / 汽车 / 游戏二次元 / 商业服务 |
| L2 内容形式（叙事形态） | 怎么拍 | F01剧情演绎 / F02Vlog纪实 / F03干货口播 / F04测评种草 / F05教程教学 / F06盘点解说 / F07纯视觉短片 / F08人物采访 |
| L3 细分垂类 | 具体方向 | 各赛道 × 形态下的细化分类（如：剧情娱乐×F01 → 都市情感/逆袭爽剧/温情正能量等） |

## 结构

```
references-add/
├── README.md                    ← 本说明
│
├── 创作流程/                     ← 新增的创作流程文件（步骤变更、新步骤等）
├── 接口调用/                     ← 新增的 API 接口定义与调用文档
│
├── 通用知识/                     ← 🔵 不限赛道和内容形式的通用创作方法论
│
├── 分赛道知识/                   ← 🟢 限定赛道 + 内容形式的知识
│   ├── 剧情娱乐/
│   │   ├── F01_剧情演绎/
│   │   ├── F02_Vlog纪实/
│   │   ├── F03_干货口播/
│   │   └── ... (8种叙事形态)
│   ├── 泛生活/
│   ├── 时尚美妆穿搭/
│   ├── 知识科普/
│   ├── 健康健身/
│   ├── 汽车/
│   ├── 游戏二次元/
│   └── 商业服务/
│
└── 铁律避坑规则/                 ← 🔴 创作中必须遵守的铁律和避坑指南
    ├── 通用/                     ← 不限赛道和内容形式的通用铁律
    └── 分赛道/                   ← 限定赛道 + 内容形式的铁律
        ├── 剧情娱乐/
        │   ├── F01_剧情演绎/
        │   └── ...
        └── ...
```

## 通用知识 vs 分赛道知识 — 判定标准

| 判定维度 | 通用知识 | 分赛道知识 |
|:---|:---|:---|
| 适用赛道 | 不限，所有赛道通用 | 限定 1 个赛道 |
| 适用内容形式 | 不限，所有叙事形态通用 | 限定 1 种叙事形态 |
| 案例来源 | 跨赛道/跨形态的共性提炼 | 单一赛道 × 形态的专属案例 |
| 反例 | 四柱子框架、SCQA叙事结构、完播率优化 | 「剧情娱乐×F01 情感短剧的情绪曲线设计」 |
| 归入目录 | `通用知识/` | `分赛道知识/{赛道}/{内容形式}/` |

## 铁律避坑规则

铁律 = 在创作流程中**必须执行**的强制规则（违反即召回），避坑 = 经验积累的**常见错误和应对**。

| 分类 | 归入 | 示例 |
|:---|:---|:---|
| 通用铁律 | `铁律避坑规则/通用/` | "第一句OS必须点题+带人" |
| 赛道级铁律 | `铁律避坑规则/分赛道/{赛道}/{内容形式}/` | "两性情感短剧不得使用对话流水账式OS" |

## 与 references/ 的关系

| 目录 | 定位 | 内容来源 | 修改策略 |
|:---:|------|------|------|
| `references/` | 原始标准库（内置） | Skill 开发时固化 | 不随部署变更 |
| `references-add/` | 动态增量库 | 用户对话中积累 | 随使用持续增长 |

## 引用优先级

创作流程执行时，按以下顺序**同时检索**：

```
references/（标准） + references-add/（增量） → 合并结果
```

两个目录的内容**取并集**：标准库内容优先，增量库作为补充。两处都存在时以 `references/` 为准（增量不覆盖标准）。

## 运行时加载规则（四大维度）

当 `references-add/` 目录存在且有内容时，以下四个维度均须**同时加载两个目录**：

| 维度 | 加载规则 |
|:---|:---|
| **创作流程** | 执行每个步骤前，同时检查 `references/创作流程/` 和 `references-add/创作流程/`。增量中的同名文件**补充合并**到标准流程（取并集） |
| **通用知识** | 检索时同时搜索 `references/知识库/` 和 `references-add/通用知识/`。通用知识不限赛道，作为基础方法论补充 |
| **分赛道知识** | 创作前先确定赛道+叙事形态，然后检索 `references-add/分赛道知识/{赛道}/{内容形式}/` 获取赛道专属方法论。与 `references/知识库/` 的通用方法论合并使用 |
| **接口调用** | 需要调用外部接口时，同时查阅 `references/接口调用/` 和 `references-add/接口调用/`。两个目录的接口定义**均可用** |
| **铁律避坑** | 创作完成前，**必须**检索 `铁律避坑规则/通用/` + `铁律避坑规则/分赛道/{当前赛道}/{当前内容形式}/`，逐条检查是否违反铁律 |