tw-edu-feedback-writerlisted

# 學生回饋評語生成工具 ## 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 只存草稿，不自動發送 ``` ### 其他平台 輸出文字供手動複製。