SKILL.md

---
name: japanese-reading-grading
description: "日语朗读作业批改（双模式）。支持教师批量批改+学生自测打分，自动转写、N5-N1分层评分、发音纠错、成绩汇总、自适应升降级。兼容本地/Canvas环境，鼓励式评分。"
---

# 日语朗读作业批改（双模式通用版）
支持：**教师批改模式** / **学生自测模式**
适用：N5/N4/N3/N2/N1 日语学习者 | 音频格式：MP3/MP4/M4A/WAV

---

## 一、工作总流程
Step 1 → 加载标准文本 / 标准音频
Step 2 → 音频预处理 + Whisper medium 转写
Step 3 → 分层评分 + 鼓励式纠错
Step 4 → 生成个人评分报告
Step 5 → 教师模式：生成班级汇总
Step 6 → 学生模式：生成个性化练习建议

---

## 二、模式自动识别
- **教师模式**：输入=标准文本/音频 + 多名学生音频 + 姓名/学号
- **学生模式**：输入=个人音频 + 标准文本/音频 + 自选等级

---

## 三、音频处理流程（统一标准）
### Step 1：音频格式统一
- 转换为 WAV 格式
- 采样率 16000Hz、单声道
- 异常音频自动标记，不打低分

### Step 2：Whisper 语音转写（固定配置）
```bash
ffmpeg -y -i input.mp4 -vn -acodec pcm_s16le -ar 16000 -ac 1 audio.wav
whisper audio.wav --model medium --language ja --output_format txt
```
- 仅做转写，不做发音打分依据
- 转写存疑 → 标记人工复核，不扣分

---

## 四、评分规则（鼓励版 · N5-N1 分层）

### 4.1 基础分与总分规则

**基础分：10.0 分**

**计分公式：**
```
总分 = 10.0 - 累计扣分
约束：6.0 ≤ 总分 ≤ 10.0
```

**扣分上限：4.0 分**（超过不再扣）

---

### 4.2 错误类型与扣分值（仅3类）

| 错误类型 | 扣分 | 说明 |
|----------|------|------|
| 严重发音错误 | **-0.5** | 促音、长音、清浊混淆（三者任一出现） |
| 漏读/多读整句 | **-0.5** | 漏掉一整句 或 多读一整句 |
| 中途中断/长时间停顿 | **-0.5** | 朗读中途放弃，或停顿超过3秒 |

**重要规则：**
- 同一错误类型全篇**只扣一次**，不重复累计
- 上述3类错误若同时出现，累计扣分最多（最多 -1.5，但扣分上限为4.0）

---

### 4.3 各层级额外宽容规则

| 层级 | 宽容规则 |
|------|----------|
| **N5** | 声调轻微偏差、拨音偶尔读不到位、轻微卡顿（≤3处）→ **不扣分** |
| **N4** | 声调轻微偏差、轻微卡顿（≤2处）→ **不扣分** |
| **N3** | 轻微卡顿（≤1处）→ **不扣分** |
| **N2** | 无宽容项，按标准执行 |
| **N1** | 无宽容项，按标准执行 |

---

### 4.4 评分维度（用于报告展示）

| 维度 | 权重 | 说明 |
|------|------|------|
| 发音准确性 | 35% | 假名、清浊音、长音、促音、拨音 |
| 语调与节奏 | 30% | 句尾升降调、语句自然起伏 |
| 流畅度 | 35% | 连贯性、停顿、中断 |

**维度得分与总分关系：**
- 维度得分（发音/语调/流畅度）仅用于报告展示
- 最终总分以 4.1 公式为准（10.0 - 累计扣分）
- 两者可以不一致

---

### 4.5 等级划分

| 等级 | 分数区间 |
|------|----------|
| 优秀 | 8.0 ~ 10.0 |
| 良好 | 7.0 ~ 7.9 |
| 中等 | 6.0 ~ 6.9 |

---

## 五、纠错规则（鼓励导向）

### 5.1 篇幅定义
- 短篇：150字以内
- 长篇：150字以上

### 5.2 纠错上限（按水平+篇幅）

| 学生水平 | 短篇 | 长篇 |
|----------|------|------|
| N5 | 1项 | 2项 |
| N4 | 2项 | 3项 |
| N3 | 2项 | 3项 |
| N2 | 3项 | 4项 |
| N1 | 4项 | 5项 |

### 5.3 不扣分项目（全层级通用）
- は/わ、を/お 识别误差
- 句尾语气词、轻微拖音
- 同一错误只扣一次
- 同音词按假名判定
- 转写存疑、不确定是否为错误 → **不扣分**

---

## 六、两轮校验机制

- 第1轮、第2轮独立批改
- 不一致 → 取高分 + 宽松判定（优先不判为错误）
- 不确定 → 不判错

---

## 八、输出报告模板（统一格式）

```
学生姓名：{name}
等级：{level}

【评分结果】
总分：{score}/10
发音准确性：{p}/10
语调与节奏：{i}/10
流畅度：{f}/10

【总体评价】
{positive_comment}，{constructive_feedback}。{encouragement}

【发音纠错】
1. 原句：{original}
   你的读法：{student_reading}
   标准读法：{correct_reading}（{kana}）
   错误类型：{error_type}

【练习建议】
1. {suggestion_1}
2. {suggestion_2}
```

**排版规则：**
- 一级大项单独另起一行
- 禁用 ⚠ 等 emoji
- 评语 ≤ 1000 字符
- 先表扬后建议

---

## 九、双模式功能说明

### 教师模式（批量批改）
- 批量导入学生音频
- 自动评分 + 纠错
- 生成个人报告
- 生成班级成绩汇总
- 生成课堂讲评建议
- 支持升档推荐名单

### 学生模式（自测练习）
- 即时打分
- 精准纠错
- 个性化练习建议
- 自动记录薄弱点
- 支持等级自适应（N5↔N4↔N3↔N2↔N1）

---

## 十、核心原则

1. **鼓励为主**：从 10 分起评，据实扣分，不刻意压低
2. **只纠严重错误**：只纠正影响语义的明显发音错误
3. **同一错误只扣一次**：不重复扣分
4. **不确定时不判错**：转写存疑优先不判错
5. **保护信心**：总分不低于 6 分，评语先表扬后建议

---

## 十一、支持场景

- 课文朗读作业打分
- 日语发音测试
- 课堂小测批改
- 学生自主练习
- 单元复习测评
- 日语口语作业验收
```

---