mcpField
V
vietnamese-business-comms

vietnamese-business-comms

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

vietnamese-business-comms について

B2Bメール、EC、Zaloなどのチャネル向けに、ベトナム語のマーケティング・営業文を作成するスキルです。チャネル別の文体や表現に加え、法令上の確認事項と文章検証スクリプトを扱います。

主な機能

  1. 01チャネルに応じた文体の選択
  2. 02ベトナム市場向け語彙の適用
  3. 03広告・メッセージ規則の確認
  4. 04価格・日付・電話番号の表記
  5. 05コマンドラインスクリプトによる文章検証

活用シーン

  1. 01ベトナム語のB2B営業メール作成
  2. 02Zaloの取引通知テンプレート作成
  3. 03ECタイトルや販促文の確認
  4. 04配信前のキャンペーン文面検証

インストール

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

$npx skills add https://github.com/trussary/vietnamese-language-skill --skill vietnamese-business-comms

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

同梱ファイル

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

assets/
bao-gia.md.template
references/
b2b-xung-ho.md
banned-phrases.md
channel-guide.md
compliance.md
examples.md
glossary.md
locale-formatting.md
promo-law.md
qa-checklist.md
register-matrix.md
unicode-and-tone.md
scripts/
check_font_coverage.py
rules_business.py
validate_copy.py

詳細

ベトナム語のマーケティングおよび営業コピー（vi-VN）

キャンペーンやアウトバウンドのコピーには、同時に2つの問題があります。商業面では、一斉送信のように読めてしまいます。呼びかけの代名詞が不適切だったり、CTAを翻訳してしまったり、市場で外来語が使われるところに堅苦しい語彙を使ったりするためです。また、法的な面でも問題があります。ベトナムの広告法は、根拠のない最上級表現、50％を超える割引、法定時間外に送信されるメッセージ、そして2026年1月1日以降は、インフルエンサーによるコンテンツであることを明示しない投稿も規制しています。

この2つの問題は、流暢さを確認しただけでは見抜けません。以下のルールはそれぞれ、特定の問題を防ぐためにあります。

ステップ1 — 敬語レベルはブランドではなく、チャネルで決める

ベトナム語には中立的な「あなた」がありません。このスキルでは、どの呼びかけを使うかは、ブランドが普段使う口調ではなく、メッセージが届く先によって決まります。

チャネルまたはジャンル敬語レベル呼びかけ
Zalo ZNS/ZBS テンプレートznsQuý khách — ほかの場面では常に bạn を使うブランドでも同様です
B2B の新規営業メール、見積書、提案書、督促状b2b相手には anh/chị、自分には em または tôi
E コマース、ソーシャル、広告、プッシュ通知saasbạn
ミッドマーケット向けサービス、コンサルティングconsultanh/chị
プレスリリースpress組織としての三人称。呼びかける場合は Quý vị
ライブ配信の台本livestreamcả nhà、mọi người — 話し言葉の敬語レベル

**B2B のアウトバウンドで bạn を使うのは、自動送信だと最もはっきり分かるサインです。**ベトナムの営業担当者が、新規営業メールを Chào bạn で始めることはありません。

文中で自分を em と tôi のどちらで表すか、また年齢が役職より優先される理由については、 references/b2b-xung-ho.md を参照してください。共通の代名詞マトリックス： references/register-matrix.md。

ステップ2 — 基本ルール（必須。ファイルを参照する必要はありません）

  1. **B2B のアウトバウンド、見積書、督促状では、bạn や mình を使わないでください。**相手には anh/chị を使います。自分が相手より年下と考えられる場合は em、そうでなければ tôi を使います。
  2. **売り込みではなく、礼儀正しい挨拶から始めてください。**ベトナム語の新規営業では、依頼の前に背景を一文添えます。英語式に価値提案を一行目に置くと、失礼に受け取られます。
  3. **根拠のない主張として nhất、số 1、duy nhất、hàng đầu、bán chạy nhất を書かないでください。**現行の罰則が適用される、広告法 16/2012/QH13 第8条第11項違反です。bán chạy nhất も、ほかの表現と同じくランキングに関する主張です。
  4. **50％を超える割引には、登録済みの chương trình khuyến mại tập trung が必要です。**NĐ 81/2018（NĐ 128/2024 による改正後）。見出しに50を超える数字を載せる場合は、コンプライアンス上の確認が必要です。
  5. **トランザクション用の Zalo テンプレートにマーケティングコンテンツを入れないでください。**テンプレートが却下されます。ZNS/ZBS の本文は、声調記号付きで400文字までです。
  6. 広告メッセージには、事前のオプトイン、機能するオプトアウト手段、法定時間内の送信が必要です — SMS は07:00～22:00、通話は08:00～17:00、24時間あたり1番号につきSMSは3通以下、通話は1回以下です。
  7. 堅苦しい翻訳ではなく、市場で使われている語彙を使ってください。Freeship、Deal、Voucher、Mua ngay。Học thêm は「授業を追加で受ける」という意味で、CTAには使えません。
  8. 比較で競合他社の名前を出さないでください。また、同意なく人物の画像、氏名、発言を使わないでください。

