vietnamese-education-copy について
ベトナム語の教育・学術・EdTechコンテンツ向けライティングスキルです。対象に応じた文体、法定用語、教育的フィードバック、児童データ保護、文章検証を扱います。
主な機能
- 01対象に応じたベトナム語文体の選択
- 02法定の成績・資格用語の確認
- 03教育的フィードバックと段階的ヒントの設計
- 04児童データ保護指針への準拠
- 05付属スクリプトによる文章検証
活用シーン
- 01教師から生徒への評価文の作成
- 02EdTechの発音フィードバックやUI文言の作成
- 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 に分類されます。
Step 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。
Step 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 — 学習科学と EdTech の教育的インテリジェンスを適用する
インタラクティブな学習用コピーや 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 — EdTech 用語集を確認し、翻訳調を避ける
よくある翻訳調の表現 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): 7 歳以上($\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 — 教育的なトーン、共感、規制遵守についての人によるレビュー用チェックリスト。