# teacher-fields.md

这个文件用于说明 `__teacher__.json` 的字段结构、分类规则、编号规则，以及教师侧固定标签的使用方法。

---

## 一、用途

`__teacher__.json` 不给学生看。

它主要服务于：
- 课程筛选
- 教师判断
- 上课引导
- 模板归档
- 模板索引

所以这里的字段重点不是“学生要看到什么”，而是“老师怎么判断这个任务”。

---

## 二、命名规则

建议使用：

`任务类别 + 三位编号 + 任务名称`

例如：
- `a100_给依然老师设计一个AI画像`
- `b203_做一个介绍页面`
- `c305_优化一个信息页`

说明：
- 任务类别使用 A、B、C
- 文件夹命名时转成小写 a、b、c
- 任务编号固定为三位数字
- 编号范围固定为 `100 ~ 999`
- 每个类别单独编号，并且按顺序往后排
- 也就是说：A 类从 `a100` 开始，B 类从 `b100` 开始，C 类从 `c100` 开始
- 同一类别新增模板时，按 `100、101、102 ...` 这样继续往后加

补充约定：
- 上面这套命名规则用于**已经正式入库、已经分配编号**的模板
- 如果当前还在新增模板阶段，还没有正式分配编号，那么 `__teacher__.json` 里的 `任务编号` 可以先留空
- 只有在修改、补全、续改一个已有模板时，才直接沿用原编号

---

## 三、任务类别（ABC）

ABC 不是按难度分。

而是按：
**这个任务在学习过程中，主要起什么作用。**

### A = 启动类
定位：让学生动起来

适合：
- 弱学生
- 卡住学生

特点：
- 门槛低
- 容易开始
- 很快看到结果
- 重点是先做出来

### B = 结构类
定位：开始搭东西

适合：
- 中间学生

特点：
- 强调结构
- 强调信息组织
- 强调完整框架

### C = 迭代类
定位：重点训练改

适合：
- 会做但不会改的人

特点：
- 强调修改
- 强调比较前后变化
- 强调优化能力

---

## 四、固定标签标准

__teacher__.json 中有两组固定标签：
- 主能力标签
- 任务类型标签

它们的作用不同，不要混用。

### 1）主能力标签是什么
主能力标签回答的是：
**这个任务主要在练哪种核心能力。**

它强调的是“训练目标”。

### 2）任务类型标签是什么
任务类型标签回答的是：
**这个任务最终做出来的作品，属于哪种任务形态。**

它强调的是“作品类型”。

---

## 五、主能力标签固定集合

主能力标签只能从下面 4 个里选 1 个：

### 第一能力：构思能力
适合：
- 重点在想主题
- 重点在想设定
- 重点在想内容方向

常见场景：
- 先想一个人物
- 先想一个故事
- 先想一个主题

### 第二能力：表达构建
适合：
- 重点在把内容组织出来
- 重点在把想法做成页面或作品
- 重点在图文表达、内容安排、结构搭建

常见场景：
- 做介绍页
- 做展示页
- 做图文页面

### 第三能力：问题判断
适合：
- 重点在发现问题
- 重点在判断哪里不合适
- 重点在比较优缺点

常见场景：
- 对比两个版本
- 找出页面问题
- 判断哪里需要调整

### 第四能力：迭代推进
适合：
- 重点在继续修改
- 重点在一版一版优化
- 重点在把已有作品改得更好

常见场景：
- 根据反馈继续改
- 优化排版
- 优化结构层次

---

## 六、任务类型标签固定集合

任务类型标签只能从下面 4 个里选 1 个：

### 1）游戏机制
适合：
- 作品重点是规则
- 作品重点是玩法
- 作品重点是互动机制

### 2）角色交互
适合：
- 作品重点是人物
- 作品重点是角色关系
- 作品重点是对话和互动

### 3）视听表达
适合：
- 作品重点是图像、文字、页面展示
- 作品重点是图文表达
- 作品重点是视觉呈现

### 4）改编优化
适合：
- 作品重点是修改已有内容
- 作品重点是优化旧版本
- 作品重点是重做和升级

---

## 七、怎么选标签

### 先选主能力标签
先看这个任务最主要练什么。

例如：
- 重点是先想内容，用 `1.构思能力`
- 重点是做成页面，用 `2.表达构建`
- 重点是找问题，用 `3.问题判断`
- 重点是继续优化，用 `4.迭代推进`

### 再选任务类型标签
再看这个任务做出来的作品属于什么。

例如：
- 做介绍页面，多半是 `视听表达`
- 做角色对话，多半是 `角色交互`
- 做玩法设计，多半是 `游戏机制`
- 做旧作品优化，多半是 `改编优化`

---

## 八、__teacher__.json 推荐结构

```json
{
  "任务类别": "",
  "任务编号": "",
  "任务名称": "",
  "主能力标签": "",
  "任务类型标签": "",
  "适合学生类型": [],
  "训练重点": [],
  "卡点和解决方案": [],
  "可拓展方向": [],
  "课后作业": []
}
```

---

## 九、字段说明

### 1）任务类别
只能填写：`A`、`B`、`C`

### 2）任务编号
- 如果是新增模板，默认留空字符串：`""`
- 如果是修改已有模板，填写原有三位编号字符串
- 范围固定为：`100 ~ 999`
- 例如：`100`、`203`、`305`

### 3）任务名称
用于表达这个任务具体要做什么。

### 4）主能力标签
- 只能选 1 个
- 固定集合：第一能力：构思能力 / 第二能力：表达构建 / 第三能力：问题判断 / 第四能力：迭代推进

### 5）任务类型标签
- 只能选 1 个
- 固定集合：游戏机制 / 角色交互 / 视听表达 / 改编优化

### 6）适合学生类型
用于说明更适合什么学生。

### 7）训练重点
用于说明这个任务主要练什么。

### 8）卡点和解决方案
用于说明老师预判到的常见问题，以及可用引导。

### 9）可拓展方向
用于说明后续还能往哪里继续做。

### 10）课后作业
用于说明课后还能延伸什么练习。
