mcpField
V
vietnamese-landing-copy

vietnamese-landing-copy

github.com/trussaryマーケティング・グロース93174 回インストール8 週間前に更新
リポジトリ

vietnamese-landing-copy について

ベトナム語(vi-VN)のランディングページ文案を作成するスキルです。SaaS、不動産などベトナム向けページを対象に、文体、表現、地域形式、広告規制、検証手順を扱います。

主な機能

  1. 01対象に合う文体の選択と統一
  2. 02慣用的なCTAと地域形式の使用
  3. 03根拠のない広告最上級表現の回避
  4. 04フォームの同意とプライバシー情報の確認
  5. 05文案検証とフォント対応範囲の確認

活用シーン

  1. 01ベトナム向けSaaSページの作成
  2. 02不動産ページの価格と日付のローカライズ
  3. 03CTAや広告表現のコンプライアンス確認
  4. 04公開前の構造化ベトナム語文案の検査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/trussary/vietnamese-language-skill --skill vietnamese-landing-copy

インストール後、Claude Code で/vietnamese-landing-copyを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

assets/
vi.json.template
references/
banned-phrases.md
compliance.md
examples.md
glossary.md
legal-copy.md
locale-formatting.md
qa-checklist.md
register-guide.md
register-matrix.md
unicode-and-tone.md
scripts/
check_font_coverage.py
validate_copy.py

詳細

ベトナム語のランディングページ向けコピー(vi-VN)

ベトナム語は、LLM にとってリソースの少ない言語です。指針がないと、英語をそのままなぞった翻訳調の文章が出力されます。流暢に聞こえても、明らかに機械が書いた文章です。代名詞を間違え、CTA を逐語訳し、広告として違法な最上級表現を書き、通貨をアメリカ式に表記します。以下のルールはすべて、実際に確認された特定の不具合を防ぐためのものです。

Step 1 — ひとことも書く前に文体を選ぶ

ベトナム語には中立的な「あなた」に当たる語がありません。 代名詞は細部ではなく、最初に決めるべきことです。

対象読者読者への呼びかけ語彙
不動産、金融、高級品、航空会社、医療quý khách漢越語が多く、華やか
公的機関、政府、放送の告知quý vị改まった複数形
営業相談、中堅市場向けサービス、地域の事業者anh/chị親しみやすく、敬意がある
SaaS、テック、EC、若者向けブランドbạn純ベトナム語、簡潔
ポリシー、利用規約、説明文(直接呼びかけない場合)khách hàng中立的な三人称

ブリーフに指定がなければ、プロダクトから判断してください。高級マンションのページなら quý khách、開発者向けツールなら bạn です。1ページ内で異なる文体を混在させないでください — これは、最も目立つ素人っぽさの表れです。

他のベトナム語スキルが使う文体も含む、代名詞の全マトリックス: references/register-matrix.md。漢越語と純ベトナム語の格式の軸、類別詞、セクション順序のハウススタイル: references/register-guide.md

Step 2 — 基本ルール(必須。ファイルを開く必要はありません)

  1. NFC Unicode で出力してください。 合成済みの ế(U+1EBF)を使い、基底文字と結合文字の組み合わせは使わないでください。NFD はウェブフォントの表示や文字列の長さに問題を引き起こします。出力するものはすべて正規化してください。
  2. 声調記号の表記スタイルを1つ選び、文書全体で統一してください。 デフォルトでは、2022年以降の Bộ GD&ĐT 教科書に沿った kiểu mới(hoà、thuỷ、khoẻ)を使います。Kiểu cũ(hòa、thủy、khỏe)も同様に正しく、商業用途では今も広く使われています。既存のサイトがある場合は、その表記に合わせてください。どちらも誤りではありません。1ページ内で統一されていないことが問題です。
  3. 修飾語は名詞の後に置きます。 căn hộ cao cấp とし、cao cấp căn hộ とはしません。
  4. 英語の受動態は言い換えてください。 được thiết kế bởi X は do X thiết kế にするか、能動態の X kiến tạo にしてください。
  5. 根拠のない主張として、số 1、tốt nhất、duy nhất、hàng đầu は決して使わないでください。 単に品がないだけでなく、Luật Quảng cáo 16/2012/QH13 第8条第11項に違反します。実際に罰金が科されており、現在も執行されています。references/banned-phrases.md を参照してください。
  6. ベトナム語に文法上の複数形はありません。 ICU メッセージで使うのは other のみです。vi.json に one {} 分岐があれば、必ず不具合です。
  7. CTA は英語から訳すのではなく、定訳一覧に沿って作成してください。 Learn more は Tìm hiểu thêm であり、Học thêm ではありません。

