vkc-i18n-ko-vi-safety

防止 ko/en/vi 的国际回归(缺少键、长越南文本 UI 中断)。在更改 messages/*.json 或添加面向用户的字符串时使用。

📖 中文导读:防止 ko/en/vi 的国际回归(缺少键、长越南文本 UI 中断)。在更改 messages/*.json 或添加面向用户的字符串时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: vkc-i18n-ko-vi-safety description: Prevent i18n regressions for ko/en/vi (missing keys, long Vietnamese text UI breakage). Use when changing messages/*.json or adding user-facing strings. metadata: short-description: i18n key safety + UI rules

VKC i18n (ko/en/vi) Safety

When to use

  • You add/edit user-facing strings
  • You touch messages/*.json
  • A UI breaks only in Vietnamese

Rules

  • Never ship a key in only one of ko/vi.
  • Keep nested key structure consistent across ko.json, en.json, vi.json.
  • Avoid hardcoded literal strings in components; prefer message keys.

Checks

  • Run: bash .codex/skills/vkc-repo-guardrails/scripts/lint-i18n-keys.sh

UI safety for long Vietnamese strings

  • Apply “layout-safe” patterns by default:
    • min-w-0 on flex children that contain text
    • break-words or whitespace-pre-line where wrapping is required
    • line-clamp-* where space must be capped
    • avoid fixed widths for text containers unless truncation is intentional

Reference

  • .codex/skills/vkc-i18n-ko-vi-safety/references/i18n-ui-safety.md