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. 03审查 CTA 和广告声明是否合规
  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)

越南语对大模型而言是一种低资源语言。若缺少引导,输出往往默认采用受英语影响的翻译腔:读起来流畅,却明显像机器写的。它会选错人称代词,逐字翻译 CTA,写出违法的广告最高级表述,还会按照美式格式书写货币。以下每条规则都是为了避免一种具体且已观察到的缺陷。

步骤 1 — 动笔前先确定语体

越南语没有中性的“你”。人称代词是首要决定,而不是细节。

受众对读者的称呼词汇风格
房地产、金融、奢侈品、航空公司、医疗保健quý khách大量使用汉越词,华丽
机构、政府、广播公告quý vị正式、复数
销售咨询、中端市场服务、本地企业anh/chị亲切、尊重
SaaS、科技、电子商务、面向年轻人的品牌bạn纯越语、简洁
政策、条款、描述性文案(绝不直接称呼读者)khách hàng中性第三人称

如果需求说明中没有提及,就根据产品推断。高端公寓页面使用 quý khách。 开发者工具使用 bạn。一页中绝不能混用两种语体——这是最明显的业余表现。

完整的人称代词对照表(包括其他越南语技能所用的语体): references/register-matrix.md。汉越词与纯越语的声望差异、量词以及章节顺序规范: references/register-guide.md

步骤 2 — 核心规则(不可妥协,无需跳转文件)

  1. 输出 NFC Unicode。 使用预组字符 ế(U+1EBF),绝不要使用基础字符加组合附加符号。NFD 会破坏网页字体渲染和字符串长度。对所有输出进行规范化。
  2. 选定一种声调符号排版风格,并在全文保持一致。 默认采用 kiểu mới (hoà、thuỷ、khoẻ),与 2022 年后 Bộ GD&ĐT 教科书一致。Kiểu cũ(hòa、thủy、 khỏe)同样正确,且在商业用语中仍占主导——如果客户已有网站,就遵循其风格。两种风格都没错;同一页面中不一致才是问题。
  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 写成未经证实的宣传用语。 根据《广告法》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。

步骤 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

步骤 4 — 正确设置数字、日期和区域格式

VND 使用句点分组、小数逗号:2.500.000 ₫。房地产价格使用口语表达:Chỉ từ 2,5 tỷ、35 triệu/m²。日期格式为 dd/MM/yyyy。电话号码格式为 0xxx xxx xxx 或 +84。地址按从小到大的顺序排列。Slug 不带变音符号,使用小写字母,并以连字符分隔。

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 规范的内容;其他所有规则都需要人工判断。

指定了特定网页字体时,请检查字形覆盖范围:

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 运行结果无错误。

评论

支持 Markdown