Step 3 — 定訳を確認する

すでに定訳がある UI 文字列について、ベトナム語を独自に考えないでください。EN→VI 表には、CTA、ナビゲーションラベル、フォーム項目、不動産分野で標準化されたセクション名(Tổng quan dự án、Vị trí、Tiện ích、Mặt bằng、Tiến độ、Chính sách bán hàng、Chủ đầu tư、Pháp lý)が記載されています。

references/glossary.md

Step 4 — 数値、日付、ロケールデータを正しく表記する

VND はピリオドで桁を区切り、小数点にはコンマを使います:2.500.000 ₫。不動産価格は口語的な表現にします:Chỉ từ 2,5 tỷ、35 triệu/m²。日付は dd/MM/yyyy です。電話番号は 0xxx xxx xxx または +84 です。住所は小さい単位から大きい単位の順に並べます。スラッグはアクセント記号なし、小文字、ハイフン区切りにします。

references/locale-formatting.md — Intl.NumberFormat('vi-VN')、BCP-47 タグ、フォントサブセット、重ね書きのダイアクリティカルマークのタイポグラフィ、アクセント記号あり/なしの両方を使う SEO キーワードのルールも説明しています。上記のルール1と2に関わる NFC と声調記号のルールは、references/unicode-and-tone.md に記載されています。

ステップ 5 — 法的文言を適切に整える

リード獲得フォームは規制の対象です。Nghị định 13/2023/NĐ-CP では、明示的で十分な説明に基づく、撤回可能な同意を、利用目的を明記したうえで取得し、リンク先として Chính sách bảo mật を掲載することが求められています。広告で最上級表現を使うには、証明書類が必要です。

ランディングページ固有の内容については references/legal-copy.md と references/banned-phrases.md を、ベトナム語のすべてのスキルに共通する広告、同意、プロモーション、スパム対策のルールについては references/compliance.md を参照してください。

ステップ 6 — 検証して修正し、公開する

文章を書いたら、すぐにバリデーターを実行してください。エラーが報告された場合は修正して、再度実行してください。合格してからのみ、コピーを提示してください。 出力が「問題なさそうに見える」からといって省略しないでください。NFC 違反やカンマ区切りの数値は、読んだだけでは気づけません。

python scripts/validate_copy.py path/to/copy.md --register re
  • --register re|saas|formal|consult を指定すると、文体の一貫性チェックが有効になります。
  • 終了コード 0 = 問題なし、または警告のみです。終了コード 1 = 修正が必要なエラーがあります。
  • 機械可読な検出結果を出力するには --json を、警告も失敗として扱うには --strict を指定します。
  • --fix は NFC 違反をその場で修正します。それ以外のルールは、人が判断する必要があります。

特定の Web フォントが指定されている場合は、グリフのカバレッジを確認してください。

python scripts/check_font_coverage.py path/to/copy.md

指摘された最上級表現が、ライセンスを取得した市場調査や受賞証明書によって裏付けられている場合は、削除せず、そのまま残して出典を注記してください。

Thương hiệu số 1 Việt Nam 

ステップ 7 — 対訳例から学ぶ

長い文章を書く前に、問題のある例から適切な例へのコーパスを読んでください。各対訳には、修正する失敗パターンが記されており、その診断は該当する文字列以外にも応用できます。

references/examples.md

構造化ローカライズファイルには、assets/vi.json.template を使用してください。next-intl 形式で、両方の文体に対応し、複数形は other のみです。

公開前の人によるレビューについては、references/qa-checklist.md を参照してください。

簡易セルフチェック

ベトナム語のコピーを返す前に、次の点を確認してください。

  • 全体を通して文体が統一され、代名詞が対象読者に合っている。
  • すべての CTA が、独自に翻訳したものではなく、用語集に記載されている。
  • ページ内の最上級表現に、裏付けのないものがない。
  • 価格の桁区切りに ., 小数点に , を使い、₫ または口語表現の tỷ/triệu を使っている。
  • 日付は dd/MM/yyyy、電話番号は 0xxx/+84、住所は小さい区分から大きい区分の順になっている。
  • 声調記号のスタイルが統一されている。
  • リード獲得フォームに、同意チェックボックス、利用目的の説明、プライバシーポリシーへのリンクがある。
  • validate_copy.py の終了結果に問題がない。

コメント