multilingual-readiness

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

multilingual-readiness

A language switcher that leads to half-translated pages, or a privacy policy only in English on a Spanish site, looks careless and can mislead users about what they agreed to.

语言切换器跳转到仅翻译了一半的页面，或西班牙语站点上的隐私政策只有英文版，都会显得不够严谨，并可能误导用户，使其误以为自己也同意了相关内容。

Activate when

启用条件

The site has a language/locale switcher, locale-prefixed routes, translation files (i18n libs), or
```
hreflang
```
.
Markets are being expanded (also update
```
jurisdiction-applicability
```
).
Not for single-language sites (say so).

站点具有 language/locale 切换器、locale 前缀路由、翻译文件（i18n libs）或
```
hreflang
```
。
正在扩展市场（同时更新
```
jurisdiction-applicability
```
）。
不适用于单语言站点（应明确说明这一点）。

Working alone

独立工作

This skill is self-contained. Its companions (declared in its metadata) are skills whose method it may need to do its own promised work. Use of a companion can be conditional: declaring one does not mean running it. When a companion's lane applies, use the skill if it is installed; if not, follow its short entry in references/companion-methods.md and say in your report which lanes ran inline at reduced depth. Never skip an applicable lane silently. Skills mentioned here only for escalation, referral, documentation, or optional deeper follow-up are not dependencies: report the hand-off and finish honestly.

Companions:

design-system-reconnaissance

此 skill 是自包含的。它的 companions（在 metadata 中声明）是一些 skill；当它需要使用这些 skill 的方法来完成自身承诺的工作时，可能会用到它们。companion 的使用可以是条件性的：声明某个 companion 并不意味着一定会运行它。当某个 companion 的职责范围适用时，如果该 skill 已安装，请使用它；如果未安装，则按照 references/companion-methods.md 中的简短条目操作，并在报告中说明哪些环节以内联方式按较低深度运行。绝不能静默跳过任何适用环节。这里提及的 skill 仅用于升级处理、转介、文档记录或可选的深入后续工作，并不属于依赖项：应报告移交情况，并如实完成工作。

Companions：

design-system-reconnaissance

。

Inspect

检查

