# Tw Edu Feedback Writer

> 為學生作業、作文、口頭報告、學習歷程撰寫專業回饋評語， 依評量規準生成正向具體的書面評語，支援批量處理。 當使用者提及「評語」「回饋意見」「作文批改」「學生評語」 「寫評語」「批改」「作業回饋」「學習回饋」時觸發。

- Skill: `fw1201/tw-edu-feedback-writer` (Agent Skill, multi-file: 12 files)
- Install (CLI): `npx skillmds@latest add fw1201/tw-edu-feedback-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fw1201/tw-edu-feedback-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: fw1201 (https://skillmd.com/u/fw1201)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fw1201/tw-edu-feedback-writer

---


# 學生回饋評語生成工具

## Step 0：讀取文件
- `references/feedback_principles.md`
- `/mnt/skills/public/docx/SKILL.md`


**概念對齊協議（必要前置步驟）：**
`../../shared/concept-alignment.md`
→ 在執行任何工作前，先完成概念對齊確認卡。


## Step 1：資訊收集
1. 評量任務類型（作文/作業/報告/學習歷程）？
2. 年級與科目？
3. 評量規準有哪些向度？
4. 學生表現描述（教師口述，Claude 整理成評語）？
5. 需要幾位學生的評語？

## Step 2：生成評語文件

```bash
python scripts/generate_feedback.py \
  --task "[任務名稱]" --subject "[科目]" --grade "[年級]" \
  --students "[學生1描述|學生2描述|...]" \
  --output "/mnt/user-data/outputs/學生評語.docx"
```

## 評語原則（三明治回饋法）
1. 肯定優點（具體說明做得好的地方）
2. 指出改進方向（具體、可操作的建議）
3. 鼓勵展望（給予信心與期待）

## 輸出格式
- 每位學生一個回饋區塊
- 含評量指標評等（優/良/可/需加強）
- 字數約 100-150 字/人
- 可輸出成 Word 表格便於逐一填入

---

## 年級適應 + 引導式收集（v2.0 更新）

### 年級偵測 + 語氣調整
| 學習階段 | 評語語氣 | 建議字數/人 |
|---------|---------|-----------|
| 國小 | 溫暖鼓勵，避免批評性語言 | 60-80 字 |
| 國中 | 平衡正向與建設性建議 | 80-120 字 |
| 高中 | 具體、有深度，連結學習目標 | 100-150 字 |

### 引導式收集（第一輪）
```
Q1: 「這是哪種任務的評語？（作文/報告/口頭/作業/其他）」
Q2: 「請描述每位學生的表現特點。
    （可批量：學生甲：___，學生乙：___）」
```

### 第二輪
```
Q3: 「用哪些評量向度？（未提供則依任務類型自動設定）」
```

---

## MCP 連接器（平台差異）

### Claude Code ／ Claude.ai（Pro/Team/Enterprise）

**Gmail MCP（若已連接）：**
```
用途：將個別學生評語草擬為家長信件並存入 Gmail 草稿
      適合需要「個別通知家長」的情境

流程：
  1. Claude 生成全班評語文件
  2. 詢問：「需要把個別評語轉成寄給家長的信嗎？
            請提供需要個別通知的學生家長 Email。」
  3. 若確認：批量建立 Gmail 草稿（每位家長一封）
  ⚠️ Claude 只存草稿，不自動發送
```

### 其他平台
輸出文字供手動複製。