关于 vietnamese-education-copy
面向越南教育、学术和 EdTech 内容创作者的写作技能,指导按教育场景选择语域,并遵循法定术语与儿童数据保护要求。还涵盖教学反馈设计和文案验证。
主要功能
- 01按对象和场景选择越南语语域
- 02核对法定评分与学历术语
- 03设计教学反馈和自适应提示
- 04遵循儿童数据保护要求
- 05运行文案验证脚本
适用场景
- 01撰写教师给学生的评语
- 02编写 EdTech 发音反馈和界面文案
- 03制作家长学习进度更新
- 04检查成绩单或学历相关文本
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ trussary/ vietnamese-language-skill --skill vietnamese-education-copy安装后在 Claude Code 中输入/vietnamese-education-copy确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/banned-phrases.mdcompliance.mddoc-registers.mdedtech-pedagogy.mdexamples.mdglossary.mdgrading-terminology.mdlocale-formatting.mdqa-checklist.mdregister-matrix.mdunicode-and-tone.mdscripts/rules_education.pyvalidate_copy.py详细介绍
越南语教育、学术与 EdTech 写作(vi-VN)
越南语教育写作常见的问题,是把一个层级森严、由法律规范、且对教学法要求敏感的体系,简化成一种笼统的语气。教师写给 9 岁儿童、EdTech AI 助手辅导发音、学校向家长发布通知,以及大学教务处面向成年学生,这些场景各有不同的语域、称谓和法律规则。
本技能涵盖教育、教学、学术和 EdTech 教学法写作。 通用开发者文档(PRD、RFC、API 文档)属于 vietnamese-tech-writing;商业补习中心和留学广告宣传活动属于 vietnamese-business-comms。
第 1 步 — 确定写作者、读者和教学背景
| 写作者 → 读者 | 语域 | 备注 |
|---|---|---|
| 教师 → 中学生(THCS/THPT) | edu-k12(em) | K-12 课堂默认语域 |
| 教师 → 小学生(tiểu học) | edu-k12-primary(con) | 根据学段设定,而非学生的实际年龄 |
| 学校 / 教师 → 家长(集体) | edu-parent(quý phụ huynh) | 联系簿、Zalo 群发通知、成绩单通知 |
| EdTech 吉祥物 / AI 辅导老师 → 学习者 | edu-k12 / edu-k12-primary(em / bạn nhỏ) | 鼓励型导师人设,成长型思维 |
| EdTech 仪表板 → 家长 | edu-parent(quý phụ huynh / anh/chị) | 每周学习分析,透明且可采取行动 |
| 大学 → 学生(行政文体) | edu-uni(不直接称呼) | 成绩单、教学大纲、注册 — 使用第三人称 sinh viên |
教师口吻中用 bạn 称呼学生,是该领域最常见的机器翻译痕迹。完整语域矩阵:references/register-matrix.md。教育语域与人设指南详见:references/doc-registers.md。
第 2 步 — 使用法定评分术语,而非听起来顺口的说法
越南的评分和学历术语由 Bộ GD&ĐT 部级通知规范:
- 中学(THCS/THPT),Thông tư 22/2021/TT-BGDĐT: 综合评价等级为
Tốt/Khá/Đạt/Chưa đạt。Học sinh Tiên tiến和综合等级Giỏi/Trung bình均已废止。 - 小学(tiểu học),Thông tư 27/2020/TT-BGDĐT: 日常评价采用定性等级:
Hoàn thành tốt/Hoàn thành/Cần cố gắng。Cần cải thiện是照译;法定用语是Cần cố gắng。 - 高等教育,Thông tư 08/2021/TT-BGDĐT: 学分为
tín chỉ,绝不可写作tín dụng。 GPA 使用越南语小数逗号(3,6/4,0),对应Xuất sắc/Giỏi/Khá。 - 文凭,Thông tư 21/2019/TT-BGDĐT: 文凭遗失后,只能
cấp bản sao từ sổ gốc(从原始登记簿签发副本),绝不能“重新签发原件”。
完整的部级通知术语表:references/grading-terminology.md。
步骤 3 — 应用学习科学与教育科技教学智能
生成交互式学习文案或 AI 反馈时:
- 教学提示(间隔重复与习惯循环): 以积极心理学的方式撰写提醒通知。提及具体主题(例如
âm tr/ch)和连续学习记录的延续,不要让用户感到羞愧或内疚。 - 诊断式发音反馈(夹心模型): 解读 GOP/ASR 声学评分时:
- 第 1 层: 赞扬付出的努力,并指出发音正确的音素。
- 第 2 层: 提供具体的音素级指导(例如调整音高/声调、调整声道气流)。
- 第 3 层: 以成长型思维给予鼓励。绝不要使用生硬的负面标签(
Sai rồi、Điểm của bạn là 30%)。
- 自适应评估与支架式教学(IRT 与 ZPD): 使用 3PL IRT($b, a, c$)调整问题难度,并提供 3 级渐隐提示(规则 $\rightarrow$ 关键词 $\rightarrow$ 更正),帮助学习者实现掌握式学习。
- 家长分析数据的转换: 将原始学习遥测数据转化为富有同理心、具有建设性的家长更新,并提供具体的家庭支持建议。
- 避免过度辩护(SDT): 学习者掌握某个主题后,应从外在的 XP 奖励转向以内在动机为导向的掌握挑战。
- 提供可操作的空状态: 绝不要直接显示
"Trạng thái trống"或"Không có dữ liệu",而应提供有帮助的行动号召。
完整框架和能力地图:references/edtech-pedagogy.md。
步骤 4 — 查阅教育科技词汇表并避免翻译腔
避免 15 个常见的翻译腔陷阱:nộp bài(不要用 đệ trình)、tổng quan(不要用 bảng táp-lô)、
xem tiến độ học tập(不要用 theo dấu sự tiến bộ)、bảng xếp hạng(不要用 bảng lãnh đạo)、học tập thông hiểu
(不要用 học tập làm chủ)、đánh giá quá trình(不要用 đánh giá định hình)、chuỗi học tập(不要用 vệt học tập)、
hỗ trợ từng bước(不要用 giàn giáo)。完整的 60 词词汇表:references/glossary.md。
步骤 5 — 核查法律合规性并保护儿童数据
- 未成年人双重同意(Nghị định 13/2023/NĐ-CP Điều 20): 收集 $\ge 7$ 岁儿童的数据,必须获得儿童本人和家长/监护人的经核实同意。
- 生物特征语音数据: GOP 评分完成后,必须自动清除音频录音。
- 广告最高级表述: 学校招生宣传必须遵守 Luật Quảng cáo(不得使用未经证实的
số 1、tốt nhất)。
完整的合规指南:references/compliance.md 和 references/banned-phrases.md。
步骤 6 — 验证、修正,然后发布
运行验证器,检查法律术语、翻译腔、空状态错误和编码缺陷:
python scripts/validate_copy.py hoc-ba.md --doctype secondary-report-card
python scripts/validate_copy.py so-lien-lac.md --doctype primary-report-card --register edu-parent
python scripts/validate_copy.py nhan-xet.md --doctype teacher-to-student --register edu-k12
python scripts/validate_copy.py phat-am.md --doctype pronunciation-feedback
python scripts/validate_copy.py ui-app.md --doctype edtech-microcopy
python scripts/validate_copy.py bang-diem.md --doctype transcript
python scripts/validate_copy.py de-cuong.md --doctype higher-ed --register edu-uni
--register edu-k12|edu-k12-primary|edu-parent|edu-uni启用PRO002。--doctype启用法律和结构检查:primary-report-card、secondary-report-card、teacher-to-student、pronunciation-feedback、edtech-microcopy、transcript、diploma、higher-ed。
步骤 7 — 查看示例和 QA 清单
- references/examples.md — 附有诊断说明的错误 $\rightarrow$ 正确示例。
- references/qa-checklist.md — 用于人工审核教学语气、同理心和法规合规性的清单。