ステップ3 — 慣用的な表現を調べる

定着した自然な表現がある直訳語（trích dẫn → báo giá、theo lên → theo dõi、lời chào tốt nhất → Trân trọng）、市場で実際に使われている E コマース用語、営業関連の成果物の名称、敬語レベル別の CTA：

references/glossary.md — 機械可読形式のため、各行がリンタールールになっています。

一斉送信だと分かるフレーズと、決して許容されない健康・成果に関する主張については、references/banned-phrases.md を参照してください。

Step 4 — チャネルの特性を踏まえる

各チャネルには厳格な制限があり、コピーは後から削るのではなく、最初からその制限に合わせて書く必要があります。 ZNSの400文字上限とトランザクションメッセージ／プロモーションメッセージの使い分け、マーケットプレイスのタイトル規則 （すべて大文字にしない、絵文字を使わない）、発音区別符号によってUCS-2になる場合のSMSの1セグメント70文字、メールの件名の切り捨て、絵文字の密度、ライブ配信での話し言葉の文体です。

references/channel-guide.md

Step 5 — キャンペーンを法令に準拠させる

50％の上限とその `` 免除、スパム対策の時間帯、2026年1月1日から適用されるKOL/KOCの開示義務、比較広告の制限、健康・サプリメントに関する表示に必要な業界別の事前承認：

references/promo-law.md — および、すべてのベトナム語スキルで共通する横断的な引用については references/compliance.md を参照してください。

金融商品の宣伝 — cam kết lợi nhuận、lãi suất 0%、投資商品 — はここでは扱いません。vietnamese-finance-copy に回し、法務レビューも受けてください。

Step 6 — 数字、日付、価格を正しく表記する

VNDはピリオドで桁を区切り、小数点にはコンマを使います：2.500.000 ₫。文章では2,5 tỷや 35 triệuを使い、表では桁区切りした数字を使います。同じ文脈で両者を混在させないでください。日付は dd/MM/yyyyです。電話番号は0xxx xxx xxx、または先頭の0を省いた+84形式です。

references/locale-formatting.md、およびNFCと声調記号の一貫性ルールについては references/unicode-and-tone.md を参照してください。

Step 7 — 検証して修正し、公開する

文章を書いたらすぐにバリデーターを実行してください。エラーが報告された場合は修正して、もう一度実行してください。合格してからコピーを提示してください。

python scripts/validate_copy.py campaign.md --register saas
python scripts/validate_copy.py outreach.md --doctype cold-outreach --register b2b
python scripts/validate_copy.py template.txt --doctype zns-transactional
python scripts/validate_copy.py title.txt --doctype marketplace-title
  • 構造ルールを有効にするのは--doctypeです。指定しないと、これらのルールは適用されません： zns、zns-transactional、marketplace-title、cold-outreach、bao-gia、dunning、 bulk-message、promo。--list-rulesを指定すると、このスキルで適用可能なすべてのルールが表示されます。
  • --register zns|b2b|press|livestream|saas|consult|…を指定すると、PRO002が有効になります。
  • 終了コード0＝問題なし、または警告のみ。終了コード1＝修正が必要なエラーあり。
  • 機械可読な検出結果には--jsonを、警告もエラーとして扱うには--strictを指定します。
  • --fixはNFC違反をその場で修正します。それ以外のルールへの対応は、人による判断が必要です。

書類が実際に存在する場合、2つの注釈を使うことで法務上の警告を抑制できます。どちらも書類そのものを作成するものではありません。

Thương hiệu số 1 Việt Nam 
Giảm đến 90%

Step 8 — 実例で学び、人に確認してもらう

references/examples.md — 長い文章を書く前に、修正前から修正後への事例集を読んでください。

次に、チェックリストを実行します。リンターでは、xưng hôが特定の相手に適しているか、KOLが実際に製品を使用したか、オプトインが本当に存在するか、あるいは``注釈の根拠があるかどうかは判断できません。特に重要なのは、この4つの確認です：references/qa-checklist.md

コメント

Markdown 対応