# 本技能的专用模板目录

放在这里的模板**优先级高于**通用模板库 `Z_Skills\template\03-培训\`。

## 查找顺序

脚本每次找模板都是这个顺序，命中即停：

```
1. 本目录（专用）          Z_Skills\sp-02-safety-training\templates\
2. 通用模板库（兜底）      Z_Skills\template\03-培训\
```

同一个模板在两处都有 → 用本目录这份。
本目录没有 → 自动回落到通用库，不会报错。

## 文件怎么命名

必须跟通用库同名（基名一致），版本号可以不同：

| 表单 | 文件名 |
|---|---|
| 培训通知单 | `TPL-培训-培训通知单-v<版本>.docx` |
| 培训记录 + 效果评估表 | `TPL-培训-培训记录和效果评估表-v<版本>.docx` |
| 培训签到表 | `TPL-培训-培训签到表-v<版本>.docx` |

同名多版本并存时**自动取版本号最高的那个**，例如同时有 v1.0 和 v1.2，用 v1.2。
所以想回退到旧版，把新版挪走或降版本号即可。

## 想微调占位符时这么做

1. 从 `Z_Skills\template\03-培训\` 复制那份 `TPL-*.docx` 到本目录
2. 版本号往上加一位，例如 `-v1.0.docx` → `-v1.1.docx`
3. 用 Word 打开改占位符，改完保存
4. 通用库那份保持不动——它是干净底本，也是别的技能可能要用的

改完跟我说一声，我跑一次生成验证占位符能不能全部替换掉。

## 占位符规则

- 统一写成 `{{字段名}}`，双大括号，中间不要有空格
- 字段名用中文，见名知意
- 可用字段清单见 `../references/字段说明.md`
- **必须是双大括号 `{{}}`**。单大括号 `{我告诉你}` 脚本不认，会当成普通文字原样留在成品里
- **新增字段**要同步告诉我，否则会被静默填成空白（脚本会报 `⚠ 配置缺字段`）
- 删掉某个占位符没关系，那个位置就是空的

### 脚本会替你挡住这三种错

| 情况 | 表现 |
|---|---|
| 模板里一个 `{{}}` 都没有 | 直接拒绝生成，不会交出空表 |
| 模板里有 `{中文说明}` 单大括号 | 直接拒绝生成，并列出是哪几处 |
| 模板有占位符但配置里没这个字段 | 报 `⚠ 配置缺字段`，提醒会被填成空白 |

## 当前状态

| 表单 | 走哪份模板 |
|---|---|
| 培训通知单 | **专用**（你改过，培训地点改成了填写项） |
| 培训记录和效果评估表 | **专用**（你改过，主要内容要求 300 字左右） |
| 培训签到表 | 通用库 |
