rondoflow-i18n
Add or change user-facing UI strings in RondoFlow across all three locales (en/sk/es) without breaking the catalog parity test. Use whenever you add, rename, or remove a translation key, create a new i18n namespace, or touch any file under packages/ui/src/lib/i18n/locales/.
rondoflow · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add rondoflow/rondoflow --skill rondoflow-i18n技能说明
name: rondoflow-i18n description: Add or change user-facing UI strings in RondoFlow across all three locales (en/sk/es) without breaking the catalog parity test. Use whenever you add, rename, or remove a translation key, create a new i18n namespace, or touch any file under packages/ui/src/lib/i18n/locales/.
RondoFlow i18n
Every user-facing string in the Next.js UI goes through react-i18next. English (en) is
the default and the typing source of truth; Slovak (sk) and Spanish (es) must stay
in lockstep. A vitest catalog test enforces this — skipping a locale fails CI.
Layout
packages/ui/src/lib/i18n/
├── config.ts # SUPPORTED_LOCALES, DEFAULT_LOCALE, I18N_NAMESPACES (the registry)
├── resources.ts # eager imports of every <locale>/<ns>.json → the `resources` map
├── index.ts # i18next instance
├── locales/{en,sk,es}/<namespace>.json
└── __tests__/locales.test.ts # parity + no-empty + interpolation test
- Locales:
en(default),sk,es— defined inconfig.ts:SUPPORTED_LOCALES. - Namespaces (one JSON file per feature, per locale) are listed in
config.ts:I18N_NAMESPACES:common,shell,canvas,auth,settings,onboarding,notifications,agentDrawer,discussions,analytics,resources,scheduling,git,admin,panelsMisc,app. commonholds shared actions/status plus domain terminology (e.g. Agent→Assistant). Reuse those from other namespaces with thecommon:prefix int().
Rendering strings in components
import { useTranslation } from 'react-i18next'
const { t } = useTranslation('canvas') // pick the namespace
t('toolbar.run') // key within that namespace
t('common:actions.save') // borrow a shared key
t('runs.count', { count: n }) // interpolation / plurals
Adding or changing a key — checklist
- Add the key to ALL THREE files for the namespace:
locales/en/<ns>.json,locales/sk/<ns>.json,locales/es/<ns>.json. Same key path in each; translate the value (do not leave it equal to English unless the term is intentionally identical). - Keep interpolation variables identical across locales.
{{count}},{{name}}etc. must appear in every locale's value — the test compares the set of{{vars}}per key. - No empty values and no
[[TODO]]markers — the test rejects both. - Plurals: English uses
_one/_other; Slovak may add_few. The test is plural-insensitive (it collapses_zero|one|two|few|many|otherto a base key), soskmay legitimately have a_fewvariantenlacks — that does not count as an extra key. - Render it via
useTranslation('<ns>')→t('your.key'). - Run the catalog test (see verify below).
Adding a NEW namespace
Three coordinated edits — the test asserts every locale declares every namespace:
- Create
locales/{en,sk,es}/<newns>.json(all three, even if you only have English ready — but they must not be empty/[[TODO]], so translate up front). - Add
'<newns>'toI18N_NAMESPACESinconfig.ts. - Wire it in
resources.ts: add the threeimportlines and add the key under each locale in theresourcesobject. (config.tseven says: "Keep in sync with resources.ts.")
What NOT to translate
Code identifiers, model IDs (claude-opus-4-8), tool names, URLs, env-var names, and brand
names — RondoFlow, Claude Code, Anthropic, PostgreSQL, Prisma, etc. Locale autonyms in
config.ts:LOCALE_LABELS are also intentionally left in their own language.
Verify (always run before declaring done)
cd packages/ui && npx vitest run src/lib/i18n/__tests__/locales.test.ts
The test (__tests__/locales.test.ts) enforces, per namespace:
- Every namespace exists for every locale.
skandeshave exactly the same (base, plural-insensitive) keys asen— reportsmissingandextrakeys.- No empty /
[[TODO]]values in any locale. - Interpolation
{{variables}}matchenper key.
A failure prints the exact offending keys — fix those and re-run. The slash command
/i18n-check runs this same test.