Locales and routing: list supported locales; URL scheme (
```
/es/
```
, subdomain, ccTLD, query param); default locale and redirect behavior (auto-redirect by
```
Accept-Language
```
can trap crawlers/users; always allow switching); language switcher works and preserves the current page.
<html lang>
matches the page language on every locale;
```
dir
```
set for RTL locales (
```
rtl-readiness
```
).
SEO signals per locale (
```
node scripts/inspect-metadata.mjs --url <site>/<locale> --render
```
; paths relative to this skill's folder): unique titles/descriptions in the page's language; canonical points to the same-language URL (not everything to the default); reciprocal
```
hreflang
```
alternates including self-reference and
```
x-default
```
; sitemap lists locale URLs (optionally with
```
xhtml:link
```
alternates).
Translation completeness: untranslated strings leaking (keys like
```
nav.home
```
, English in the middle of a translated page); fallbacks; pluralization/date/number/currency formatting per locale; text expansion breaking layouts; images with baked-in text.
Trust and legal pages per language: privacy, terms, contact, refund, cookie notice exist in each supported language or the site states clearly which language governs and links to the version available. Do not call the site "multilingual" if the privacy notice or checkout is not translated.
Forms and errors translated, including validation messages, emails, and 404/500 pages.
Legal implication: offering a language may imply a target market: record it (
```
jurisdiction-applicability
```
).

**Locales 与路由：**列出支持的 locales；URL 方案（
```
/es/
```
、子域名、ccTLD、查询参数）；默认 locale 及重定向行为（根据
```
Accept-Language
```
自动重定向可能会将爬虫或用户困在重定向中；始终允许用户切换语言）；语言切换器是否正常工作并保留当前页面。
<html lang>
在每个 locale 中均与页面语言一致；对于 RTL locales，应设置
```
dir
```
（
```
rtl-readiness
```
）。
各 locale 的 SEO 信号（
```
node scripts/inspect-metadata.mjs --url <site>/<locale> --render
```
；路径相对于此 skill 所在目录）：标题和描述应采用页面对应语言且具有唯一性；canonical 指向同语言 URL，而不是全部指向默认语言 URL；
```
hreflang
```
alternate 应相互指向，并包含 self-reference 和
```
x-default
```
；sitemap 应列出各 locale URL（可选包含
```
xhtml:link
```
alternate）。
**翻译完整性：**检查未翻译字符串泄漏的情况（例如
```
nav.home
```
之类的 key，或已翻译页面中间出现英文）；检查 fallback；按 locale 处理复数、日期、数字和货币格式；检查文本扩展是否破坏布局；检查图片中是否内嵌了未经翻译的文字。
**各语言的信任与法律页面：**每种受支持语言中都应存在隐私政策、服务条款、联系我们、退款说明和 Cookie 通知，或者站点明确说明以哪种语言为准，并链接到现有的对应版本。如果隐私声明或结账流程未翻译，不要将站点称为“多语言站点”。
表单与错误页面应完成翻译，包括验证消息、电子邮件以及 404/500 页面。
**法律影响：**提供某种语言可能意味着面向某个目标市场：记录这一点（
```
jurisdiction-applicability
```
）。

Evidence that counts

可计入的证据

Label each claim OBSERVED, SOURCE-INDICATED, DECLARED, INFERRED, UNKNOWN, or REVIEW REQUIRED. UNKNOWN is never a pass and never a failure.

Rendered locale pages: OBSERVED. Translation files: SOURCE-INDICATED (completeness must be checked against rendered pages).
Translation quality needs a fluent speaker: UNKNOWN unless the owner confirms.

将每项结论标记为 OBSERVED、SOURCE-INDICATED、DECLARED、INFERRED、UNKNOWN 或 REVIEW REQUIRED。UNKNOWN 既不表示通过，也不表示失败。

已渲染的 locale 页面：OBSERVED。
翻译文件：SOURCE-INDICATED（必须对照已渲染的页面检查完整性）。
翻译质量需要由流利的母语使用者评估：除非所有者确认，否则为 UNKNOWN。

May change

可以进行的更改

Design first. Before creating or changing anything visible, inspect the project's existing design system (

design-system-reconnaissance

) and build from its tokens and components, by the component ladder: reuse, compose, extend, and only then create a matching component. Never impose a ReadyVibe look on the user's site.

Set

lang

dir

hreflang

, per-locale canonicals and sitemap entries; fix switcher behavior and fallbacks; expose missing-key strings for the owner; link the legal pages that exist per language. Do not machine-translate legal pages or marketing copy into production without the owner's approval; mark drafts clearly if requested.

**设计优先。**在创建或更改任何可见内容之前，先检查项目现有的 design system（

design-system-reconnaissance

），并基于其 design tokens 和 components 进行构建。遵循组件层级：先复用，再组合，然后扩展，最后才创建匹配的组件。绝不能将 ReadyVibe 的视觉风格强加到用户站点上。

设置

lang

dir

、

hreflang

、各 locale 的 canonical 标签和 sitemap 条目；修复切换器行为和 fallback；将缺失 key 对应的字符串提供给所有者；按语言链接现有的法律页面。未经所有者批准，不要将法律页面或营销文案通过机器翻译后直接投入生产环境；如果按要求生成草稿，请清楚标注。

Must not claim

不得声称

"Fully translated", "localized", or "compliant in <language market>". State which pages exist in which locales.

不得声称“已完全翻译”、“已本地化”或“在 <语言市场> 中合规”。应明确说明哪些页面存在于哪些 locales 中。

Verify

验证

Crawl each locale; confirm

lang

, canonicals,

hreflang

reciprocity, and no leaked keys on key pages; confirm legal pages reachable in each locale or clearly explained.

抓取每个 locale；确认

lang

、canonical、

hreflang

的相互引用关系，并确保关键页面中没有泄漏的 key；确认每个 locale 都能访问法律页面，或已清楚说明相关情况。

Escalate

升级处理

New markets implied by added languages; legal text translations (need qualified review); machine-translated commerce/legal content.

新增语言所隐含的新市场。
法律文本翻译（需要具备资质的审阅）。
经机器翻译的商业或法律内容。

No change is valid when

无需更改的情况

The site serves one language and no locale features exist, or all locales are complete and consistent.

站点仅提供一种语言且没有任何 locale 特性，或者所有 locales 均已完整且保持一致时，不需要进行更改。